The files in this directory are just examples of little scripts
to make your life with absent easier.

CLEANUP_USERS.PL
----------------
This script is intended to run from cron, as the pushweb user.
It simply goes through the "cookies" and "user" directories
looking for stale files and erasing them. Pushweb has an
unpleasant habit of leaving cruft around in the user and cookies
directories. To use the script, edit the values of PUSHWEBDIR,
USERDIR, and COOKIEDIR to reflect your installation, then run the
script from cron. We run it every 15 minutes, but you can vary
this to taste.


ABSENT_INIT.PL, REGISTER.HTML
-----------------------------
absent_init.pl is a very simple CGI script which demonstrates how
to register folks with absent. You shouldn't really take this as
an indication of the best way to do this job, as it makes no
particular effort to be secure, flexible, or robust, but it shows
you what you'll need to think about doing to get your users into
absent.

Absent uses OPIE for authentication. OPIE maintains a password
file in opiekeys which contains successively-hashed passphrases
for users with their next challenge, much as the unix password
file contains encrypted passwords. absent-init.pl simply crypt()s
the password supplied on the query string and compares it against
the passwd file, then adds the user if the password matches via a
call to the Otp register_user method. The script also updates the
"personal pages" file, which allows users to specify a home page
to be used by absent. This entire script is essentially a wrapper
around the Otp register_user method.

See the file 'register.html' for a web page which calls this
script. To use the script directly, edit the values of the
$PERSONALPAGEFILE $OTP_INIT and $REGTEMP variables, and the HTML
file, then put them on some convenient web server.

Remember, this script's just an example. How you actually
register users will depend on your site's policies and
procedures. The best solution is to have someone available to
register users by hand and lecture them on proper use of the
system, but obviously, that won't work most places.

IMPORTANT: DO _NOT_ UNDER ANY CIRCUMSTANCES MAKE THIS SCRIPT
AVAILABLE AS A CGI VIA ABSENT, NO MATTER HOW GOOD AN IDEA THAT
SEEMS. IF NECESSARY, USE APACHE'S ACCESS CONTROL FEATURES TO
PREVENT ACCESS TO ITS URL. IF YOU CAN'T DO THAT, DON'T USE THIS
SCRIPT.

ABSENT_PERSONAL_PAGE.PL, PERSONAL_PAGE.HTML
-------------------------------------------
absent_personal_page.pl allows registered users to alter their
personal home page settings. See the file 'personal_page.html'
for a web page which calls this script.

Remember, this script's just an example. How you actually
register users will depend on your site's policies and
procedures. The best solution is to have someone available to
register users by hand and lecture them on proper use of the
system, but obviously, that won't work most places.

IMPORTANT: DO _NOT_ UNDER ANY CIRCUMSTANCES MAKE THIS SCRIPT
AVAILABLE AS A CGI VIA ABSENT, NO MATTER HOW GOOD AN IDEA THAT
SEEMS. IF NECESSARY, USE APACHE'S ACCESS CONTROL FEATURES TO
PREVENT ACCESS TO ITS URL. IF YOU CAN'T DO THAT, DON'T USE THIS
SCRIPT.

CALCULATORS.HTML
----------------
A list of OPIE calculators, in HTML form.


# $Id: README,v 1.1 1999/12/17 00:06:55 cgilmore Exp $

# $Log: README,v $
# Revision 1.1  1999/12/17 00:06:55  cgilmore
# Initial revision
#