pam_authsrv - PAM module for TIS authsrv authentication
===========

pam_authsrv is a PAM module for authsrv authentication.


Installation
------------

To build pam_authsrv, you should be able to simply run these commands:

   ./configure
   make
   make install


Encap Package Support
---------------------

To build this software as an Encap package, you can pass the
--enable-encap option to configure.  This will be automatically
enabled if the epkg or mkencap programs are detected on the system,
but can be overridden by the --disable-encap option.

When building an Encap package, the configure script will automatically
adjust the installation prefix to use an appropriate Encap package
directory.  It does this using a heuristic algorithm which examines the
values of the ${ENCAP_SOURCE} and ${ENCAP_TARGET} environment variables
and the argument to configure's --prefix option.

If mkencap was detected on the system, it will be automatically run during
"make install".  By default, epkg will also be run, but this can be
inhibited with the --disable-epkg-install configure option.

For information on the Encap package management system, see the WSG
Encap Archive:

   http://www.encap.org/


Testing
-------

To test the module, add the following line to /etc/pam.conf:

   authtest auth required /usr/local/lib/security/pam_authsrv.so.1

Then run the "authtest" program as root.  It will prompt you for a user
name and attempt to authenticate you to the authsrv.  If it doesn't
successfully authenticate you, something's wrong, so check your syslog
for details.  Otherwise, you're all set to start using it for system
services like "su" or "login".


More Information
----------------

For more information on the pam_authsrv module, see the home site:

   http://www-dev.cites.uiuc.edu/PAM/pam_authsrv/

Source code for the latest version of pam_authsrv will be available there,
as well as Encap binary distributions for many common platforms.


Supported Platforms
-------------------

I develop and test pam_authsrv on the following platforms:

   AIX 5.1
   HP-UX 11.00
   RedHat Linux 7.2
   Solaris 8 and 9

If you successfully build pam_authsrv on another platform, please email me a
patch and/or configuration information.


Compatibility Code
------------------

pam_authsrv depends on some library calls which are not available or not
usable on some platforms.  To accomodate these systems, I've included
a version of these calls in the compat subdirectory.

I've slightly modified these functions for integration into this source
tree, but the functionality has not been modified from the original
source.  Please note that while this code should work for you, I didn't
write it, so please don't send me bug reports on it.


Author
------

Feedback and bug reports are welcome.

Mark D. Roth <roth@uiuc.edu>
Campus Information Technologies and Educational Services
University of Illinois at Urbana-Champaign

