NAME

       basic_radius_auth - Squid RADIUS authentication helper

SYNOPSIS

       basic_radius_auth -f config file
       basic_radius_auth -h " server name " [-p port ] [-i identifier ] -w secret [-t timeout ]

DESCRIPTION

       basic_radius_auth allows Squid to connect to a RADIUS server to validate the user name and
       password of Basic HTTP authentication.

OPTIONS

       -f configfile
                   Specifies the path to a configuration file. See the CONFIGURATION section  for
                   details on the file content.

       -h server   Alternative method of specifying the server to connect to

       -p port     Specify  another  server  port where the RADIUS server listens for requests if
                   different from the default RADIUS port.  Normally not specified.

       -i identifier
                   Unique identifier identifying this Squid proxy to the RADIUS server.   If  not
                   specified the IP address is used to identify the proxy.

       -w secret   Alternative method of specifying the shared secret. Using the -f option with a
                   configuration file is generally more secure and recommended.

       -t timeout  RADIUS request timeout. Default is 10 seconds.

CONFIGURATION

       The configuration specifies how the helper connects to RADIUS.  The file contains  a  list
       of directives (one per line). Lines beginning with a # are ignored.

       server radiusserver
              specifies the name or address of the RADIUS server to connect to.

       secret somesecretstring
              specifies the shared RADIUS secret.

       identifier nameofserver
              specifies  what  name the proxy should use to identify itself to the RADIUS server.
              This directive is optional.

       port portnumber
              Specifies the port number or service name where the helper should connect.

       timeout seconds
              Specifies the RADIUS request timeout.

AUTHOR

       This program is written by Marc van Selm <selm@cistron.nl>  Henrik  Nordstrom  <hno@squid-
       cache.org>

       With contributions from many others.

       This manual was written by Henrik Nordstrom <hno@squid-cache.org>

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.

       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>

       Or contact your favorite RADIUS list/friend if the question is more related to RADIUS than
       Squid.

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),
       RFC2058 - Remote Authentication Dial In User Service (RADIUS)
       The Squid FAQ wiki https://wiki.squid-cache.org/SquidFaq
       The Squid Configuration Manual http://www.squid-cache.org/Doc/config/

                                          7 August 2004                      basic_radius_auth(8)