Note that, to function optimally, the MIRACL Trust portal requires Google Chrome 15+, Internet Explorer 11+, Firefox 46+, Microsoft Edge 11/12.
Also note that the mobile application has a minimum requirement of Android 4.1 and iOS 8.
Before you can begin integrating with the MIRACL Trust authentication services, you must register as a developer in the authentication portal at https://trust.miracl.cloud. To do this, click on the 'Get Started' button on the portal homepage.
Now fill in your details and click 'Submit':
You will then be presented with the login screen. Here, if browser login is enabled, 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:
Whether you choose in-browser or mobile app login, you will be prompted to:
Once logged in, go to 'Apps' and click 'Add a New app'.
Now enter the details for your app:
In the ‘Domain' field, enter the app user's company domain name. MIRACL Trust uses it to find out whether the user is external or internal, which determines pricing later on.
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.
In the demo applications for the SDKs, this is set to be the
appurl/login endpoint. When running the demo app for any of the SDKs, this should be set according to the port which the demo server is listening on. For example, the
server.py script of the Flask demo app contains
app.run(host='0.0.0.0',port=5000), which means the app will be running on
http://127.0.0.1:5000 and therefore the redirect url will be
http://127.0.0.1:5000/login. Likewise, the
sinatra_sample.rb script for the Ruby demo app contains
set :port, 5000, so the redirect url will also be
In both the demo apps and your own bespoke apps, you can of course change these to e.g
set :port, 8888 or whatever port or url you want to use. The key thing is that, in the 'Add New App' screen above you enter the redirect url value which will match the one generated by your server script.
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 ID can then be copied at any time from the app settings screen:
Note that 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!Top