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.  By default this user is
28       proxy. This can be changed using the cache_effective_user directive  in
29       the squid.conf file.
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       This  file is distributed in the hope that it will be useful, but WITH‐
50       OUT ANY WARRANTY; without even the implied warranty of  MERCHANTABILITY
51       or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
52       for more details.
53
54       You should have received a copy of the GNU General Public License along
55       with this file; if not, write to the Free Software Foundation, Inc., 59
56       Temple Place, Suite 330, Boston, MA 02111-1307 USA
57

QUESTIONS

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

REPORTING BUGS

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

SEE ALSO

75       squid(8), htpasswd(1), GPL(7),
76       The Squid FAQ wiki http://wiki.squid-cache.org/SquidFaq
77       The Squid Configuration Manual http://www.squid-cache.org/Doc/config/
78
79
80
81
82                                 May 16, 2006               basic_ncsa_auth(8)
Impressum