All servers in this configuration share one Server Name on the login screen. Each login starts at the primary. If it times out or the appliance cannot reach it, the appliance tries the enabled backups in order. A rejected password ends the attempt. The next login starts at the primary again.
Configure the primary
- Sign in as a local administrator and open System Settings → TACACS+ Server. Keep a local administrator session available while testing.
- Turn on Enable TACACS+ Authorization and enter Server Name, for example
corp_tacacs. To add redundancy to an existing domain, keep its current name. - Enter the primary address and service port (TCP 49). Enter Key to TACACS+ Server for the primary and select Default User Group. The appliance assigns this local group after TACACS+ authenticates the user. Existing configurations may also contain Service and Attr. Name for User Group ID.
Add and test backup servers
- Under Backup Servers, select Add backup server. Enter the backup address and confirm its port. A new backup is enabled and starts with the primary’s port. Enter the shared key configured for this appliance on that TACACS+ server.
- Add any additional backups. Backup 1 is the first choice after the primary. Use Move up or Move down to change the order. Turn off Enable backup 1 to skip that entry while retaining its settings and position. Remove deletes the selected backup.
- Under Auth. Server Test, enter a test username and password, then select Test and Apply. With the domain enabled, the appliance tests the primary and each enabled backup independently. It saves the settings when every tested endpoint accepts the credentials. Test credentials are used once and are cleared afterward. Leave the test username empty to save without a login test.
- Open a fresh login session, select the same Server Name, and sign in. A username that begins with a digit and contains a dot, such as
9ops.infra, is entered exactly as it appears on the authentication server.
Configure from the CLI
This example sets 192.0.2.10 as primary and 192.0.2.11 as the first backup. Replace the key placeholders with the secrets for the respective servers and <local-group> with an existing appliance group.
config system auth tacacs enable true name corp_tacacs ip 192.0.2.10 port 49 key <primary-key> default_group <local-group>
config system auth tacacs backup 1 ip 192.0.2.11 port 49 key <backup-key> enable true
show system auth tacacs
show system auth tacacs backup
Use the next consecutive position to add a backup. Editing an existing position preserves omitted fields. For example, to pause and later re-enable backup 1 during maintenance, run the first command before maintenance and the second afterward.
config system auth tacacs backup 1 enable false
config system auth tacacs backup 1 enable true
| Task | Command |
|---|---|
| List domain settings and available fields | config system auth tacacs ? |
| List the available backup fields | config system auth tacacs backup 1 ? |
| Change only the first backup’s address | config system auth tacacs backup 1 ip 192.0.2.12 |
| Move an existing second backup ahead of the first | config system auth tacacs backup 2 move 1 |
| Remove the backup currently in position 2 | config system auth tacacs backup 2 remove |
| Disable the whole login domain and retain its settings | config system auth tacacs enable false |
Moving or removing an entry renumbers the list. Check show system auth tacacs backup before making another numbered edit. Before changing an endpoint, record its address, port, and position. Keep its shared key available separately. The CLI reports whether a key is configured and masks its value.
Field reference
| CLI Field | UI Field | Type Or Values | Notes |
|---|---|---|---|
enable |
Enable TACACS+ Authorization | Boolean | Enables or disables TACACS+ authentication. |
name |
Server Name | String | Domain name users select at login. |
ip |
Server IP Address | IP address or host string | TACACS+ server address. |
port |
TACACS+ Auth. Service Port | Integer from 1 to 65535 |
Common TACACS+ authentication port is 49. |
key |
Key to TACACS+ Server | String | Shared secret used with the TACACS+ server. |
service |
Service | String | Requested TACACS+ service value. |
gid_attr |
Attr. Name for User Group ID | String | Legacy authorization attribute. |
default_group |
Default User Group | Existing local user group | Local group assigned to TACACS+ users at sign-in. |
backup |
Backup Servers | Ordered list | Numbered from 1 in failover order. |
test_username |
Username for Test (Empty to skip) | String | Used only for this test. |
test_password |
Password for Test User | Password string | Used only for this test. |
Troubleshooting
- An endpoint fails Test and Apply. Check the address and port reported for that endpoint. Verify that the server recognizes the appliance as a client and that its shared key matches the key configured for that endpoint.
- A login stops at the primary. Check whether the primary rejected the credentials. Failover handles connection failures and timeouts. All enabled endpoints share a ten-second login deadline.
- Login succeeds with unexpected permissions. Check the permissions of the selected Default User Group on the appliance.