source: squid-ssl/trunk/fuentes/helpers/basic_auth/getpwnam/basic_getpwnam_auth.8 @ 5495

Last change on this file since 5495 was 5495, checked in by Juanma, 2 years ago

Initial release

File size: 3.8 KB
Line 
1.if !'po4a'hide' .TH basic_getpwnam_auth 8
2.
3.SH NAME
4basic_getpwnam_auth \- Local Users auth helper for Squid
5.
6.SH SYNOPSIS
7.if !'po4a'hide' .B basic_getpwnam_auth
8.
9.SH DESCRIPTION
10.B basic_getpwnam_auth
11allows Squid to authenticate any local user accounts
12to validate the user name and password of Basic HTTP authentication.
13.PP
14It uses
15.B getpwnam()
16and
17.B getspnam()
18routines for authentication.
19.PP
20This has the following advantages over the NCSA module:
21.if !'po4a'hide' .TP 5
22\- Allows authentication of all known local users
23.
24.if !'po4a'hide' .TP
25\- Allows authentication through nsswitch.conf
26.
27.if !'po4a'hide' .TP
28\- Can handle NIS(+) requests
29.
30.if !'po4a'hide' .TP
31\- Can handle LDAP requests
32.
33.if !'po4a'hide' .TP
34\- Can handle PAM requests
35.
36.SH CONFIGURATION
37.if !'po4a'hide' .RS
38.if !'po4a'hide' .B auth_param basic program /path/to/basic_getpwnam_auth
39.if !'po4a'hide' .br
40.if !'po4a'hide' .B auth_param basic children concurrency=1
41.if !'po4a'hide' .RE
42.PP
43When used for authenticating to local UNIX shadow password databases
44the program must be running as root or else it won't have sufficient
45permissions to access the user password database. Such use of this
46program is not recommended, but if you absolutely need to then make
47the program
48.B setuid
49.B root
50.if !'po4a'hide' .RS
51.if !'po4a'hide' .B chown root basic_getpwnam_auth
52.if !'po4a'hide' .br
53.if !'po4a'hide' .B chmod u+s basic_getpwnam_auth
54.if !'po4a'hide' .RE
55.PP
56Please note that in such configurations it is also strongly recommended
57that the program is moved into a directory where normal users cannot
58access it, as this mode of operation will allow any local user to
59brute-force other users passwords. Also note the program has not been
60fully audited and the author cannot be held responsible for any security
61issues due to such installations.
62.
63.SH AUTHOR
64This program was written by
65.if !'po4a'hide' .I Erik Hofman <erik.hofman@a1.nl>
66.if !'po4a'hide' .I Robin Elfrink <robin@a1.nl>
67.if !'po4a'hide' .I Giancarlo Razzolini <linux-fan@onda.com.br>
68.PP
69Based on original code by
70.if !'po4a'hide' .I Jon Thackray <jrmt@uk.gdscorp.com>.
71.PP
72This manual was written by
73.if !'po4a'hide' .I Amos Jeffries <amosjeffries@squid-cache.org>
74.
75.SH COPYRIGHT
76.PP
77 * Copyright (C) 1996-2015 The Squid Software Foundation and contributors
78 *
79 * Squid software is distributed under GPLv2+ license and includes
80 * contributions from numerous individuals and organizations.
81 * Please see the COPYING and CONTRIBUTORS files for details.
82.PP
83This program and documentation is copyright to the authors named above.
84.PP
85Distributed under the GNU General Public License (GNU GPL) version 2 or later (GPLv2+).
86.
87.SH QUESTIONS
88Questions on the usage of this program can be sent to the
89.I Squid Users mailing list
90.if !'po4a'hide' <squid-users@squid-cache.org>
91.
92.SH REPORTING BUGS
93Bug reports need to be made in English.
94See http://wiki.squid-cache.org/SquidFaq/BugReporting for details of what you need to include with your bug report.
95.PP
96Report bugs or bug fixes using http://bugs.squid-cache.org/
97.PP
98Report serious security bugs to
99.I Squid Bugs <squid-bugs@squid-cache.org>
100.PP
101Report ideas for new improvements to the
102.I Squid Developers mailing list
103.if !'po4a'hide' <squid-dev@squid-cache.org>
104.
105.SH SEE ALSO
106.if !'po4a'hide' .BR squid "(8), "
107.if !'po4a'hide' .BR basic_pam_auth "(8), "
108.if !'po4a'hide' .BR basic_ncsa_auth "(8), "
109.if !'po4a'hide' .BR basic_ldap_auth "(8), "
110.if !'po4a'hide' .BR basic_nis_auth "(8), "
111.if !'po4a'hide' .BR chown "(1), "
112.if !'po4a'hide' .BR chmod "(1), "
113.if !'po4a'hide' .BR nsswitch.conf "(5), "
114.if !'po4a'hide' .BR getpwnam "(3), "
115.if !'po4a'hide' .BR getspnam "(3), "
116.if !'po4a'hide' .BR GPL "(7), "
117.br
118The Squid FAQ wiki
119.if !'po4a'hide' http://wiki.squid-cache.org/SquidFaq
120.br
121The Squid Configuration Manual
122.if !'po4a'hide' http://www.squid-cache.org/Doc/config/
123
Note: See TracBrowser for help on using the repository browser.