--- title: "Configuring RADIUS authentication using the CLI" slug: "configuring-radius-authentication-using-the-cli-1" tags: ["File Protect (FX)", "Malware Analysis (AX)", "IAM", "Email Security - Cloud", "Network Security (NX)", "Email Security — Server", "Central Management System", "Helix Enterprise", "Endpoint Security (HX)", "Product Usage", "Install and Get Started", "Helix", "Intelligent Virtual Execution "] updated: 2026-09-01T19:03:12Z published: 2026-09-01T19:03:12Z canonical: "docs.trellix.com/configuring-radius-authentication-using-the-cli-1" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # Configuring RADIUS authentication using the CLI This section describes how to configure a RADIUS server to return` Local-User `attributes, and to enable an appliance to authenticate with a RADIUS server. ### Configuring a RADIUS server ### Note Your RADIUS server configuration should follow standard RADIUS protocol. The examples in this section are provided for illustration only. To configure a RADIUS server: 1. Configure a secret key on the authentication server. The same key must be configured on both the server and the appliance. 2. Create a dictionary to reference the following mapping data: ``` VENDOR FireEye 25597 BEGIN-VENDOR FireEye ATTRIBUTE FireEye-Local-User 1 string END-VENDOR FireEye ``` where` Local-User `is the mapping attribute with an index of ` 1 `that matches the ` FireEye `code. 3. Store the dictionary, typically in the` /user/share/radius/dictionary `directory. 4. Use the authentication types shown in the following example to create user authentications against the RADIUS server login credentials, and authentication against “on-the-fly” passwords: ``` Auth-Type := System               FireEye-Local-User = “admin” r-admin    Auth-Type := Local, User-Password == “test123”               FireEye-Local-User = “admin” r-monitor  Auth-Type := Local, User-Password == “test123”               FireEye-Local-User = “monitor” ``` Both` r-admin `and` r-monitor `are authenticated against “on-the-fly” passwords. `Local-User` is the string defined in the dictionary and used by the authentication server to map to the local user. In the example above, both` <username> `and` r-admin `are Admin users on the Trellix appliance, while` r-monitor ` is mapped to the appliance’s Monitor role. 5. Restart the RADIUS server after authentication mappings are modified. For example, enter` service radiusd restart`. ### Important `Auth-Type := System `causes the RADIUS server to use the password file on the server for user passwords. Passwords for users with the Admin or Monitor role must be specified on an individual basis. ### Enabling an appliance to authenticate with a RADIUS server Use the commands in this section to enable an appliance to authenticate with a RADIUS server. ### Important You can configure multiple RADIUS servers on an appliance. The appliance will contact the servers in the order in which they were configured. If the first server in the list is unreachable, the appliance will contact the next server, and so on. ### Note You can configure some RADIUS settings globally, so the settings apply to all new RADIUS servers configured on an appliance and become the new default settings. For example, you could use the` radius-server timeout <seconds> `command to configure the timeout value for all RADIUS servers. To enable RADIUS authentication: 1. Define the server host and server key attributes: ``` hostname # radius-server host key ``` where` ip address `is the IPv4 or IPv6 address of the RADIUS server and` key string `is the secret key configured on the RADIUS server. ### Note Link-local and site-local IPv6 addresses are not supported. 2. By default, the appliance retransmits a request that previously timed out after three seconds. To change the number of seconds: ``` hostname (config) # radius-server host timeout ``` where` seconds `can be 1–60. 3. By default, the appliance attempts to contact the RADIUS server one time before the request fails. To change the number of attempts: ``` hostname (config) # radius-server host retransmit ``` where` number `can be 0–5. 4. By default, the port number for RADIUS authentication is 1812. To change the port number, or to define an additional port for another RADIUS service: ``` hostname (config) # radius-server host auth-port ``` 5. Add RADIUS authentication to the authentication method list in the desired order. For example: ``` hostname (config) # aaa authentication login default local radius ``` 6. Verify your changes: ``` hostname (config) # show radius ``` ### Note A RADIUS server is administratively enabled by default. Use the` radius-server host <ip address> enable `command if you need to re-enable it, or if you want to add a new RADIUS server that is initially disabled. See the *CLI Command Reference* for a complete list of RADIUS server commands and parameters. ### Examples The following example configures a RADIUS server and changes the timeout and retransmit values. ``` hostname (config) # radius-server host 192.168.1.1 key 12345678 hostname (config) # radius-server host 192.168.1.1 timeout 5 hostname (config) # radius-server host 192.168.1.1 retransmit 2 hostname (config) # aaa authentication login default local radius hostname (config) # show radius RADIUS Settings:    Authentication and Authorization are enabled in AAA configuration. RADIUS DEFAULTS:    Key:               ********    Timeout:           3    Retransmit:        1 RADIUS servers:   192.168.1.1:1812      Enabled:          yes      Key:              *********      Timeout:          5      Retransmit:       2   ``` The following example configures three RADIUS servers on the appliance, and then defines global settings for the timeout and retransmit values. ``` hostname (config) # radius-server host 192.168.1.2 key 12345678 hostname (config) # radius-server host fdd3:c75:345::8a4 key 34567890 hostname (config) # radius-server host 192.168.3.4 key 98765432 hostname (config) # aaa authentication login default local radius hostname (config) # radius-server timeout 5 hostname (config) # radius-server retransmit 1 hostname (config) # show radius RADIUS Settings:    Authentication and Authorization are enabled in AAA configuration. RADIUS defaults:    Key:               ********    Timeout:           5    Retransmit:        1 RADIUS servers:    192.168.1.2:1812       Enabled:        yes       Key:            ********       Timeout:        5 (default)       Retransmit:     1 (default)    fdd3:c75:345::8a4:1812       Enabled:        yes       Key:            ********       Timeout:        5 (default)       Retransmit:     1 (default)    192.168.3.4:1812       Enabled:        yes       Key:            ********       Timeout:        5 (default)       Retransmit:     1 (default) ``` :