ext_file_userip_acl - Restrict users to certain IP addresses, using a text file backend.
Contents
Configuration
The squid.conf configuration for the external ACL should be:
external_acl_typetype-name%SRC%LOGIN/path/to/ext_file_userip_acl-f/path/to/config.file
If the helper program finds a matching username/ip in the configuration file, it returns OK , otherwise
it returns ERR.
The configuration file format is as follows:
ip_addr[/netmask] username|@group|ALL|NONE
Where ip_addr is a dotted quad format IP address, the netmask must be in dotted quad format too.
When the second parameter is prefixed with an @ , the program will lookup the /etc/group file entry for
the specified username.
There are other two directives, ALL and NONE , which mean "any user on this IP address may authenticate"
or "no user on this IP address may authenticate".
Copyright
* Copyright (C) 1996-2024 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+).
Description
ext_file_userip_acl is an installed binary. An external helper for the Squid external acl scheme.
It works by reading a pair composed by an IP address and an username on STDIN and matching it against a
configuration file.
Name
ext_file_userip_acl - Restrict users to certain IP addresses, using a text file backend.
Version 1.0
Options
-d Write debug info to stderr.
-ffile Configuration file to load.
-h Display the binary help and command line syntax info using stderr.
Questions
Questions on the usage of this program can be sent to the SquidUsersmailinglist <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 SquidBugs<squid-bugs@lists.squid-cache.org>
Report ideas for new improvements to the SquidDevelopersmailinglist <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/ext_file_userip_acl(8)
Synopsis
ext_file_userip_acl[-dh][-f file name ]
