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 → RADIUS Server. Keep a local administrator session available while testing.
- Turn on Enable RADIUS Authorization and enter Server Name, for example
corp_radius. To add redundancy to an existing domain, keep its current name. - Enter the primary address and service port (UDP 1812). Enter Key to RADIUS Server for the primary and select Default User Group. RADIUS verifies the password. The selected local group determines the user's permissions.
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 RADIUS 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 radius enable true name corp_radius ip 192.0.2.10 port 1812 key <primary-key> default_group <local-group>
config system auth radius backup 1 ip 192.0.2.11 port 1812 key <backup-key> enable true
show system auth radius
show system auth radius 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 radius backup 1 enable false
config system auth radius backup 1 enable true
| Task | Command |
|---|---|
| List domain settings and available fields | config system auth radius ? |
| List the available backup fields | config system auth radius backup 1 ? |
| Change only the first backup’s address | config system auth radius backup 1 ip 192.0.2.12 |
| Move an existing second backup ahead of the first | config system auth radius backup 2 move 1 |
| Remove the backup currently in position 2 | config system auth radius backup 2 remove |
| Disable the whole login domain and retain its settings | config system auth radius enable false |
Moving or removing an entry renumbers the list. Check show system auth radius 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 RADIUS Authorization | Boolean | Enables or disables RADIUS authentication. |
name |
Server Name | String | Domain name users select at login. |
ip |
Server IP Address | IP address or host string | RADIUS server address. |
port |
RADIUS Auth. Service Port | Integer from 1 to 65535 |
Common RADIUS authentication port is 1812. |
key |
Key to RADIUS Server | String | Shared secret used with the RADIUS server. |
default_group |
Default User Group | Existing local user group | Local authorization group assigned to RADIUS users. |
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.