basic_ncsa_auth(8)

basic_ncsa_auth8

Ncsa httpd-style password file authentication helper for squid

Usage

basic_ncsa_auth passwd file

Overview

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.

Questions

Questions on the usage of this program can be sent to the Squid Users mailing list <[email protected]>

Releases

7 releases since Debian 8 (Jessie); the text changed 6 times.

  1. 8
  2. 9
  3. 10
  4. 11
  5. 12
  6. 13
  7. Arch

Author

This manual was written by Amos Jeffries <[email protected]>

Based on original documentation by Rodrigo Rubira Branco <[email protected]>

Reporting bugs

Bug reports need to be made in English. See https://wiki.squid-cache.org/SquidFaq/BugReporting for details of what you need to include with your bug report.

Report bugs or bug fixes using https://bugs.squid-cache.org/

Report serious security bugs to Squid Bugs <[email protected]>

Report ideas for new improvements to the Squid Developers mailing list <[email protected]>

From squid 7.7-1 in Arch Linux 2026-11-01. Parsed by carta from the page's roff source.