radsecproxy - a generic RADIUS proxy that provides both RADIUS UDP and TCP/TLS (RadSec) transport.
Contents
Description
radsecproxy is a genericRADIUSproxy that in addition to to usual RADIUSUDP transport, also supports
TLS(RadSec). The aim is for the proxy to have sufficient features to be flexible, while at the same time
to be small, efficient and easy to configure.
The proxy was initially made to be able to deploy RadSec (RADIUS over TLS) so that all RADIUS
communication across network links could be done using TLS, without modifying existing RADIUS software.
This can be done by running this proxy on the same host as an existing RADIUS server or client, and
configure the existing client/server to talk to localhost (the proxy) rather than other clients and
servers directly.
There are however other situations where a RADIUS proxy might be useful. Some people deploy RADIUS
topologies where they want to route RADIUS messages to the right server. The nodes that do purely routing
could be using a proxy. Some people may also wish to deploy a proxy on a site boundary. Since the proxy
supportsbothIPv4andIPv6, it could also be used to allow communication in cases where some RADIUS
nodes use only IPv4 and some only IPv6.
Files
/etc/radsecproxy.conf
The default configuration file.
Name
radsecproxy - a generic RADIUS proxy that provides both RADIUS UDP and TCP/TLS (RadSec) transport.
Options
-f Run in foreground.
By specifying this option, the proxy will run in foreground mode. That is, it won't detach. Also
all logging will be done to stderr.
-ddebuglevel
This specifies the debug level. It must be set to 1, 2, 3, 4 or 5, where 1 logs only serious
errors, and 5 logs everything. The default is 2 which logs errors, warnings and a few
informational messages.
-p Pretend
The proxy reads configuration files and performs initialisation as usual, but exits prior to
creating any sockets. It will return different exit codes depending on whether the configuration
files are okay. This may be used to verify configuration files, and can be done while another
instance is running.
-v Print version and exit.
-cconfigfile
This option allows you to specify which config file to use. This is useful if you want to use a
config file that is not in any of the default locations.
-ipidfile
This option tells the proxy to create a PID file with the specified path.
See Also
radsecproxy.conf(5), radsecproxy-hash(8) radsecproxy 1.11.2 2025-03-29 radsecproxy(8)
Signals
The proxy generally exits on all signals. The exceptions are listed below.
SIGHUP
When logging to a file, this signal forces a reopen of the log file.
When using TLS or DTLS, reload certificate CRLs.
SIGPIPE
This signal is ignored.
Synopsis
radsecproxy [-c configfile] [-d debuglevel] [-f] [-i pidfile] [-p] [-v]
