Version 2021
Switch to the Badge app to authenticate
Provides a mechanism for users of your third-party mobile app to initiate authentication with Badge. This API call causes your third-party app to open the Badge app to verify the user's identity.
Add a link or button to your mobile app that users can tap to initiate the authentication with Badge. For example, add a Log in with Badge link. The link opens the Badge app on the user's smartphone. Usher authenticates the user, then redirects the user back to your third-party mobile app. The user is now logged in to your third-party app.
Request format
Deep link URI
uniusher://authorize?
redirect_uri
=$redirect_uri&client_id
=$client_id&org_id
=$org_id
Parameters
Parameter | Required? | Description |
redirect_uri |
Required |
The URL used to reopen (callback) the third-party mobile app that initiated the authorization request. |
client_id |
Required | The Badge Application ID associated with this mobile app. This value is provided in Identity Manager when you register the third-party mobile app. |
org_id |
Required | The Organization ID of the Badge network associated with this mobile app. This value is provided in Identity Manager when you register the third-party mobile app. The Badge app uses this value to determine which badge to use to authenticate the user. |