doc/PAM

   1
   2                 PAM Support for FreeRadius
   3
   4
   5 0. INTRODUCTION
   6
   7    PAM support was done by Jeph Blaize. Miguel a.l. Paraz <map@iphil.net>
   8    ported it to Cistron-Radius. Chris Dent <cdent@kiva.net> added the
   9    Pam-Auth attribute. It is not complete yet but seems to work
  10    (for authentication only).
  11
  12 1. USAGE
  13
  14    Use Auth-Type = Pam in the users file.  You cannot use Password = "PAM"
  15    as in other radius servers. Sorry.
  16
  17    You can also use ``Pam-Auth = "somestring"'' to specify an entry in
  18    /etc/pam.d. The default is "radius".
  19
  20 2. NOTES
  21
  22    Use ./configure --with-pam to enable building of the PAM module
  23    (for now)
  24
  25    Miguel has made PAM changes to the Cistron radiusd, since he now uses
  26    it as the basis of many accounting systems. However, according to the
  27    PAM experts, calling the pam_start function for each user to be
  28    authenticated is a bad idea. Seems to work for him, though.
  29
  30    Besides, the Pam-Auth attribute only works if pam_start is called
  31    everytime anyways ..
  32
  33 3. TODO:
  34
  35    Real PAM support, figure out how we can write a module that will make
  36    it blend in with PAM more seamlessly.  With this, we can replace the
  37    DENY_SHELL with something more flexible such as a database.
  38
  39 4. EXAMPLE:
  40
  41 DEFAULT Auth-Type = Pam,  NAS-IP-Address = 206.97.64.5
  42         Service-Type = Framed-User,
  43         Framed-Protocol = PPP,
  44         Framed-IP-Address = 255.255.255.254,
  45         Filter-Id = "std.ppp",
  46         Framed-MTU = 1500,
  47         Framed-Compression = Van-Jacobson-TCP-IP
  48 DEFAULT Auth-Type = Pam,  Pam-Auth = "radius2", NAS-IP-Address = 127.0.0.1
  49         Service-Type = Framed-User,
  50         Framed-Protocol = PPP,
  51         Framed-IP-Address = 255.255.255.254,
  52         Filter-Id = "std.ppp",
  53         Framed-MTU = 1500,
  54         Framed-Compression = Van-Jacobson-TCP-IP
  55