NAME

       radius.so - RADIUS authentication plugin for pppd(8)

SYNOPSIS

       pppd [ options ] plugin radius.so

DESCRIPTION

       The  RADIUS  plugin  for  pppd  permits  pppd  to perform PAP, CHAP, MS-CHAP and MS-CHAPv2 authentication
       against a RADIUS server instead of the usual /etc/ppp/pap-secrets and /etc/ppp/chap-secrets files.

       The RADIUS plugin is built on a library  called  radiusclient  which  has  its  own  configuration  files
       (usually in /etc/radiusclient), consult those files for more information on configuring the RADIUS plugin

OPTIONS

       The RADIUS plugin introduces one additional pppd option:

       radius-config-file filename
              The  file  filename  is taken as the radiusclient configuration file.  If this option is not used,
              then the plugin uses /etc/radiusclient/radiusclient.conf as the configuration file.

       avpair attribute=value
              Adds an Attribute-Value pair to be passed on to the RADIUS server on each request.

       map-to-ifname
              Sets Radius NAS-Port attribute to number equal to interface name (Default)

       map-to-ttyname
              Sets Radius NAS-Port attribute value via libradiusclient library

USAGE

       To   use   the   plugin,   simply   supply   the   plugin   radius.so   option   to   pppd,   and    edit
       /etc/radiusclient/radiusclient.conf  appropriately.   If  you  use  the  RADIUS  plugin,  the normal pppd
       authentication schemes (login, checking the /etc/ppp/*-secrets files) are  skipped.   The  RADIUS  server
       should assign an IP address to the peer using the RADIUS Framed-IP-Address attribute.

SEE ALSO

       pppd(8) pppd-radattr(8)

AUTHOR

       David F. Skoll <dfs@roaringpenguin.com>

                                                                                                  PPPD-RADIUS(8)