---
name: "basic_radius_auth"
section: "8"
platform: "linux"
package: "squid"
version: "7.7-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/basic_radius_auth"
---

# basic\_radius\_auth(8)

Squid RADIUS authentication helper

## 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-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 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)](/squid/8.md),  **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/