Radiator Server Documentation — v10.34.2

tacacs_plus

Defines a named TACACS+ server. Configure one listen block and at least one of clients or @pre_client.

servers {
    tacacs_plus "TACACS" {
        listen {
            protocol tcp;
            port 49;
            ip 0.0.0.0;
            timeout 20s;
        }
        clients "TACACS_DEVICES";
        session_timeout 15m;
        max_packet_size 4096;
        protocol_error_reply true;
        obfuscation client;
        policy "POLICY_TACACS_PLUS";
    }
}

Parameters

ParameterRequiredDescription
listenYesConfigures a TCP or TLS listener. TACACS+ does not support UDP.
clientsConditionalReferences a static TACACS+ client list.
@pre_clientConditionalSelects clients dynamically before static matching.
session_timeoutNoSets the built-in authorization session lifetime. Default: 15m.
max_packet_sizeNoSets the accepted and outgoing frame limit in bytes. Default: 4096; range: 12 to 65536.
protocol_error_replyNoSends a TACACS+ ERROR reply before closing for protocol errors. Default: true.
obfuscationNoSelects client or disabled. Default: client.
policyNoRoutes requests to a named AAA policy.
captureNoSelects a packet capture configuration.
statisticsNoEnables local history. Usually leave unset.
failure_retry_intervalNoSets the delay before retrying failed server startup. Default: 30s.

Listen

Use protocol tcp; with port 49 for standard TACACS+. Add a tls block and use port 300 for TACACS+ over TLS. Configure the listener with these references:

Client Matching

Use clients with a tacacs_plus client list, @pre_client, or both. When both are configured, Radiator tries @pre_client first and uses the static list as a fallback.

Session Timeout

session_timeout controls how long successful authentication state remains available to built-in TACACS+ authorization. It accepts standard duration units. The default is 15m.

Maximum Packet Size

max_packet_size limits incoming and outgoing TACACS+ frames. The value is an integer number of bytes from 12 through 65536. The default is 4096.

Protocol Error Replies

protocol_error_reply true; sends an ERROR response for a recognized packet type, or a header-only reply for an unknown packet type, before closing the connection. Set it to false only when the client cannot process protocol error replies.

Obfuscation

obfuscation client; uses the matched client's shared secret to determine whether packet bodies must be obfuscated. obfuscation disabled; always uses unobfuscated packet bodies and ignores client secrets.

See TACACS+ client secrets and obfuscation for the client-side requirements.

TLS

Add a tls block to the TCP listener for TACACS+ over TLS. Use client source matching when TCP and TLS connections from the same address need different client settings.