ID.me is an identity-verification provider: it does not just authenticate a person, it attests to a verified group — military, student, teacher, first responder. Products that gate discounts or benefits on those groups use it as both sign-in and proof.
Copy the redirect URI
In the Authdog console, select the project and environment, open Authentication > Providers, find ID.me, and click Enable. Copy the redirect URI shown in the form:
https://identity.authdog.com/api/v1/callback/<connectionId>Create the application
- Open the ID.me developer portal and create an application.
- Fill in the name and the policies your product requires.
- Under Redirect URI, paste the redirect URI from Authdog.
- Copy the Client ID and Client Secret.
Configure Authdog
| Field | Value |
|---|---|
| Client ID | The client identifier from the provider |
| Client Secret | The client secret from the provider |
Save, then toggle the connection active.
What ID.me returns
Authdog requests the openid profile email scopes and reads the profile from https://api.id.me/api/public/v3/userinfo.
The userinfo endpoint returns the sub identifier, email, and name, plus verification attributes for the groups the user has proven.
Verification status is a claim about the person at a point in time. Re-check it rather than caching it forever if your entitlement depends on it.
Test it
- Open your environment's hosted sign-in page, or link to
https://identity.authdog.com/api/v1/signin/<connectionId>. - Select the ID.me button and complete the flow.
- Confirm the user appears under Users in the console with a ID.me identity linked.
Troubleshooting
| Symptom | Cause |
|---|---|
invalid_scope |
The application is not approved for the requested policy |
| Redirect or callback URL error | The URI registered with the provider does not match Authdog's exactly |
| Works in one environment only | Each environment has its own connectionId, and so its own redirect URI to register |
Related
| Read | To learn how to |
|---|---|
| Connectors | Set up any other social provider |
| ID.me Community | Request the community verification scope |