Create or update TACACS+ remote authentication server configuration

post

http://127.0.0.1:8080/gmsRemoteAuth/TACACS+

Creates a new or updates an existing TACACS+ (Terminal Access Controller Access-Control System Plus) server configuration for remote authentication. If no configuration exists, a new one is created; otherwise, the existing configuration is updated. The action is logged in the system action log.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

TACACS+ server configuration object containing primary server details and optional secondary server for failover.

TACACS+ server configuration object for creating or updating remote authentication settings.

primaryHost

string

required

Hostname or IP address of the primary TACACS+ server. Must be a valid resolvable hostname or IPv4/IPv6 address.

primaryPort

integer

required

1 to 65535

Port number for the primary TACACS+ server. Standard TACACS+ port is 49. In container mode, must be exactly 49.

primaryKey

password

Shared secret key for primary server authentication. Required on first creation; can be omitted on update to keep existing key.

secondaryHost

string

Hostname or IP address of the backup TACACS+ server for failover. Optional; when provided, secondaryPort and secondaryKey become required.

secondaryPort

integer

1 to 65535

Port number for the secondary TACACS+ server. Required when secondaryHost is specified. In container mode, must be exactly 49.

secondaryKey

password

Shared secret key for secondary server authentication. Required when secondaryHost is specified on first configuration; can be omitted on update to keep existing key.

type

string

enum

required

Defaults to PAP

Authentication protocol type. PAP (Password Authentication Protocol) sends passwords in clear text. CHAP (Challenge Handshake Authentication Protocol) uses challenge-response for improved security.

Allowed:

defaultRole

string

Default role assigned to users authenticated via TACACS+ when no role attribute is returned from the server. Common values: network-read, admin.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

text/plain

application/json

200TACACS+ configuration created or updated successfully.

400Bad request due to validation errors in the configuration parameters.

500Internal server error during TACACS+ configuration update.