]>
Commit | Line | Data |
---|---|---|
83915266 | 1 | .if !'po4a'hide' .TH basic_radius_auth 8 "7 August 2004" |
d80aac12 | 2 | . |
3 | .SH NAME | |
83915266 AJ |
4 | .if !'po4a'hide' .B basic_radius_auth |
5 | .if !'po4a'hide' \- | |
6 | Squid RADIUS authentication helper | |
d80aac12 | 7 | . |
8 | .SH SYNOPSIS | |
8c2b74bc | 9 | .if !'po4a'hide' .B basic_radius_auth |
83915266 | 10 | .if !'po4a'hide' .B \-f |
92a0c1e0 | 11 | config file |
d80aac12 | 12 | .br |
8c2b74bc | 13 | .if !'po4a'hide' .B basic_radius_auth |
83915266 AJ |
14 | .if !'po4a'hide' .B "\-h \"" |
15 | server name | |
16 | .if !'po4a'hide' .B "\" [\-p " | |
17 | port | |
18 | .if !'po4a'hide' .B "] [\-i " | |
19 | identifier | |
20 | .if !'po4a'hide' .B "] \-w " | |
21 | secret | |
22 | .if !'po4a'hide' .B "[\-t " | |
23 | timeout | |
24 | .if !'po4a'hide' .B "]" | |
d80aac12 | 25 | . |
26 | .SH DESCRIPTION | |
83915266 AJ |
27 | .B basic_radius_auth |
28 | allows Squid to connect to a RADIUS server to | |
d80aac12 | 29 | validate the user name and password of Basic HTTP authentication. |
30 | . | |
83915266 AJ |
31 | .SH OPTIONS |
32 | .if !'po4a'hide' .TP 12 | |
33 | .if !'po4a'hide' .B "\-f configfile" | |
d80aac12 | 34 | Specifies the path to a configuration file. See the CONFIGURATION section |
83915266 | 35 | for details on the file content. |
d80aac12 | 36 | . |
83915266 AJ |
37 | .if !'po4a'hide' .TP |
38 | .if !'po4a'hide' .B "\-h server" | |
d80aac12 | 39 | Alternative method of specifying the server to connect to |
40 | . | |
83915266 AJ |
41 | .if !'po4a'hide' .TP |
42 | .if !'po4a'hide' .B "\-p port" | |
d80aac12 | 43 | Specify another server port where the RADIUS server listens for requests |
44 | if different from the default RADIUS port. Normally not specified. | |
45 | . | |
83915266 AJ |
46 | .if !'po4a'hide' .TP |
47 | .if !'po4a'hide' .B "\-i identifier" | |
d80aac12 | 48 | Unique identifier identifying this Squid proxy to the RADIUS server. |
83915266 AJ |
49 | If not specified the IP address is used to identify the proxy. |
50 | . | |
51 | .if !'po4a'hide' .TP | |
52 | .if !'po4a'hide' .B "\-w secret" | |
d80aac12 | 53 | Alternative method of specifying the shared secret. Using the |
83915266 AJ |
54 | .B \-f |
55 | option with a configuration file is generally more secure and recommended. | |
d80aac12 | 56 | . |
83915266 AJ |
57 | .if !'po4a'hide' .TP |
58 | .if !'po4a'hide' .B "\-t timeout" | |
59 | RADIUS request timeout. Default is 10 seconds. | |
d80aac12 | 60 | . |
61 | .SH CONFIGURATION | |
62 | The configuration specifies how the helper connects to RADIUS. | |
63 | The file contains a list of directives (one per line). Lines | |
83915266 AJ |
64 | beginning with a |
65 | .B # | |
66 | are ignored. | |
d80aac12 | 67 | . |
83915266 | 68 | .if !'po4a'hide' .TP |
8c2b74bc | 69 | .if !'po4a'hide' .BI "server " radiusserver |
d80aac12 | 70 | specifies the name or address of the RADIUS server to connect to. |
71 | . | |
83915266 | 72 | .if !'po4a'hide' .TP |
8c2b74bc | 73 | .if !'po4a'hide' .BI "secret " somesecretstring |
d80aac12 | 74 | specifies the shared RADIUS secret. |
75 | . | |
83915266 | 76 | .if !'po4a'hide' .TP |
8c2b74bc | 77 | .if !'po4a'hide' .BI "identifier " nameofserver |
83915266 | 78 | specifies what name the proxy should use to identify itself to the RADIUS server. |
d80aac12 | 79 | This directive is optional. |
80 | . | |
83915266 | 81 | .if !'po4a'hide' .TP |
8c2b74bc | 82 | .if !'po4a'hide' .BI "port " portnumber |
d80aac12 | 83 | Specifies the port number or service name where the helper should connect. |
83915266 | 84 | . |
6ec3c3f6 AM |
85 | .if !'po4a'hide' .TP |
86 | .if !'po4a'hide' .BI "timeout " seconds | |
87 | Specifies the RADIUS request timeout. | |
88 | . | |
d80aac12 | 89 | .SH AUTHOR |
8c2b74bc AJ |
90 | This program is written by |
91 | .if !'po4a'hide' .I Marc van Selm <selm@cistron.nl> | |
92a0c1e0 AJ |
92 | .if !'po4a'hide' .I Henrik Nordstrom <hno@squid-cache.org> |
93 | .PP | |
83915266 | 94 | With contributions from many others. |
92a0c1e0 | 95 | .PP |
8c2b74bc AJ |
96 | This manual was written by |
97 | .if !'po4a'hide' .I Henrik Nordstrom <hno@squid-cache.org> | |
d80aac12 | 98 | . |
83915266 | 99 | .SH COPYRIGHT |
5b95b903 AJ |
100 | .PP |
101 | * Copyright (C) 1996-2014 The Squid Software Foundation and contributors | |
102 | * | |
103 | * Squid software is distributed under GPLv2+ license and includes | |
104 | * contributions from numerous individuals and organizations. | |
105 | * Please see the COPYING and CONTRIBUTORS files for details. | |
106 | .PP | |
92a0c1e0 AJ |
107 | This program and documentation is copyright to the authors named above. |
108 | .PP | |
c871f41e | 109 | Distributed under the GNU General Public License (GNU GPL) version 2 or later (GPLv2+). |
83915266 | 110 | . |
d80aac12 | 111 | .SH QUESTIONS |
8c2b74bc AJ |
112 | Questions on the usage of this program can be sent to the |
113 | .I Squid Users mailing list | |
114 | .if !'po4a'hide' <squid-users@squid-cache.org> | |
83915266 AJ |
115 | .PP |
116 | Or contact your favorite RADIUS list/friend if the question is more related to | |
d80aac12 | 117 | RADIUS than Squid. |
118 | . | |
119 | .SH REPORTING BUGS | |
c871f41e AJ |
120 | Bug reports need to be made in English. |
121 | See http://wiki.squid-cache.org/SquidFaq/BugReporting for details of what you need to include with your bug report. | |
122 | .PP | |
8c2b74bc | 123 | Report bugs or bug fixes using http://bugs.squid-cache.org/ |
83915266 | 124 | .PP |
8c2b74bc | 125 | Report serious security bugs to |
d80aac12 | 126 | .I Squid Bugs <squid-bugs@squid-cache.org> |
83915266 | 127 | .PP |
8c2b74bc AJ |
128 | Report ideas for new improvements to the |
129 | .I Squid Developers mailing list | |
130 | .if !'po4a'hide' <squid-dev@squid-cache.org> | |
d80aac12 | 131 | . |
83915266 | 132 | .SH SEE ALSO |
6d5cbee6 AJ |
133 | .if !'po4a'hide' .BR squid "(8), " |
134 | .if !'po4a'hide' .BR GPL "(7), " | |
83915266 | 135 | .br |
d80aac12 | 136 | .BR RFC2058 " - Remote Authentication Dial In User Service (RADIUS)" |
6d5cbee6 AJ |
137 | .br |
138 | The Squid FAQ wiki | |
139 | .if !'po4a'hide' http://wiki.squid-cache.org/SquidFaq | |
140 | .br | |
141 | The Squid Configuration Manual | |
142 | .if !'po4a'hide' http://www.squid-cache.org/Doc/config/ | |
143 |