SSL-Enabled (https) Web Server at a2i Communications

An SSL-enabled web server is available at a2i. This means that URLs beginning with `https:' may be handled. All web sites hosted at a2i may use our SSL-enabled web server at no additional charge. However, when calculating your hits, each SSL hit will count as 20 scaled hits. To avoid going over your hit allocation you should use SSL selectively, such as for forms that are used to accept confidential information such as passwords. (NOTE: At this time we observe that SSL traffic is quite low, and we are not applying SSL hits against your total hits. We will begin doing at some time in the future, if/when we observe a significant increase in SSL hits.)

The term SSL stands for secure sockets layer, which describes a mechanism for encrypting data transfers on the Internet. In the rest of this document we will use SSL and https essentially as synonymous. Strictly speaking it's possible to use SSL for purposes other than accessing https URLs, but this is relatively uncommon on the Internet today.

Making Documents Available Via SSL

To serve web pages via SSL protocol, i.e., using `https:' URLs, follow these two simple steps:

  1. Put files in a subdirectory called `secure'.
  2. In the URL for accessing such files, replace `' with `' .

To make cgi-bin programs work via SSL, you may create a subdirectory called `secure' within your cgi-bin directory, and put your scripts there.

For example, if a user `joeuser' has a web file called `myfile.html', its normal URL is `' . To make this file available to web clients via SSL protocol, the user will move the file into a subdirectory called `secure' and access it with the URL `' .

If the same user wishes to allow access to a cgi-bin program via SSL protocol, he would put the program in a directory called `secure' in his normal cgi-bin directory. Suppose the original cgi-bin program was accessed as `' . Then the URL for accessing the program via SSL protocol, in its new location in the subdirectory called `secure', would be `' .

Accessing the Same Document With and Without SSL

If you wish to allow both `http' and `https' for the same document it's quite easy to do so. The obvious and simple approach is to make two copies of the document. However, this may lead to headaches later, because any revisions will need to be made in both places.

A slightly more convenient approach, suitable for those who don't mind logging into the UNIX shell, is to make a symbolic link so the same document appears in two locations. For example, if user `joeuser' has a document called `takeorder.html' in his main web directory, he can make the same document available via https by following these steps from the UNIX shell.

     % mkdir secure                     (create the 'secure' directory)
     % cd secure                        (go into that directory)
     % ln -s ../takeorder.html .        (make a symlink pointing to the file)

Once he has done the above, the file `takeorder.html' resides in his normal web directory, and it is also accessible by the same name from the `secure' subdirectory. So the same file can be accessed as `' and also as `'.

You can also make all files in a certain directory available via SSL, by representing the entire `secure' directory by a symlink. Don't create a subdirectory called `secure'. Instead, simply do this from the UNIX shell:

     % ln -s . secure

The above UNIX command creates a pointer back to the current directory, in the form of a symlink called `secure'. Now every file in the directory is accessible both ways. Given any file `xxx.html', we may access it as `' and also as `' .

We don't necessarily advise you to make all files available via SSL. Since you are allocated a much smaller number of SSL-enabled web hits, you may easily overrun your allocation if you indiscriminately make files available via SSL.

SSL-Enabled Server Restrictions

The SSL-enabled web server implements functionality similar to our normal web server, with some restrictions. The SSL-enabled web server will not process any server-side includes. We assume you will use SSL only for a few selected documents that accept secret data, such as a password, from the remote user.

SSL-Enabled Server Logs

Web log entries for connections to the SSL-enabled web server will not be found in the normal web server logs. They will instead be found in the log generated by the SSL-enabled web server. To see these logs, please log into the UNIX shell on the machine and then cd into the directory /etc/LOCAL/https.211/logs/ssl . Then look in the file access_log . Also, older log entries will be found in the files access_log.0 , access_log.1 , and so on.

To top howto page
To a2i communications home page

$Id: ssl.html,v 1.34 2003/01/27 10:57:45 lrdroot Exp $
$Source: /mi/home/guest/www/howto/RCS/ssl.html,v $