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

In the portal, when you create a new app, you will be issued with your Client ID and Client Secret. Note that your Client Secret will only be issued to you once so it must be grabbed when first displayed:

client secret

Client ID can then be copied at any time from the app settings screen:

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. This is explained in the OTP generation page.

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.


MIRACL Trust RADIUS server installation


Contact us at support@miracl.com to provide you with the required installation package. We could provide you with DEB, RPM or Docker image installation.

Docker installation

To get the miracl/radius image that is referenced in the following section, please contact MIRACL.

Environment Variables

The following environment variables are available when using Docker:

  • MIRACLRADIUS_CONFIGPATH - sets the configuration file to start the service with
  • MIRACLRADIUS_LOGLEVEL - sets the Log level to be one of EMERGENCY, ALERT, CRITICAL, ERROR, WARNING, NOTICE, INFO or DEBUG
  • MIRACLRADIUS_DUMP - if set to JSON or YAML, outputs the full configuration, if set to SCHEMA - outputs the JSON schema
docker run --name=radius --network host -v /home/user/miracl-radius-dockertest/:/etc/miracl-radius miracl/radius:latest -c /etc/miracl-radius/config.yaml

Please see the SSH Demo Setup instructions for detailed instructions on getting a Docker container running which can be used to log into a separate ssh terminal.

Configuring the application and hosts

Please see the Generic client setup info and the ssh and OpenVPN demo setup instructions for detailed guidance on configuring the product for use.