Setting Up the Radius Server

The HYPR RADIUS server is created to facilitate authentication via the RADIUS protocol. The server software is a Java spring boot microservice that runs on port 9077.

Prerequisites

  1. Acquire a REDHAT or CENTOS 7+ server or virtual machine; port 9077 should be accessible

  2. Acquire RADIUS WAR file from artifactory - 3.6.0 war file location (restricted to HYPR Customer Solutions)

  3. Copy the RADIUS WAR file into the /opt/hypr directory

  4. Acquire and copy the RADIUS shell script called radius.sh and put it into the /opt/hypr directory

  5. Ensure that you have a running VAULT server

  6. Ensure that you have configured a VAULT namespace

  7. Ensure that you have a valid VAULT token

  8. Ensure that you are on HYPR Server 3.7 or higher

Startup Instructions

Follow the below instructions on how to deploy and configure the RADIUS server

  1. Go to the /opt/hypr directory on your server
14161416
  1. Start the RADIUS server by running ./radius.sh on the command line (located in HYPRRadiusServer->run folder)
14161416
  1. Enter the VAULT URL
14161416
  1. Enter the VAULT Token
14161416
  1. Enter the VAULT namespace
14161416
  1. Verify that the startup has completed
14161416
  1. Navigate to http://<your_host>:9077/radius/settings or if you have NGINX or a reverse proxy configured, go to https://<your_host>/radius/settings
14161416
  1. Enter the provided configuration key and move to the "Configuration Settings" instructions below!

Configuration Settings

  1. Set the Local RADIUS Domain to 127.0.0.1 - This is used to verify that the RADIUS server is running properly.
  2. Set the local RADIUS secret for testing the RADIUS server. This should be a String value.
14161416
  1. Set the IP Addresses and the SECRETS of the clients that you expect to connect to this RADIUS server. The RADIUS server can support multiple clients such as VPN, VDI, and SSH PAM modules with individual secret values.
14161416
  1. Set the RADIUS timeout, this should be “60000” which is 60 seconds.
14161416
  1. Set the HYPR Relying Party URL - This should be the URL of your HYPR server that you have been given or deployed yourself.
14161416
  1. Set the HYPR Relying Party App ID - This should be the app you configured in your HYPR FIDO Control Center.

  2. Set the proxy configuration if you require a proxy to communicate from the RADIUS server to the HYPR Server itself.

14161416
  1. Click Submit and Restart to submit the information and restart the RADIUS server. You should see a confirmation message once the server is restarted.
438438

Validating RADIUS Functions

The HYPR RADIUS server comes with a local RADIUS client that is web based and can be used to test the RADIUS server functionality with the configured RP. Follow these instructions to make sure that the RADIUS server is successfully authenticating users.

  1. On your browser, go to the RADIUS server login page at https://<host_url>/radius/login

  2. Put in the username of a previously registered user with the relying party and app ID

14161416
  1. Authenticate on your mobile when you receive the PUSH notification
878878
  1. Notice that the authentication is completed on your browser
13461346

This will confirm that your local RADIUS client is working. This RADIUS client uses the 127.0.0.1 Client IP address that’s configured earlier and the local RADIUS secret as well.

What’s Next?

Next, you should deploy your own RADIUS clients and configure your RADIUS server to work with those clients on the settings screen.