README
1basic_radius_auth V1.09
2
3This kit is loosely based on radtest from the Cistron-radiusd which
4again is based on Livingston sources. See COPYRIGHT for details.
5
6This authenticator is specifically made for Squid-2.5 and later.
7
8Installation:
9
10Copy the correct makefile to Makefile
11 Makefile.default = Most OS:es.
12 Makefile.solaris = SunOS5 (Solaris)
13
14cp Makefile.default Makefile
15make clean
16make install
17
18or if you want the helper installed elsewhere than /usr/local/squid
19(the default installation path of Squid) use something like:
20
21make CONFDIR=/etc PREFIX=/usr BINDIR='${PREFIX}/libexec/squid' install
22
23Complete list of make options for tweakin the installation paths:
24
25 PREFIX Top level installation directory (/usr/local/squid)
26 BINDIR Where the binary is installed (PREFIX/libexec)
27 CONFDIR Where the configuration file is installed (PREFIX/etc)
28 MANDIR Where the manpage is installed (PREFIX/man/man8)
29 MANEXT Manpage extension (.8)
30 DESTDIR Root prefix for packaging
31
32
33Configuration:
34
35The RADIUS authenticator is configured using a small configuration file.
36
37The configuration file should look like this:
38# basic_radius_auth configuration file
39# MvS: 28-10-1998
40server suncone.cistron.nl
41secret testje
42
43An example can be found in etc/basic_radius_auth.conf
44
45
46/etc/services:
47
48Modify /etc/services and add:
49radius 1812/udp
50
51Adding this is not mandatory because it used the default port 1812 anyway.
52
53Note: Some old RADIUS servers uses the unofficial port 1645, and you may
54need to override the service port used either by editing /etc/services
55or by specifying the port using the -p command line option or the port
56tag in basic_radius_auth.conf
57
58
59Test it:
60
61Start basic_radius_auth and type a username and a username. The authenticator
62returns OK if the radiusd accepted your password. In any other case you'll
63get ERR.
64
65
66Squid:
67
68Add the authenticator to squid.conf. See the instructions from squid for
69help.
70
71Marc van Selm <selm@cistron.nl>
72Henrik Nordstrom <hno@squid-cache.org>
73