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:
20        * Blowfish - for passwords 72 characters or less in length.
21        * SHA256 - with salting and magic strings.
22        * SHA512 - with salting and magic strings.
23        * MD5 - with optional salt and magic strings.
24        * DES - for passwords 8 characters or less in length.  NOTE:  Blowfish
25       and SHA algorithms require system-specific support.
26

OPTIONS

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

CONFIGURATION

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

KNOWN ISSUES

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

AUTHOR

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

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

QUESTIONS

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

REPORTING BUGS

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

SEE ALSO

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