1basic_ncsa_auth(8)          System Manager's Manual         basic_ncsa_auth(8)
2
3
4

NAME

6       basic_ncsa_auth  - NCSA httpd-style password file authentication helper
7       for Squid
8

SYNOPSIS

10       basic_ncsa_auth passwd file
11

DESCRIPTION

13       basic_ncsa_auth allows Squid to read and authenticate user and password
14       information  from  an  NCSA/Apache httpd-style password file when using
15       basic HTTP authentication.
16
17       This password file can be manipulated using htpasswd.
18
19       This authenticator accepts:  * Blowfish - for passwords  72  characters
20       or  less in length  * SHA256 - with salting and magic strings  * SHA512
21       - with salting and magic strings  * MD5 - with optional salt and  magic
22       strings    *  DES  - for passwords 8 characters or less in length NOTE:
23       Blowfish and SHA algorithms require system-specific support.
24

OPTIONS

26       The only parameter is the password file.  It must have  permissions  to
27       be read by the user that Squid is running as.
28

CONFIGURATION

30              basic_ncsa_auth /etc/squid/squid.pass
31
32       basic_ncsa_auth must have access to the password file to be executed.
33

KNOWN ISSUES

35       DES  functionality  (used  by  htpasswd  by default) silently truncates
36       passwords to 8 characters.  Allowing login with password values shorter
37       than  the  one desired.  This authenticator will reject login with long
38       passwords when using DES.
39

AUTHOR

41       This manual was written by Amos Jeffries <amosjeffries@squid-cache.org>
42
43       Based   on   original   documentation   by   Rodrigo   Rubira    Branco
44       <rrbranco@br.ibm.com>
45

47        *  Copyright (C) 1996-2016 The Squid Software Foundation and contribu‐
48       tors
49        *
50        * Squid software is distributed under GPLv2+ license and includes
51        * contributions from numerous individuals and organizations.
52        * Please see the COPYING and CONTRIBUTORS files for details.
53
54       This file is distributed in the hope that it will be useful, but  WITH‐
55       OUT  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
56       or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
57       for more details.
58
59       You should have received a copy of the GNU General Public License along
60       with this file; if not, write to the Free Software Foundation, Inc., 59
61       Temple Place, Suite 330, Boston, MA 02111-1307 USA
62

QUESTIONS

64       Questions  on  the usage of this program can be sent to the Squid Users
65       mailing list <squid-users@squid-cache.org>
66

REPORTING BUGS

68       Bug reports  need  to  be  made  in  English.   See  http://wiki.squid-
69       cache.org/SquidFaq/BugReporting for details of what you need to include
70       with your bug report.
71
72       Report bugs or bug fixes using http://bugs.squid-cache.org/
73
74       Report serious security bugs to Squid Bugs <squid-bugs@squid-cache.org>
75
76       Report ideas for new improvements to the Squid Developers mailing  list
77       <squid-dev@squid-cache.org>
78

SEE ALSO

80       squid(8), htpasswd(1), GPL(7),
81       The Squid FAQ wiki http://wiki.squid-cache.org/SquidFaq
82       The Squid Configuration Manual http://www.squid-cache.org/Doc/config/
83
84
85
86
87                                 May 16, 2006               basic_ncsa_auth(8)
Impressum