digest_file_auth (8) - Linux Man Pages

digest_file_auth: File based digest authentication helper for Squid.

NAME

digest_file_auth - File based digest authentication helper for Squid.

Version 1.1

SYNOPSIS

digest_file_auth [-c] file

DESCRIPTION

digest_file_auth is an installed binary authentication program for Squid. It handles digest authentication protocol and authenticates against a text file backend. This program will automatically detect the existence of a concurrecy channel-ID and adjust appropriately. It may be used with any value 0 or above for the auth_param children concurrency= parameter.

OPTIONS

-c
Accept digest hashed passwords rather than plaintext in the password file

CONFIGURATION

Username database file format:

- comment lines are possible and should start with a '#';
- empty or blank lines are possible;
- plaintext entry format is username:password
- HA1 entry format is username:realm:HA1

To build a directory integrated backend, you need to be able to calculate the HA1 returned to squid. To avoid storing a plaintext password you can calculate MD5(username:realm:password) when the user changes their password, and store the tuple username:realm:HA1. then find the matching username:realm when squid asks for the HA1.

This implementation could be improved by using such a triple for the file format. However storing such a triple does little to improve security: If compromised the username:realm:HA1 combination is "plaintext equivalent" - for the purposes of digest authentication they allow the user access. Password syncronisation is not tackled by digest - just preventing on the wire compromise.

AUTHOR

This program was written by Robert Collins <robertc [at] squid-cache.org>

Based on prior work by Arjan de Vet <Arjan.deVet [at] adv.iae.nl> o4a'hide' .I Robert Collins <robertc [at] squid-cache.org> Amos Jeffries <amosjeffries [at] squid-cache.org>

COPYRIGHT


 Copyright (C) 1996-2016 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 program and documentation is copyright to the authors named above.

Distributed under the GNU General Public License (GNU GPL) version 2 or later (GPLv2+).

QUESTIONS

Questions on the usage of this program can be sent to the Squid Users mailing list <squid-users [at] 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 [at] squid-cache.org>

Report ideas for new improvements to the Squid Developers mailing list <squid-dev [at] squid-cache.org>

SEE ALSO

squid(8), GPL(7),
The Squid FAQ wiki http://wiki.squid-cache.org/SquidFaq
The Squid Configuration Manual http://www.squid-cache.org/Doc/config/