Debian Codegraph @

upstream/debian-unstable/man8/pppd-radius.8

raw
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]>