Get Started

Portal Registration

Before you can begin integrating with the MIRACL Trust authentication services, you must register as a developer in the management portal at https://trust.miracl.cloud/get-started.

Now fill in your details and click ‘Submit’:

register details

You will then be presented with the login screen. Here you can register a new ID and create a PIN code for in-browser authentication. Or you can scan a QR code, either with the MIRACL Trust app if you already have it installed, or with a normal QR reader which will prompt you to download and install the app:

simple qr login

Portal Login

Whether you choose in-browser or mobile app login, you will be prompted to:

  1. Create identity
  2. Confirm your identity (by email activation)
  3. Create a 4-digit PIN
  4. Login

Create App

Once logged in, go to ‘Apps’ and click ‘Add a New app’.

Now enter the details for your app:

add app

In the ‘Domain’ field, enter the app user's company domain name. MIRACL Trust uses this for statistical purposes.

Redirect URL

An absolutely vital point to understand here is that the Redirect URL is the URL which is used to send the user back to your app once authentication has been approved, to enable the final retrieval of user details.

If your app runs locally on http://127.0.0.1:5000, then the redirect URL will have the form of http://127.0.0.1:5000/login, where the login endpoint usually handles the OIDC code exchange for ID and access tokens.

Client ID and Secret

When you create a new app, you will be issued with the Client ID and Client Secret credentials that you need to specify when building your app with the SDK. 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

You can control the Login Methods available (QR Code requires customer usage of the mobile app. While Browser Login enables logging in within the desktop browser, without the mobile app)

Armed with this information you are now ready to continue your integration!

Generate New App Keys

  1. Click on Apps in the main navigation.
    Your apps list is displayed.
    main nav apps

  2. Click on Settings against the required app.
    apps audit

  3. The App Keys & Settings tab is displayed.
    app settings page

  4. Click on the Generate New Keys button.
    A dialog box is displayed asking if you wish to proceed.
    Generate New Keys

  5. Click on the Yes button.

  6. Click on the Show Keys button to display your newly-generated client secret.

Identity management

Identities and verification are setup per company. Identities are shared between different application in the company. In this way your users can have the same identity across all your applications.

If you want your identities separated between testing and production, you should create a different company. In other words, if you want to use a test environment that is different to you live environment, use a different company name. We recommend adding “Sandbox” to your company name for such purposes, for example if you are “ABC Ltd”, use “ABC Ltd Sandbox” as your company name for all your testing.

Notes

  • To function optimally, the MIRACL Trust portal requires Google Chrome 15+, Internet Explorer 11+, Firefox 46+, Microsoft Edge 11 / 12.
  • The mobile application has a minimum requirement of Android 4.1 and iOS 8.