STANNIX Solutions for the Real World


Manual: pppd-radius

PPPD-RADIUS(8)				   System Manager's Manual			      PPPD-RADIUS(8)

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/ra‐
       diusclient.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
       Dianne Skoll 

											      PPPD-RADIUS(8)