Authentication System 1.4 - Install Guide - Automatic install

1. Install the image files

Using your favorite ftp client install the button images into a suitable directory on your website. I suggest /images/ as a good place.
At the time of writing there are english and french buttons available. simply upload the buttons of your choice.

It is recomended that you use the auto install version unless you have difficulties. The autoinstall version includes two files auth_setup.pl and script.data. These two files should be uploaded into either your cgi-bin directory or a subdirectory off the cgi-bin. I prefer to use a directory called auth or auth 1.4.
Once uploaded the auth_setup.pl should be chmodded to 755 for read / execute to the server.

If you don't know where the cgi-bin directory is for your site you should contact your system administrator. Be sure to use text mode to transfer the files. This ensures that the script is in the correct format for the host system.

3. Run auth_setup.pl

Running auth_setup.pl unpacks the script files into the auth directory and sets the correct permissions. After unpacking the files it presents a configuration screen that is used to configure the authentication package to your system.

The settings that are generated are normally correct only requiring you to change the location of the images if you didnt use /images/

Pressing the send button at the bottom of the page will create a config file using the details generated. It will also create a logfile and a password database.

4. Test the script

Test the script by clicking on the register link on the confirmation screen.

5. Get Administrator Access

Recall the default administrator cookie by recalling the user admin with password jrbauth this allows you to use the auth_edit.pl or auth_useredit.pl script to change the password of the admin account.

Auth_setup.pl can be used at any time to re-configure your system. it will not overwrite password or logfiles if they exist. Configuration files that exist are renamed to have a time and data suffix and a new config file is created.

Copyright (C)2001 - 2005 John R. Bayley.