Auth0
This guide serves as a configuration lab that provides the ID.me customers with the steps to configure ID.me on the Auth0 platform. This guide will provide an overview of:
- How to obtain an Auth0 tenant
- How to configure ID.me as an Social Login within Auth0
- Specific nuances within the Auth0 Platform
Step 1: Create an Auth0 Developer Account
Navigate to Auth0 and Sign Up
![](/images/documentation/auth0-signin.png)
Enter your Email and Password
Select and enter Company name
Click Next and wait for your tenant to be created
Step 2: Configure your ID.me Identity Social Login
Navigate to Authentication -> Social
![](/images/documentation/auth0-step2a.png)
Select Creation Connection
![](/images/documentation/auth0-step2b.png)
Enter ID.me in the Search
Select ID.me (Identity) and select Continue
![](/images/documentation/auth0-step2c.png)
Enter your own ID.me Client ID & Client Secret
![](/images/documentation/auth0-step2d.png)
Select OpenID & the Identity Policy you want to test with
Select Create
We will assign this Policy to an Auth0 Application at a later step
Step 3: Configure your ID.me Community Social Login
Navigate to Authentication -> Social
![](/images/documentation/auth0-step2a.png)
Select Creation Connection
![](/images/documentation/auth0-step2b.png)
Enter ID.me in the Search
Select ID.me (Community) and select Continue
![](/images/documentation/auth0-step2c.png)
Enter your own ID.me Production Client ID & Client Secret
![](/images/documentation/auth0-step2d.png)
Select OpenID & the Identity Policy you want to test with
![](/images/documentation/auth0-step3e.png)
Select Create
We will assign this Policy to an Auth0 Application at a later step
Step 4: Configure an Auth0 Application
Navigate to Applications -> Applications
![](/images/documentation/auth0-step4a.png)
Select Create Application
![](/images/documentation/auth0-step4b.png)
Select Regular Web applications
Click Create
![](/images/documentation/auth0-step4c.png)
Select Next.js
![](/images/documentation/auth0-step4d.png)
Select Download Sample
Take note of the steps here, we will need to configure our ID.me accounts with the Redirect URI provided in this step. We will also need to insall Node.JS LTS using the steps provided.
![](/images/documentation/auth0-step4e.png)
Select Download
![](/images/documentation/auth0-step4f.png)
Navigate to the Settings tab
![](/images/documentation/auth0-step4g.png)
Enter the Callback URL
Under Allowed Callback URLs, enter the Callback URL that was displayed in the previous step
![](/images/documentation/auth0-step4h.png)
Add http://localhost:3000/ under Allowed Logout URLs
Under Allowed Callback URLs, enter the Callback URL that was displayed in the previous step
![](/images/documentation/auth0-step4i.png)
Select Save Changes
Extract the downloaded nextjs-01-login directory
![](/images/documentation/auth0-step4j.png)
Open nextjs-01-login directory in your favorite IDE
![](/images/documentation/auth0-step4k.png)
Within the nextjs-01-login directory, select sample-01 directory
![](/images/documentation/auth0-step4l.png)
Open your Terminal
Ensure Node.js is installed: https://nodejs.org/en/download
Navigate to sample-01 directory and install dependencies
In Terminal, run npm install
![](/images/documentation/auth0-step4l.png)
Successful install dependencies
![](/images/documentation/auth0-step4m.png)
Start your application
In Terminal, run npm start
![](/images/documentation/auth0-step4n.png)
Run your application locally
In Terminal, run npm run dev
![](/images/documentation/auth0-step4o.png)
Open a browser tab and navigate to: http://localhost:3000
Select Log In
You should see the Auth0 Email / Password page appear
![](/images/documentation/auth0-step4p.png)
Auth0 Email / Password page should appear
![](/images/documentation/auth0-step4q.png)
On the Auth0 Developer Portal, navigate to Authentication -> Social
We now have to assign the Social Login to the application
Select your ID.me Identity Social Login
![](/images/documentation/auth0-step4r.png)
Navigate to Applications
![](/images/documentation/auth0-step4s.png)
Turn on the Social Login for your new Application
![](/images/documentation/auth0-step4t.png)
Repeat the same steps for the Community Verification Social Login
Step 5: Test Auth0 <> ID.me Social Login
Navigate back to the Auth0 Login Page
Refresh the Page, you should see the ID.me Social Login options
![](/images/documentation/auth0-step5a.png)
Click Continue with ID.me (Community)
If you received a Redirect URI error, make sure to add the Redirect URI to admin!
Sign into your ID.me account
Select Accept to authorize app
![](/images/documentation/auth0-step5b.png)
You should be redirected to localhost and logged in
![](/images/documentation/auth0-step5c.png)
On the Auth0 Developer Portal, navigate to User Management -> Users
![](/images/documentation/auth0-step5d.png)
Select your new user
Scroll down and notice the ID.me mapped attributes tied to the account such as group, uuid, etc.
![](/images/documentation/auth0-step5e.png)
Useful Links
Authentication & Identity Verification
Enables organizations to easily define pre-configured identity verification policies to verify users’ identities at the exact level of trust required to access a requested service. No more, no less. ID.me’s solution orchestrates multiple verification methods at each level of trust to ensure that all of your users are able to easily and securely prove their identity online.
Community Verification
Offers a comprehensive and easy-to-deploy progressive community verification solution to fit your business needs and risk tolerance. Through this integration, you can successfully verify a user's eligibility for the following groups: Military, Students, Teachers, First Responders, Health Care Providers, Company Employees, Government Employees, Alumni, and more; to offer gated access or discounts to your customers.
Post Login Action
The post-login integration is for both identity proofing and community verification. This can be configured within your existing Auth0 flows to trigger verification appropriate to your use cases.