Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

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(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
       authenticate".

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-2021 The Squid Software Foundation and  contribu-
       tors
        *
        * 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@lists.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@lists.squid-
       cache.org>

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


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | web/proxy/squid  |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+

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/



NOTES
       Source  code  for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source    was    downloaded    from     http://www.squid-cache.org/Ver-
       sions/v4/squid-4.15.tar.xz.

       Further information about this software can be found on the open source
       community website at http://www.squid-cache.org/.



                                                        ext_file_userip_acl(8)