| 1 |
.\" manual page [] for RADIUS plugin for pppd 2.4 |
| 2 |
.\" SH section heading |
| 3 |
.\" SS subsection heading |
| 4 |
.\" LP paragraph |
| 5 |
.\" IP indented paragraph |
| 6 |
.\" TP hanging label |
| 7 |
.TH PPPD-RADIUS 8 |
| 8 |
.SH NAME |
| 9 |
radius.so \- RADIUS authentication plugin for |
| 10 |
.BR pppd (8) |
| 11 |
.SH SYNOPSIS |
| 12 |
.B pppd |
| 13 |
[ |
| 14 |
.I options |
| 15 |
] |
| 16 |
plugin radius.so |
| 17 |
.SH DESCRIPTION |
| 18 |
.LP |
| 19 |
The RADIUS plugin for pppd permits pppd to perform PAP, CHAP, MS-CHAP and |
| 20 |
MS-CHAPv2 authentication against a RADIUS server instead of the usual |
| 21 |
.I /etc/ppp/pap\-secrets |
| 22 |
and |
| 23 |
.I /etc/ppp/chap\-secrets |
| 24 |
files. |
| 25 |
.LP |
| 26 |
The RADIUS plugin is built on a library called |
| 27 |
.B radiusclient |
| 28 |
which has its own configuration files (usually in \fI/etc/radiusclient\fR), |
| 29 |
consult those files for more information on configuring the RADIUS |
| 30 |
plugin |
| 31 |
|
| 32 |
.SH OPTIONS |
| 33 |
The RADIUS plugin introduces one additional pppd option: |
| 34 |
.TP |
| 35 |
.BI "radius\-config\-file " filename |
| 36 |
The file |
| 37 |
.I filename |
| 38 |
is taken as the radiusclient configuration file. If this option is not |
| 39 |
used, then the plugin uses |
| 40 |
.I /etc/radiusclient/radiusclient.conf |
| 41 |
as the configuration file. |
| 42 |
.TP |
| 43 |
.BI "avpair " attribute=value |
| 44 |
Adds an Attribute-Value pair to be passed on to the RADIUS server on each request. |
| 45 |
.TP |
| 46 |
.BI map\-to\-ifname |
| 47 |
Sets Radius NAS-Port attribute to number equal to interface name (Default) |
| 48 |
.TP |
| 49 |
.BI map\-to\-ttyname |
| 50 |
Sets Radius NAS-Port attribute value via libradiusclient library |
| 51 |
|
| 52 |
.SH USAGE |
| 53 |
To use the plugin, simply supply the |
| 54 |
.B plugin radius.so |
| 55 |
option to pppd, and edit |
| 56 |
.I /etc/radiusclient/radiusclient.conf |
| 57 |
appropriately. If you use the RADIUS plugin, the normal pppd authentication |
| 58 |
schemes (login, checking the /etc/ppp/*-secrets files) are skipped. The |
| 59 |
RADIUS server should assign an IP address to the peer using the RADIUS |
| 60 |
Framed-IP-Address attribute. |
| 61 |
|
| 62 |
.SH SEE ALSO |
| 63 |
.BR pppd (8) " pppd\-radattr" (8) |
| 64 |
|
| 65 |
.SH AUTHOR |
| 66 |
Dianne Skoll <[email protected]> |