Provided by: squid_3.5.12-1ubuntu7_i386 bug

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-2015  The  Squid  Software  Foundation  and
       contributors
        *
        * 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
       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)