basic_ncsa_auth(8) System Manager's Manual basic_ncsa_auth(8)
NAME
basic_ncsa_auth - NCSA httpd-style password file authentication helper
for Squid
SYNOPSIS
basic_ncsa_auth passwd file
DESCRIPTION
basic_ncsa_auth allows Squid to read and authenticate user and password
information from an NCSA/Apache httpd-style password file when using
basic HTTP authentication.
This password file can be manipulated using htpasswd.
This authenticator accepts:
* Blowfish - for passwords 72 characters or less in length.
* SHA256 - with salting and magic strings.
* SHA512 - with salting and magic strings.
* MD5 - with optional salt and magic strings.
* DES - for passwords 8 characters or less in length. NOTE: Blowfish
and SHA algorithms require system-specific support.
OPTIONS
The only parameter is the password file. It must have permissions to
be read by the user that Squid is running as.
CONFIGURATION
basic_ncsa_auth /etc/squid/squid.pass
basic_ncsa_auth must have access to the password file to be executed.
KNOWN ISSUES
DES functionality (used by htpasswd by default) silently truncates
passwords to 8 characters. Allowing login with password values shorter
than the one desired. This authenticator will reject login with long
passwords when using DES.
AUTHOR
This manual was written by Amos Jeffries <amosjeffries@squid-cache.org>
Based on original documentation by Rodrigo Rubira Branco
<rrbranco@br.ibm.com>
COPYRIGHT
* Copyright (C) 1996-2023 The Squid Software Foundation and contribu-
tors
*
* Squid software is distributed under GPLv2+ license and includes
* contributions from numerous individuals and organizations.
* Please see the COPYING and CONTRIBUTORS files for details.
This file is distributed in the hope that it will be useful, but WITH-
OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
for more details.
You should have received a copy of the GNU General Public License along
with this file; if not, write to the Free Software Foundation, Inc., 59
Temple Place, Suite 330, Boston, MA 02111-1307 USA
QUESTIONS
Questions on the usage of this program can be sent to the Squid Users
mailing list <squid-users@lists.squid-cache.org>
REPORTING BUGS
Bug reports need to be made in English. See http://wiki.squid-
cache.org/SquidFaq/BugReporting for details of what you need to include
with your bug report.
Report bugs or bug fixes using http://bugs.squid-cache.org/
Report serious security bugs to Squid Bugs <squid-bugs@lists.squid-
cache.org>
Report ideas for new improvements to the Squid Developers mailing list
<squid-dev@lists.squid-cache.org>
SEE ALSO
squid(8), htpasswd(1), GPL(7),
The Squid FAQ wiki http://wiki.squid-cache.org/SquidFaq
The Squid Configuration Manual http://www.squid-cache.org/Doc/config/
May 16, 2006 basic_ncsa_auth(8)
Generated by dwww version 1.14 on Fri Mar 28 10:39:14 CET 2025.