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 authen‐
17       tication via RADIUS and wants to authenticate news reading connections
18       as well.
19
20       By default, radius reads pathetc/radius.conf for configuration informa‐
21       tion, but a different configuration file can be specified with -f.  See
22       radius.conf(5) for a description of the configuration file.
23

OPTIONS

25       -f config
26           Read config instead of pathetc/radius.conf for configuration infor‐
27           mation.
28
29       -h  Print out a usage message and exit.
30

EXAMPLE

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

BUGS

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

HISTORY

56       The RADIUS authenticator was originally written by Aidan Cully.  This
57       documentation was written by Russ Allbery <rra@stanford.edu>.
58
59       $Id: radius.8 5896 2002-12-03 03:29:19Z rra $
60