CommuniGate Pro HTTP Module |
||||||||||||||||||||||||||||||||||||||||||||||||
|
The authentication schemes supported with the HTTP protocol protect the WebAdmin pages from an unauthorized access. In order to access the WebAdmin pages, the user should provide the name and the password of a CommuniGatePro account with required Server Access Rights.
By default, the HTTP module accepts clear text TCP/IP WebAdmin connections on
the port 8010 and secure (SSL/TLS) connections on the TCP port 9010.
To access the WebAdmin pages, the Server administrator should use the
following URLs:
http://domain.com:8010
https://domain.com:9010
where domain.com is the name of the main server domain or its alias,
or the IP address of the CommuniGate Pro Server.
A domain administrator should access the server using the following URL:
The server will ask for the user name and a password, and if the specified account has the Domain Administrator access right, the list of the domain accounts is displayed.
Sometimes this URL cannot be used. For example, a secondary domain may have no DNS A-records (only MX records). Please note that in this case all domain users should use the full account names even if the connect via the WebUser Interface). To access such a domain, its domain administrator should use the following URL:
Registered users and guests can also use this component to browse mailing list archives.
By default, the HTTP module accepts clear text WebUser TCP/IP connections on the TCP port 8100, and the secure connections - on the TCP port 9100. If your Server does not have to coexist with some other Web Server on the same computer, it's recommended to change these port numbers to 80 and 443 - the standard HTTP and HTTPS port numbers. In this case your users will not have to specify the port number in their browsers.
The URL for the account@domain personal Web site is:
http://domain:port/~account
where port is the WebUser port (8100 by default).
The list of files on that personal Web Site can be seen at:
http://domain:port/~account/index.html
The home (default) page of a personal Web Site should have the default.html name.
The Personal Web Site prefix (~) can be changed using the WebUser settings.
Use any Web Browser to connect to the Administration Port on your Server, and open the Access page in the Settings section.
If the CommuniGate Server computer runs some other Web Server application, you should specify a port number in the "secondary range" to avoid conflicts with that other Web Server application. Usually the "secondary" Web Servers use ports numbers in the 8000-8100 range. If you set the port number to 8010, you will be able to connect to your server by entering http://xxx.yyy.zzz:8010 in your Web browser, where xxx.yyy.zzz is the exact domain name (A-record) or the IP address of your server.
When a request is received on the WebAdmin port, the HTTP module should use the domain name or the IP address specified in the URL to decide which Domain Administration pages to display.
When a request is received on the WebUser port, the HTTP module should use the name specified in the URL to decide which Domain (its login page, mailing lists, personal Web Sites, etc.) to access.
In order to support all types of CommuniGate Pro Routing features (Router Table, Domain Aliases, IP Address to Domain Mapping, etc.), the HTTP module composes a complete E-mail address LoginPage@domainname (where domainname is the domain name specified in the request URL), and processes this address with the Router. If the addresses is routed to the LOCAL module, and the routed username is still LoginPage, then the domain part of the resulting address is used to open the proper CommuniGate Pro domain (the main domain or a secondary one).
If the address is routed to the LOCAL module, but the resulting username is not LoginPage, the Personal Web Site of that account is opened.