Setup and Installation


Table of Contents:

1. Create a RADIUS app in the portal
2. RADIUS Server Installation
| ---- DEB Installation
| ---- RPM Installation


Create a RADIUS app in the portal


First log into the MIRACL Trust® authentication portal, click on the 'Apps' link in the dashboard and create a new RADIUS app:

add app

Once you create the app, clicking on 'Show Keys' will display the Client ID and Client Secret which are needed for your config.json file for your MIRACL Trust® SSO RADIUS server. Note also that you can configure the login methods to specify whether your users can generate One Time Passwords directly in their desktop browser, in the mobile app (QR Code), or both:

app settings page

Any end users wishing to make use of your RADIUS app must visit the OTP url displayed in the Registration Link above. Here, in-browser or using the mobile app (by scanning the displayed QR code), they will be able to register with an email address and set up a PIN:

otp create id and create pin

If using in-browser OTP, users should bookmark the OTP url and they can then visit it at any time to enter their PIN and generate OTPs for all configured services. Mobile app users can simply use the 'Generate OTP' tab in their mobile app:

otp create id and create pin


MIRACL Trust® RADIUS server installation


DEB installation

Redis is a dependency, so first:

sudo apt-get update && sudo apt-get install redis-server

You can then install via the following commands when logged in as root:

wget -qO - http://repo.miracl.com/build-team-public.asc | apt-key add --
Create a new file /etc/apt/sources.list.d/miracl.list and add the following:
deb http://repo.miracl.com/apt/ubuntu all main
Save and close the file, then continue with the commands:
sudo apt-get update
sudo apt-get install miracl-srv-radius

RPM installation

First, the EPEL repositories need to be enabled, so:

sudo yum install epel-release

Redis is a dependency, so first:

sudo yum install redis

You can now install via the following:

Create a new repo file: /etc/yum.repos.d/miracl-rpm.repo

Then add the following:

[miracl]
name= Latest Release for RHEL/Centos 7Server
baseurl=http://repo.miracl.com/yum/redhat/7Server
gpgkey=http://repo.miracl.com/build-team-public.asc
enabled=1
gpgcheck=1

Save and close the file.

During initial install of any package from this repo, you will be asked to accept the key.

sudo yum update

Finally, install with:

sudo yum install miracl-srv-radius

Running the service

Once your server is installed it can be started and stopped with the following commands:

sudo service srv-radius start
sudo service srv-radius stop
sudo service srv-radius restart

Top