Before you begin, you must register on MIRACL Trust.
# Create an Application
Once you register, you can proceed to create an application to use for integration within the MIRACL Trust platform.
-
After you log in, go to your project.
-
Select Applications on the sidebar.
-
Click + Add App.
-
Enter the details for your app:
- App Type
- App Name
- Redirect URL (only for OIDC) - the URL which sends 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 ishttp://127.0.0.1:5000/login
, where thelogin
endpoint usually handles the OIDC code exchange for ID and access tokens.
-
Click Add App. Your app keys (Client ID and Client Secret) are displayed.
# Client ID and Client Secret
When you create an app, you are issued Client ID and Client Secret credentials. You need them when building your app to configure your OpenID Connect integration. The Client Secret is shown to you only once when you create the app, so make sure you copy and save it when first displayed.
To see the Client ID and Project ID, go to the app’s settings:
-
Click Applications on the sidebar. A list of your apps is displayed.
-
Click Settings next to the app you are interested in.
# Generate New Client ID and Client Secret
If you haven’t saved your app’s Client Secret, you can generate new app keys:
-
Go to the app’s settings (as described above).
-
Click the Generate New Keys button in the Danger Zone section. A dialog box is displayed asking if you wish to proceed.
-
Click Yes.
-
Copy the newly generated Client Secret either by using the copy button at the end of the field or by selecting and copying it manually.
Once you generate new keys, the old ones are invalidated.
# Next Steps
Now that you have registered on the MIRACL Trust Portal and created an app, you can integrate through OIDC, integrate with mobile apps, or add custom user verification.