basic\_radius\_auth(8) System Manager's Manual basic\_radius\_auth(8)

# [NAME](#NAME)

basic\_radius\_auth - Squid RADIUS authentication helper

# [SYNOPSIS](#SYNOPSIS)

**basic\_radius\_auth** **-f** config file  
**basic\_radius\_auth** **-h "** server name **" \[-p** port **] \[-i** identifier **] -w** secret **\[-t** timeout **]**

# [DESCRIPTION](#DESCRIPTION)

**basic\_radius\_auth** allows Squid to connect to a RADIUS server to validate the user name and password of Basic HTTP authentication.

# [OPTIONS](#OPTIONS)

[**-f configfile**](#f)

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

[**-h server**](#h)

Alternative method of specifying the server to connect to

[**-p port**](#p)

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

[**-i identifier**](#i)

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

[**-w secret**](#w)

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

[**-t timeout**](#t)

RADIUS request timeout. Default is 10 seconds.

# [CONFIGURATION](#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**](#server)

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

[**secret somesecretstring**](#secret)

specifies the shared RADIUS secret.

[**identifier nameofserver**](#identifier)

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

[**port portnumber**](#port)

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

[**timeout seconds**](#timeout)

Specifies the RADIUS request timeout.

# [AUTHOR](#AUTHOR)

This program is written by *Marc van Selm &lt;selm@cistron.nl&gt;* *Henrik Nordstrom &lt;hno@squid-cache.org&gt;*

With contributions from many others.

This manual was written by *Henrik Nordstrom &lt;hno@squid-cache.org&gt;*

# [COPYRIGHT](#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)

Questions on the usage of this program can be sent to the *Squid Users mailing list* &lt;squid-users@lists.squid-cache.org&gt;

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

# [REPORTING BUGS](#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 &lt;squid-bugs@lists.squid-cache.org&gt;*

Report ideas for new improvements to the *Squid Developers mailing list* &lt;squid-dev@lists.squid-cache.org&gt;

# [SEE ALSO](#SEE_ALSO)

[**squid**(8)](/man/os/squid/squid.8), [**GPL**(7)](/man/os/squid/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

---

Document: basic_radius_auth(8) from squid 7.6-r0 (Chainguard OS)
Source: https://github.com/squid-cache/squid.git
