Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
ext_file_userip_acl(8)	     System Manager's Manual	  ext_file_userip_acl(8)

NAME
     ext_file_userip_acl  - Restrict users to certain IP addresses, using a text
     file backend.

     Version 1.0

SYNOPSIS
     ext_file_userip_acl [-dh] [-f file name ]

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.

OPTIONS
     -d 	 Write debug info to stderr.

     -f file	 Configuration file to load.

     -h 	 Display the binary help and  command  line  syntax  info  using
		 stderr.

CONFIGURATION
     The squid.conf configuration for the external ACL should be:
	    external_acl_type type-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  authenti-
     cate".

AUTHOR
     This program was written by Rodrigo Campos <rodrigo@geekbunker.org>

     This  manual  was	written  by Rodrigo Campos <rodrigo@geekbunker.org> Amos
     Jeffries <amosjeffries@squid-cache.org>

COPYRIGHT
      * Copyright (C) 1996-2026 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 mail-
     ing 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/

							  ext_file_userip_acl(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ext_file_userip_acl&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>

home | help