Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

basic_ncsa_auth (8)

Name

basic_ncsa_auth - style password file authentication helper for Squid

Synopsis

basic_ncsa_auth passwd file

Description

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-2017 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@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>


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | web/proxy/squid  |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+
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/




NOTES
       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source    was    downloaded    from     http://www.squid-cache.org/Ver-
       sions/v3/3.5/squid-3.5.27.tar.xz

       Further information about this software can be found on the open source
       community website at http://www.squid-cache.org/.



                                 May 16, 2006               basic_ncsa_auth(8)