1 .if !'po4a'hide' .TH basic_pam_auth 8 "5 Sep 2003"
4 .if !'po4a'hide' .B basic_pam_auth
6 Squid PAM Basic authentication helper
9 .if !'po4a'hide' .B "basic_pam_auth [\-n \""
11 .if !'po4a'hide'.B "\"] [\-t "
13 .if !'po4a'hide' .B "] [\-o] [\-1]"
17 allows Squid to connect to a mostly any available PAM
18 database to validate the user name and password of Basic HTTP
22 .if !'po4a'hide' .TP 12
23 .if !'po4a'hide' .BI "\-s " "service\-name"
24 Specifies the PAM service name Squid uses, defaults to
28 .if !'po4a'hide' .BI "\-t " TTL
29 Enables persistent PAM connections where the connection to the PAM
30 database is kept open and reused for new logins. The TTL specifies
31 how long the connection will be kept open (in seconds). Default is
32 to not keep PAM connections open. Please note that the use of
33 persistent PAM connections is slightly outside the PAM
34 specification and may not work with all PAM configurations.
37 .if !'po4a'hide' .BI \-o
38 Do not perform the PAM account management group (account
42 The program needs a PAM service to be configured in
47 The default service name is
49 , and the program makes use of the
53 management groups to verify the password and the accounts validity.
55 For details on how to configure PAM services, see the PAM
56 documentation for your system. This manual does not cover PAM
57 configuration details.
61 When used for authenticating to local UNIX shadow password databases
62 the program must be running as root or else it won't have sufficient
63 permissions to access the user password database. Such use of this
64 program is not recommended, but if you absolutely need to then make
65 the program setuid root
68 .if !'po4a'hide' .B chown root pam_auth
70 .if !'po4a'hide' .B chmod u+s pam_auth
73 Please note that in such configurations it is also strongly recommended
74 that the program is moved into a directory where normal users cannot
75 access it, as this mode of operation will allow any local user to
76 brute-force other users passwords. Also note the program has not been
77 fully audited and the author cannot be held responsible for any security
78 issues due to such installations.
81 This program and documentation was written by
82 .if !'po4a'hide' .I Henrik Nordstrom <hno@squid-cache.org>
87 and this manual is Copyright 1999,2002,2003
88 .if !'po4a'hide' .I Henrik Nordstrom <hno@squid-cache.org>
90 Distributed under the GNU General Public License (GNU GPL) version 2 or later (GPLv2+).
93 Questions on the usage of this program can be sent to the
94 .I Squid Users mailing list
95 .if !'po4a'hide' <squid-users@squid-cache.org>
98 Bug reports need to be made in English.
99 See http://wiki.squid-cache.org/SquidFaq/BugReporting for details of what you need to include with your bug report.
101 Report bugs or bug fixes using http://bugs.squid-cache.org/
103 Report serious security bugs to
104 .I Squid Bugs <squid-bugs@squid-cache.org>
106 Report ideas for new improvements to the
107 .I Squid Developers mailing list
108 .if !'po4a'hide' <squid-dev@squid-cache.org>
111 .if !'po4a'hide' .BR squid "(8), "
112 .if !'po4a'hide' .BR pam "(8), "
113 .if !'po4a'hide' .BR pam.conf "(5), "
114 .if !'po4a'hide' .BR chown "(1), "
115 .if !'po4a'hide' .BR chmod "(1), "
117 PAM Systems Administrator Guide