EdgeRouter - Login Authentication Using RADIUS


Readers will learn how to implement RADIUS login authentication and send user authentication requests to a RADIUS server.

 book_25x25.png  Notes & Requirements:

This article is applicable to EdgeOS 1.9.7 + firmware in all EdgeRouter models. Knowledge of the Command Line Interface (CLI) and basic networking knowledge is required. Please see the Related Articles below for more information.


Equipment used in this article:

- EdgeRouter-X (ER-X)

- Windows Server 2016 Network Policy Server (NPS)

Table of Contents

  1. Network Diagram
  2. Steps - RADIUS Client
  3. Steps - RADIUS Server
  4. Steps - Testing & Verification
  5. Related Articles

Network Diagram

Back to Top

The network topology is shown below. Using the RADIUS terminology the server at is the ‘RADIUS Server’ and the EdgeRouter (ER) is the ‘RADIUS Client’.

The following interfaces are in use on the ER:

  1. eth0 (WAN)
  2. eth1 (LAN) -

Steps - RADIUS Client

Back to Top

In this example the EdgeRouter has been pre-configured using the Basic Setup Wizard. For the purposes of this article we will assume that the masquerade rules are in place so that the hosts on the LAN can communicate with hosts on Internet.

The UDP ports relevant to RADIUS are:

  1. UDP 1812 (new port) / UDP 1645 (old port) - RADIUS Authentication
  2. UDP 1813 (new port) / UDP 1646 (old port) - RADIUS Accounting


warning_25x25.png ATTENTION: Make sure you have an existing SSH/HTTPS session or an alternative management method (console if applicable) when making changes to login methods, as you can lock yourself out of the device.


CLI_circle.png CLI STEPS:  Access the command line interface (CLI). You can do this by using the CLI button in the GUI or by using a program such as PuTTY.

1. Enter configuration mode.


2. Create local admin users to use for RADIUS authentication (replace <password> with your desired passphrase).

set system login user user1 level admin
set system login user user1 authentication plaintext-password <password>
set system login user user2 level admin
set system login user user2 authentication plaintext-password <password>

info_i_25x25.png Note: The EdgeMAX platform currently requires that all remote RADIUS users are also present as local administrator accounts on the device. The local username on the ER has to match the remote username defined on the RADIUS server.


The password does not have to match! You can create a local user with a random password and then throw away the password. Afterwards you can connect to the router using the username defined on the RADIUS server with a new password.

3. (Optional) Create a new local admin user to use as a fallback authentication method and delete build-in users (replace <password> with your desired passphrase).

set system login user backupadmin level admin
set system login user backupadmin authentication plaintext-password <password>

After creating a new admin user, login with the new account and delete the build-in users:

delete system login user ubnt

4. Define the location and settings of the Radius Authentication server (replace <secret> with your desired passphrase).

set system login radius-server port 1812 (default)
set system login radius-server secret <secret>
set system login radius-server timeout 5 (default)

Steps - RADIUS Server

Back to Top

The section below (briefly) focuses on configuring the Network Policy and Access Services (NPS) role on a Windows 2016 server. There are multiple guides available online that go into more detail than this article.

1. Add the NPS role.

Server Manager > Add Roles and Features > Network Policy and Access Services

2. Add the EdgeRouter to the RADIUS clients (replace <secret> with your desired passphrase).

Network Policy Server Console (NPS) > Radius Clients and Servers > Radius Clients > New

Friendly Name: ER-X (does not have to match device hostname)
Address (IP or DNS): (the source address of the router)
Shared Secrets Template: None
Shared Secret: Manual
Shared Secret / Confirm: <secret>
info_i_25x25.png Note: You can also create a ‘RADIUS Shared Secret Template’ and use the same passphrase for all RADIUS Clients.

3. Create a Network Policy for the RADIUS clients.

NPS > Policies > Network Policy > New

Policy Name: ER Radius Clients
Type of Network Access Server: Unspecified

Specify Conditions > Add

Client Friendly Name: ER-?
User Groups: UBNT\Network Engineers
info_i_25x25.png Note: You can use Active Directory (AD) or local users (Windows Group) for authentication. In this example the users allowed to authenticate to the ER are ‘Network Engineers’ in the UBNT domain. You can use expressions when matching the ‘Client Friendly Name’. For example 'ER-?' matches device names starting with 'ER-'.

Next > Specify Access Permission

Access Granted

Next > Configure Authentication Methods

Uncheck all methods and check ‘Unencrypted Authentication (PAP, SPAP)’

Next > Configure Constraints > Next > Configure Settings > Radius Attributes: Standard

Select Framed-Protocol > Remove
Select Service-Type > Edit > Others > Login

Steps - Testing & Verification

Back to Top

After completing the configuration, verify the workings of RADIUS using the following commands and output on the RADIUS Server:

1. The incoming and outgoing requests on the defined UDP port (1812):

sudo tcpdump -i eth1 -n udp port 1812
IP > RADIUS, Access-Request (1), id: 0x17 length: 76
IP > RADIUS, Access-Accept (2), id: 0x17 length: 72

IP > RADIUS, Access-Request (1), id: 0x0f length: 90
IP > RADIUS, Access-Reject (3), id: 0x0f length: 20

2. The event logs on the Radius server:

Event Viewer > Custom Views > ServerRoles > Network Policy and Access Services

info_i_25x25.png Note: In the two examples above, the first request was made when user1 was also configured locally on the ER. After deleting the user account on the ER, the NPS server receives a security ID containing ‘NULL SID’ and the authentication fails.

Related Articles

Back to Top

EdgeSwitch - How to Enable Routing Mode

EdgeRouter - How do I enable HTTPS / SSH management access modes on EdgeSwitch?