radius(8)

1RADIUS(8)                 InterNetNews Documentation                 RADIUS(8)
2
3
4

NAME

6       radius - nnrpd RADIUS password authenticator
7

SYNOPSIS

9       radius [-h] [-f config]
10

DESCRIPTION

12       radius is an nnrpd authenticator, accepting a username and password
13       from nnrpd (given to nnrpd by a reader connection) and attempting to
14       authenticate that username and password against a RADIUS server.  See
15       readers.conf(5) for more information on how to configure an nnrpd
16       authenticator.  It is useful for a site that already does user
17       authentication via RADIUS and wants to authenticate news reading
18       connections as well.
19
20       By default, radius reads pathetc/inn-radius.conf for configuration
21       information, but a different configuration file can be specified with
22       -f.  See inn-radius.conf(5) for a description of the configuration
23       file.
24

OPTIONS

26       -f config
27           Read config instead of pathetc/inn-radius.conf for configuration
28           information.
29
30       -h  Print out a usage message and exit.
31

EXAMPLE

33       The following readers.conf(5) fragment tells nnrpd to authenticate all
34       connections using this authenticator:
35
36           auth radius {
37               auth: radius
38               default: <FAIL>
39               default-domain: example.com
40           }
41
42       "@example.com" will be appended to the user-supplied identity, and if
43       RADIUS authentication fails, the user will be assigned an identity of
44       "<FAIL>@example.com".
45

BUGS

47       It has been reported that this authenticator doesn't work with Ascend
48       RADIUS servers, but does work with Cistron RADIUS servers.  It's also
49       believed to work with Livingston's RADIUS server.  Contributions to
50       make it work better with different types of RADIUS servers would be
51       gratefully accepted.
52
53       This code has not been audited against the RADIUS protocol and may not
54       implement it correctly.
55

HISTORY

57       The RADIUS authenticator was originally written by Aidan Cully.  This
58       documentation was written by Russ Allbery <eagle@eyrie.org>.
59