| .\" manual page [] for RADIUS plugin for pppd 2.4 |
| .\" $Id: pppd-radius.8,v 1.5 2004/03/26 13:27:17 kad Exp $ |
| .\" SH section heading |
| .\" SS subsection heading |
| .\" LP paragraph |
| .\" IP indented paragraph |
| .\" TP hanging label |
| .TH PPPD-RADIUS 8 |
| .SH NAME |
| radius.so \- RADIUS authentication plugin for |
| .BR pppd (8) |
| .SH SYNOPSIS |
| .B pppd |
| [ |
| .I options |
| ] |
| plugin radius.so |
| .SH DESCRIPTION |
| .LP |
| 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 |
| .I /etc/ppp/pap-secrets |
| and |
| .I /etc/ppp/chap-secrets |
| files. |
| .LP |
| The RADIUS plugin is built on a library called |
| .B radiusclient |
| which has its own configuration files (usually in \fI/etc/radiusclient\fR), |
| consult those files for more information on configuring the RADIUS |
| plugin |
| |
| .SH OPTIONS |
| The RADIUS plugin introduces one additional pppd option: |
| .TP |
| .BI "radius-config-file " filename |
| The file |
| .I filename |
| is taken as the radiusclient configuration file. If this option is not |
| used, then the plugin uses |
| .I /etc/radiusclient/radiusclient.conf |
| as the configuration file. |
| .TP |
| .BI "avpair " attribute=value |
| Adds an Attribute-Value pair to be passed on to the RADIUS server on each request. |
| .TP |
| .BI map-to-ifname |
| Sets Radius NAS-Port attribute to number equal to interface name (Default) |
| .TP |
| .BI map-to-ttyname |
| Sets Radius NAS-Port attribute value via libradiusclient library |
| |
| .SH USAGE |
| To use the plugin, simply supply the |
| .B plugin radius.so |
| option to pppd, and edit |
| .I /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. |
| |
| .SH SEE ALSO |
| .BR pppd (8) " pppd-radattr" (8) |
| |
| .SH AUTHOR |
| David F. Skoll <dfs@roaringpenguin.com> |
