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