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.