Web Files

HTTP Access to Personal Web Sites Private Folder HTML-based Management HTTP-based Management FTP-based Management Special Files Virtual Files CommuniGate Pro Accounts can contain WebFiles - a set of HTML, JPEG, and other files. This file set is used as the Personal Web Site for the Account user and the CommuniGate Pro HTTP module can be used to retrieve files from those Sites. The Account owner or an administrator can add files to the Personal Web Site, rename them and remove them. If the Account and its Domain have the WebSite Service enabled, anybody can retrieve Personal Web Site files using any HTTP browser. If a file is located inside a "private" Folder, the browser user needs to supply the account password to access the file. A Personal Web Site can contain nested folders (file directories). The total number of files and folders and the total size of all Personal Web Site files is limited by the special Account Limits settings. The WebUser Interface can be used to store message attachments in the Personal Web Site folders.

HTTP Access to Personal Web Sites

CommuniGate Pro allows each user to be presented on the World Wide Web with a personal Web Site. The URL for the accountname@domainname Account Web Site is:
<http://domainname:port/~accountname>   where the port is the WebUser port.
For example, the jsmith@client1.com account has the Personal Web Site at:
<http://client1.com:8100/~jsmith>

Personal Web Sites use the same HTTP port as the WebUser Interface (the port 8100 by default).

The ~ is the default prefix for the Personal Web Sites. It can be changed to a different string, and it can be changed to an empty string.

To modify the HTTP Access options, use the WebAdmin Interface and open the WebUser page in the Settings realm:

Personal Web Sites

Site Prefix:

All Routing Rules discussed in the Access section apply to the Personal Web Site URLs, so account and domain aliases can be used in the Personal Web Site URL.

Personal Web site can be accessed without a prefix, using just the server part of the URL string. When the CommuniGate Pro server receives an HTTP connection on the its WebUser port, it uses the special Domain Routing procedure.

If the domain name user.domain.com has a DNS A-record pointing to the IP address of the CommuniGate Pro server, and the CommuniGate Pro Router has the following record:
<LoginPage@user.domain.com> = userA@domainB.com
and the Account userA exists in the CommuniGate Pro Domain domainB, then the URL http://user.domain.com/ can be used to access the Personal Web Site of the userA@domainB.com Account.

Personal Web Sites must not contain any index.wssp file. This name is reserved for the Personal WebSite Management forms.

The home (default) page of a Personal Web Site should have the default.html name. This means that when the file name is not specified explicitly, the default.html name is assumed. If a Web Site has folders (subdirectories), then the request with the http://server:port/prefix user/folder/ URL retrieves the default.html file from that subdirectory.

Private Folder

If the Personal Web Site contains the folder with the name private, then files in that folder are available only to the Account owner and Administrators with the CanAccessWebSites Domain Access right.

The private folder can be used as a repository for any type of documents - the user can access them from anywhere, using any browser.

HTML-based Management

Users can manage their Personal Web Sites using any browser. There are two methods to access the Personal WebSite adminstration pages:

• By opening a WebUser Session, and using the WebSite link in the WebUser Interface navigation panel.
• By opening the Index.wssp file in their own Personal WebSite:
  http://domain.dom:8100/~username/Index.wssp
  The browser will present a Login dialog box, and the user should enter her account name and password in order to open the WebSite administration page.

Server administrators with the All Domains and Accounts Access Right and Domain administrators with the CanAccessWebSites access right can access WebSite belonging to other users. They can use the same URL, opening the Index.wssp file, but they should provide their own account names and passowords.

Server and Domain administrators can access other users Personal WebSites using the WebAdmin Interface: the Account management pages have the WebSite link in their navigation panels.

All management methods use similar HTML pages for WebSite administration:

Subdirectory documents UP

Marker  File Name Size Modified report.txt 488 20:52:49 myDocs --> This Folder: 2 488   Totals: 5 976   Limits: Unlimited 30720

Click the Browse button and select a file you want to upload to the WebSite. Click the Upload File button to upload the file. Its name should appear in the list.

Select the checkboxes to mark the files you want to remove from the Personal WebSite and click the Delete Marked button. The selected files will be removed.

Type in a name and click the Create Folder button to create a folder (sub-directory) in the Personal Web Site.

Click the file name link to open the file. Click the folder name link to open the subdirectory. When a subdirectory is opened, its name is displayed on the top of the file list. Click the UP link to open the parent subdirectory.

The This Folder line displays the total number of files and folders, and the total size of all files in the opened folder. The Totals line displays the total number of files and folders, and the total size of all files in the Personal Web Site. The limits line displays the specified maxmimum number of files and folders and the specified maxmimum total file size for this Personal Web Site.

HTTP-based Management

Personal Web Sites can be modified using the HTTP 1.1 PUT, DELETE, and MOVE methods. Some HTML design tools (such as Netscape Composer) can use these methods to upload files to the server. These HTTP requests should contain the Authentication information: the Account name of the Personal Web Site owner or the Account name of a Server/Domain Administrator, and the password for that Account.

FTP-based Management

Personal Web Sites can be modified using the CommuniGate FTP module. When an Account user connects to the FTP module, the FTP "root directory" as well as the "current directory" are set to the topmost directory of the Account Personal Web Site.

Special files

Certain Personal Web Site files have special meanings.

default.html

This file is retrieved via HTTP when no file name is specified in the URL: http://server:port/~username/ or http://server:port/~username is equivalent to http://server:port/~username/default.html.

The same is true for all Personal Web Site subfolders: http://server:port/~username/subfolder/ is the same as http://server:port/~username/subfolder/default.html

freebusy.vfb

This text file contains the user Free/Busy information. The file is updated automatically by the CommuniGate Pro MAPI module, as well as by the Web User Interface module, when the user Calendar data is modified.

If a client tries to retrieve the freebusy.vfb from some Personal Web Site, and the freebusy.vfb does not exist, the HTTP module generates a dummy free-busy dataset and sends it to the client.

Virtual Files

Virtual files are the names that can be used in the Personal Web Site URLs. They do not specify actual files in the Personal Web Sites, but they can be used to retrieve certain information.

index.wssp

This name is used for HTML-based Personal Web Site management. Access to this resource requires authentication.

freebusy.wssp

This name is used to retrieve formated Free/Busy information. The actual data is retrieved from the freebusy.vfb file stored in the Personal Web Site.