Skip to main content

Tutorial: Integrate Okta with Access Server via RADIUS


RADIUS can be used to configure Access Server to authenticate against Okta. RADIUS supports MFA, which LDAP doesn't.


RADIUS can be used to configure Access Server to authenticate against Okta. RADIUS supports Multi-Factor Authentication (MFA), which is not supported by LDAP. That’s one of the benefits of a longer setup.

The following pieces will make up the RADIUS integration between Okta and Access Server:

  • Okta RADIUS app.

  • Okta RADIUS agent.

  • Access Server.

  • Okta directory.

  • Okta directory.

  • Installed Access Server.

You’ll need to add a RADIUS app to your Okta Admin Console. The RADIUS port and shared secret must pass through the Console to connect a RADIUS agent with the VPN.


Okta RADIUS only supports PAP-based authentication, which Access Server supports.

  1. From your Okta Admin Console, click on Applications > Applications.

  2. Click on Add Application, then search for RADIUS.

  3. From the search results, choose RADIUS App and click on Add.

  4. After creating the app, you need to configure it starting with the Sign on tab:

    1. Authentication: Leave this as default.

    2. UDP Port: 1812.

    3. Secret Key: Enter the secret key that will be used to encrypt and decrypt the user password. It will be identical to what is configured in Access Server.

    4. Application username format: Select from the drop-down how the RADIUS client sends the username.

    5. Password Reveal: Check if you want your users to see their password securely.

  5. The final step is to add users to the app. All Users or Groups here will have access to Access Server's Client Web UI using their Okta credentials.

You can install the agent on a Windows Server or request the Linux agent from Okta, which is considered Early Access. The steps for the Windows Server are first followed by the Linux agent.

Install Okta RADIUS agent on a Windows server

  1. From your Okta Administrator Dashboard, select Settings > Downloads, then scroll down to the Okta RADIUS Server Agent and click Download Latest.

  2. Run the downloaded file to install the agent on your Windows Server.

  3. Choose whether to define specifics or use a direct connection for the proxy information.

  4. Enter your Okta org ID for the subdomain.

  5. Sign on with Okta admin credentials.

  6. Click the Allow Access button.

  7. The RADIUS agent completes the installation.

  8. Click Finish to complete the RADIUS agent installation on Windows Server.

  9. Next, open your Windows Defender Firewall with Advanced Security and click on New Rule.

  10. Select Port.

  11. Select the UDP protocol, enter your port number, and click Next.

  12. Select Allow the connection.

  13. Set the Profile for your network needs, enter a name, and click Finish.


Install Okta RADIUS agent on Linux

Installing the Okta RADIUS agent on Linux requires contacting Okta Support. It’s considered an early access feature, so you’ll need to request that it be added to your downloads.

  1. After Support has added the Linux agent for you, sign in to your Okta admin panel.

  2. Click Settings > Downloads.

  3. Select the link next to your Linux OS's Okta RADIUS Server Agent.

  4. Upload the file to your Linux server.

  5. Validate the download by entering the following command to generate the hash on your local machine. (Ensure you replace 'setup' with the file path to your downloaded file.)

  6. Verify that the generated hash matches the hash in your Okta Admin Console on the Downloads page.

  7. Install the agent using the appropriate command for your Linux OS. (Ensure you have root privileges.)

    rpm -Uvh OktaRadiusSetupRPM-{version#}.rpm
    apt install /${PATH_TO_FILE}/OktaRadiusAgentSetup-{version#}.deb
  8. You'll be prompted to enter your base URL for Okta during installation. Example:

  9. After that, you’ll be prompted to authenticate with your Okta tenant. Copy the URL into a web browser.

  10. In the browser, click Allow Access.

    • The Linux terminal will display a message that the installation is complete.


For more detailed information about the agent, refer to Okta’s Linux RADIUS agent documentation.

Now you’ll configure Access Server to use Okta for credentials via RADIUS.

  1. Sign in to the Admin Web UI.

  2. Click Authentication > RADIUS.

  3. Enter your RADIUS authentication details. The four following details are required; the other fields are optional.

    Table 1. 

    RADIUS Setting


    Hostname or IP Address

    Enter the hostname or IP address of your Okta RADIUS agent's server.

    Shared Secret

    Enter the shared secret from the Okta RADIUS app.

    Authentication Port

    Enter the port in the Okta RADIUS app (likely the default port, 1812).

    RADIUS Authentication Method

    Set PAP to Yes.

  4. Click Enable RADIUS Authentication under RADIUS Settings.

  5. Access Server now uses Okta for authentication.

Your users can sign in to the Client Web UI using their Okta credentials. You can also include the MFA setup in the Okta admin panel.

  1. The user goes to the Client Web UI in their browser, enters credentials, and clicks Sign In.

  2. (Optional) The user may see an MFA prompt based on the Okta setup.

  3. After successful authentication, the user can choose to download OpenVPN Connect or a connection profile.

MFA is not set up in Okta admin panel

If you encounter an error message, Access denied, or invalid creds, it may be that you haven’t completed the multifactor configuration in the security section of your Okta admin panel. Also, if you check the logging in your RADIUS app, you’ll see the error message, “User does not have a valid factor enrolled.”

This is because the RADIUS app has a requirement to use multifactor through a default sign-on rule:


To resolve the error, you can either set up Multifactor for users or create a new sign-on rule with a higher priority.

Set up Okta multifactor

  1. In your Okta admin panel, go to Security > Multifactor.

  2. Set up and configure the MFA factor of your choice.


Create a rule that doesn't require MFA to sign in

  1. From your RADIUS application's Sign On tab, scroll to the bottom and click Add Rule.

  2. Enter the new rule without the multifactor box checked and click Save.

  3. Ensure your new rule is a higher priority than the default rule, and your users will no longer be prompted for additional authorization.

MFA causes user lockout in Access Server

If your user receives a ‘LOCKOUT’ error message when attempting to sign in, it may be due to the steps it takes to enroll in MFA through their Client Web UI. This is caused by Access Server's lockout policy. Refer to Authentication failure lockout policy for the default values and how to adjust settings. The steps below show you the error as received by the user.

If the user hasn't enrolled in MFA yet, when they first sign in, they will be prompted:

  1. After entering their credentials, they receive the MFA prompt.

  2. After enrolling, they are asked for a phone number.

  3. Once entering their phone number, they must then enter the code sent to their phone.

  4. They then receive a LOCKOUT message.

This happens because the challenges are seen as login attempts from Access Server. If you review your logs in the Admin Web UI, you'll see those.


If the user waits 15 minutes, they can sign in again. They will then only go through the credentials authentication step and one MFA step.