What is it ?
WAccess is a is a very simple system Access manager.
You can define Guest account or Administrator account. For each, you define
login and password, users can change password, and administrator can add /
remove users.
You can define for each type, what's pages can be visits by users...
System Requirements:
- Perl 4.0 or newer; you can get it at http://www.perl.com/
- A web server, you must have access to add / execute CGI scripts.
Download current version
Current version is v1.1, created 05/30/98, last modified 12/24/99.
Download source code / scripts and documentations :
Tar/Gzip archive : WAccess.tar.gz (0 Ko)
DOS Zip format : WAccess.zip (0 Ko)
What this archive contains ?
This archive comes with 11 differents files:
1) COPYING: Copyright informations (GPL).
2) README: This file.
3) LISEZMOI: French doc...
4) WAccessLib.pl: Lib for use WWWAdverts.
5) member.cgi: Display member page if good password.
6) admin.cgi: Display Administrative page if good password.
7) cgi-lib.pl: CGI-Lib of Steven E. Brenner used here..
8) password.txt: Password file.
9) Admin.html: Administrative HTML page (Displayed by Admin.cgi)
10) Member.html: Member HTML page (Displayed by Member.cgi)
11) other.html: An other HTML page for example.
Installation and Configuration:
It's a Perl script, so installation is pretty easy. You don't need to
compile anything.
Copy *.cgi and *.pl in your /cgi-bin/ directory.
Copy password.txt, *.html in your data directory
Make it executable, unix only (chmod a+rx *.cgi)
Make writable data file, unix only (chmod a+rw *.txt)
You will have to do some configuration:
Edit All CGI Scripts (*.cgi) and change #/usr/bin/perl, if it's
necessary...
Edit WAccessLib.pl and change "Necessary Variables Section"
$DATA_DIR = '/Absolute/path/to/datadir/'; # Path of data directory
$PASSWORD_FILE = $DATA_DIR.'password.txt'; # Name of Password file
$UNIV_LOGIN = 'FTLS'; # if you have lost your login/password, Change it...
$UNIV_PASSWORD = 'www.ftls.org'; # Change it...
$ADMIN_FILE = $DATA_DIR.'Admin.html';
$COMMON_ADMIN_TITLE = 'WAccess v1.1, Administrative Display of www.ftls.org';
$MEMBER_FILE = $DATA_DIR.'Member.html';
$COMMON_MEMBER_TITLE = 'Member of www.ftls.org';
$WEBMASTER_EMAIL = 'you@yourdomain.com';
$DISPLAY_LANG = 'En';
Edit Admin.html and Member.html to change look.
if you want send login and password to another page, add
<A HREF="/cgi-bin/script.cgi?login=Value_Login&pass=Value_Password">???</A>
How to run it ?
In the password file there're 2 passwords :
Login: Member Password: member Permissions: Administrator
Login: Admin Password: admin Permissions: Member
Use member.cgi:
There're several methods to use it :
Goto '/cgi-bin/member.cgi'
-> Query login and password page, if correct, display member page.
for each other action, it's if login and password are correct.
'/cgi-bin/member.cgi?login=YourLogin&pass=YourPassword'
-> display member page.
'/cgi-bin/member.cgi?login=YourLogin&pass=YourPassword&page=PageName'
-> display PageName.html (name of a page in datadir without .html).
'/cgi-bin/member.cgi?login=YourLogin&pass=YourPassword&page=user'
-> display user page (defined for user)
'/cgi-bin/member.cgi?login=VotreLogin&pass=VotrePassword&ac=chpass'
-> Change member password.
Use admin.cgi:
There're several methods to use it to :
Goto '/cgi-bin/member.cgi'
-> Query login and password page, if correct, display admin page.
for each other action, it's if login and password are correct.
'/cgi-bin/admin?login=YourLogin&pass=YourPassword'
-> display administrative display.
'/cgi-bin/admin.cgi?login=YourLogin&pass=YourPassword&ac=admin'
-> Administrative display to add or suppress users.
'/cgi-bin/admin.cgi?login=YourLogin&passYourPassword&ac=chpass'
-> Change administrator password.
Use member.cgi and admin.cgi from member.cgi or admin.cgi.
When you change Member.html or Admin.html, you can add, links to this
function by URL links or post methods.
To query this with logged member informations, use :
Value_Login -> replaced by current login
Value_Password -> replaced by current password
Value_Webmaster_EMail -> replaced by webmaster E-Mail.
Example URL query :
<A HREF="/cgi-bin/admin.cgi?login=Value_Login&pass=Value_VotrePassword&ac=admin">click</A>
Example POST query :
<FORM METHOD=post ACTION="/cgi/member.cgi">
<INPUT TYPE=HIDDEN NAME="login" VALUE="Value_Login">
<INPUT TYPE=HIDDEN NAME="pass" VALUE="Value_Password">
<INPUT TYPE=HIDDEN NAME="page" VALUE="user">
<INPUT TYPE="Submit" VALUE=">>">
</FORM>
Other examples :
See Admin.html and Member.html
Protect other CGI scripts :
If you want protect with this system other CGI scripts, you should only
add these lines at the top of your script :
require "WAccessLib.pl"; # load WAccess lib.
&ReadParse(*input); # Read query input.
&CGIProtect($mode, $input{'login'}, $input{'pass'}, $title);
# Test login and password, exit with bad password message if not correct
# else continue.
Variables :
$mode = "root" if only administrator can use it, "guest" for member.
$title : title of "Invalid password page".
To use it:
'/cgi-bin/votrescript.cgi?login=YourLogin&pass=YourPassword'
or: <FORM METHOD=post ACTION="/cgi/votrescript.cgi">
<INPUT TYPE=HIDDEN NAME="login" VALUE="YourLogin">
<INPUT TYPE=HIDDEN NAME="pass" VALUE="YourPassword">
<INPUT TYPE="Submit" VALUE=">>">
</FORM>
Version history:
Version 1.1 12/24/99 - Update
- Add POST method query.
- Add named access users page.
- Groups scripts.
Version 1.0 05/30/99 - Archive Created.
Copyright:
This software is copyright (C) 1999 Frederic TYNDIUK. It is distributed
under the terms of the GNU General Public License (GPL). Because it is licensed
free of charge, there is NO WARRANTY, it is provided AS IS. The author can not
be held liable for any damage that might arise from the use of this software.
Use it at your own risk.
See the file COPYING for more details (or http://www.gnu.org/).
Updates ?
Latest version and New Scripts can be found at:
http://www.ftls.org/en/
Contact:
Please feel free to contact me with any comments, suggestions, bug fixes
criticism, or just a happiness messages.
If you run into any problems while trying to configure these scripts
first read this file carefully, if you don't find any solution, send me a Mail.
E-Mail: tyndiuk@ftls.org
Web: http://www.ftls.org/
Frederic TYNDIUK
