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

       This file is distributed in the hope that it will be useful, but WITHOUT 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@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@squid-cache.org>

       Report ideas for new improvements to the Squid Developers mailing list <squid-dev@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)