UniFi

RADIUS over TLS (RADSEC) has been added to UniFi Network 8.4 and newer versions. Please have your controller and network devices up-to-date before following this guide.

Prepare Certificates

To establish a valid RadSec connection, your Access Points must trust the RADIUS Server Certificate and your RADIUS server must trust your RadSec client certificate.

  1. Create a RadSec client certificate for your Access Points. If you are using SCEPman Certificate Master, the process is described here. In this example we generate a certificate in the format "PEM". Please note down the password, as we need this later.

  2. Split the generated certificate into the private key (named "priv.key" in this example) and the certificate (named "clientcert.cer"). This can be easily done via a text editor:

  3. Add the root certificate of the CA that has issued the RadSec client certificate to your RADIUS instance as described here and select RadSec under Use for. In case the RadSec client certificate has been issued by SCEPman (this example) and you already trust the SCEPman Root CA for client authentication, simply edit the trusted SCEPman Root CA certificate and select Both under Use for:

UniFi Configuration

Below settings are the necessary settings to establish a functional RadSec connection with our service. Configure any other settings at your discretion.

  1. Navigate to your Unifi Network controller and open Settings > Profiles > RADIUS.

  2. Create a new profile or update an existing one:

  3. Fill in the required information:

    1. RADIUS Assigned VLAN Support: optional / if needed

    2. RADIUS Settings:

      1. TLS: Enable the checkbox.

      2. Authentication Servers: - Server IP Address/es: Provide the IP address of your RadSec service endpoint. - Port: 2083. - Shared Secret: radsec.

      3. Client Certificate: Upload the RadSec client certificate (obtained from step 3 here).

      4. Private Key: Upload the private key of your RadSec client certificate (obtained from step 3 here).

      5. Private Key Password: as noted down.

      6. CA Certificate: Upload the Root certificate of the CA that has issued your RADIUS server certificate (obtained from step 1 here).

      7. Accounting: Enable the checkbox.

      8. RADIUS Accounting Server: - Server IP Address/es: Provide the IP address of your RadSec service endpoint. - Port: 2083 - Shared Secret: radsec

      9. Interim Update Interval: optional / if needed

  4. Assign this profile to the desired WiFi profile:

Reference: UniFi Help Center

UniFi Gateway - Configuring a RADIUS Server

Last updated