carta
basic_radius_auth(8)

basic_radius_auth8

Squid radius authentication helper

Usage

basic_radius_auth -f config file

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

Overview

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.

Questions

Questions on the usage of this program can be sent to the Squid Users mailing list <[email protected]>

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

History

  • Arch Linux 2026-11-01: the text shown here
  • Debian 13 (Trixie)
  • Debian 12 (Bookworm)
  • Debian 11 (Bullseye)
  • Debian 10 (Buster)
  • Debian 9 (Stretch)
  • Debian 8 (Jessie)

Author

This program is written by Marc van Selm <[email protected]> Henrik Nordstrom <[email protected]>

With contributions from many others.

This manual was written by Henrik Nordstrom <[email protected]>

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 <[email protected]>

Report ideas for new improvements to the Squid Developers mailing list <[email protected]>

From squid 7.7-1 in Arch Linux 2026-11-01. Parsed by carta from the page's roff source.