NAME¶

 ext_sql_session_acl - SQL Database session lookup helper for Squid

SYNOPSIS¶

 ext_sql_session_acl [options]

DESCRIPTION¶

Validates an HTTP requests access authorization with a session database.

Taking an identity token to be validated (as determined by the external_acl_type format) it returns a username or tag associated with the identity token passed in.

Common forms of identifiers are IP address, EUI (MAC) address, passwords, or UUID tokens.

This program uses Squid concurrency support.

OPTIONS¶

--dsn

Database DSN. Default "DBI:mysql:database=squid"

--user

Database User

--password

Database password

--table

Database table. Default "passwd".

--uidcol

Unique Session Identifier column. Default "id".

--usercol

External ACL user= result column.

--tagcol

External ACL tag= result column.

--cond

Condition, defaults to enabled=1. Specify 1 or "" for no condition

--persist

Keep a persistent database connection open between queries.

--debug

Write debug info to stderr.

AUTHOR¶

This program and documentation was written by Amos Jeffries <amosjeffries@squid-cache.org>

Based on original work in DB_auth by Henrik Nordstrom <henrik@henriknordstrom.net> With assistance of Nishant Sharma <codemarauder@gmail.com>

COPYRIGHT¶

 * Copyright (C) 1996-2023 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.
 Copyright (C) 2012 Amos Jeffries <amosjeffries@squid-cache.org>
 This program is free software. You may redistribute copies of it under the
 terms of the GNU General Public License version 2, or (at your opinion) any
 later version.

QUESTIONS¶

Questions on the usage of this program can be sent to the Squid Users mailing list <squid-users@lists.squid-cache.org>

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 <squid-bugs@lists.squid-cache.org>

Report ideas for new improvements to the Squid Developers mailing list <squid-dev@lists.squid-cache.org>

SEE ALSO¶

squid (8), GPL (7),

The Squid FAQ wiki https://wiki.squid-cache.org/SquidFaq

The Squid Configuration Manual http://www.squid-cache.org/Doc/config/