user/pam_radius/README

   1                 pam_radius_auth.c
   2                ===================
   3
   4   This is the PAM to RADIUS authentication module.  It allows any
   5 Linux or Solaris machine to become a RADIUS client for authentication
   6 and password change requests.  You will need to supply your own RADIUS
   7 server to perform the actual authentication.
   8
   9   The latest version has a simple merger of the original pam_radius
  10 session accounting code which will work *only* on Linux.
  11
  12   See INSTALL for instructions on building and installing this module.
  13 I have successfully used it for RADIUS authentication on RedHat 4.2,
  14 RedHat 5.x, RedHat 6.x, and Solaris 2.6.
  15
  16   A number of options are supported by this module.  See USAGE for
  17 more details.
  18
  19   Care should be taken when configuring RADIUS authentication.  Your
  20 RADIUS server should have a minimal set of machines in it's 'clients'
  21 file.  The server should NOT be visible to the world at large, but
  22 should be contained behind a firewall.  If your RADIUS server is
  23 visible from the Internet, a number of attacks become possible.
  24
  25   Any additional questions can be directed to:
  26
  27   Alan DeKok (aland@freeradius.org)
  28
  29   For the latest version and updates, see the main web or ftp site:
  30
  31 http://www.freeradius.org/
  32 ftp://ftp.freeradius.org/pub/radius/
  33
  34
  35   The pam_radius_auth module based on an old version of Cristian
  36 Gafton's pam_radius.c, and on an Apache module I wrote a while back.
  37 (mod_auth_radius.c, also on ftp://ftp.freeradius.org/pub/radius/).
  38
  39   The source contains a full suite of RADIUS functions, instead of
  40 using libpwdb.  It makes sense, because we want it to compile
  41 out of the box on Linux and Solaris 2.6.  I also wasn't able to find
  42 much documentation for RADIUS authentication support in libpwdb, so I
  43 rolled my own.
  44
  45   There are minimal restrictions on using the code, as set out in the
  46 disclaimer and copyright notice in pam_radius_auth.c.
  47
  48   Building it is straightforward: use GNU make, and type 'make'.  If
  49 you've got some other weird make, you'll have to edit the Makefile to
  50 remove the GNU make directives  'ifeq', 'else', etc.
  51
  52   Alan DeKok <aland@freeradius.org>