Database Integration: Auth0

The following article details: 

• How to Connect Your Auth0 Account
• How to Connect Your Authorization Code Grant - OAuth Support

To integrate Auth0, follow the steps below between the MAZ dashboard and your Auth0 dashboard. You will create an application in Auth0 and copy specific fields into the MAZ dashboard. Navigate to Users > Database Integrations and then select Setup next to Auth0, to lead to the following screen:

Access Database Name

Log into your Auth0 account. Select the avatar on the top right, and then Settings.

Scroll down to API Authorization and enter the "Default-Directory" field with your database name {DATABASE}. You will enter this in the MAZ dashboard below.

Create an Application

Create a Machine to Machine (M2M) application by navigating to Applications, Create Application, then name your application, and select Machine to Machine.

Important Note: To create a Machine-to-Machine app, you will need an Auth0 Developer Pro account. 

 

Authorize

Navigate to the API tab in the application, and select Auth0 Management API from the dropdown.

Then check the following boxes:

read:users
update:users
create:users
read:users_app_metadata
update:users_app_metadata
create:users_app_metadata

Access Audience

Select the APIs from the menu. Locate the 'Identifier' field to enter this in the MAZ dashboard below.

Grant Password

In Applications, Navigate to Settings and scroll down to Show Advanced Settings. 

In this section that opens, select Grant Types. Then check Password, and select Save Changes.

Enter Data in MAZ

Enter the following values in the Auth0 dashboard:

• Domain
• Client ID
• Client Secret
• Management API Identifier
• Default Directory

Enter data in the MAZ Database Integration Dashboard

1. Select the Subscription Type for your current subscribers. This does not necessarily have to match what you choose for new subscribers in Subscriptions.

• All-Access: Current subscribers will have access to all content.
• Duration-based: Current subscribers will have access to the content dated from their subscription date onward.

2. Domain

MAZ will send requests to this domain over HTTPS.

3. Enter your AuthO Client ID, and Client Secret from your AuthO admin page.

4. Management API Identifier

Your app-specific key

5. Default Directory

This is the database required to complete the password grant.

6. Notes

Enter notes for either MAZ or for internal communication regarding your AuthO Integration.

Auth0 Authorization Code Grant - OAuth

Connect your 0Auth registration used on your website or other app properties seamlessly into your app.

1. Navigate to Applications and select your MAZ Machine to Machine application.
2. Navigate to Settings and locate the Application Domain, Client ID, and Client Secret.

3. Open Database Integrations in your MAZ account and navigate to the Auth0 Authorization Code Grant settings. Copy and paste your Application Domain, Client ID, and Client Secret.

Select Subscription Type for your current subscribers. This does not necessarily have to match what you choose for new subscribers in Subscriptions.

• All-Access: Current subscribers will have access to all content.
• Duration-based: Current subscribers will have access to the content dated from their subscription date onward.

Single Sign-On (Two-Way Sync)

An SSO database integration solution to validate and unlock app access for your existing subscribers hosted in your database and data sync of in-app subscriber records back to your database.

Enter your AuthO Client ID, Client Secret, and Domain from your AuthO settings page.

4. All set! Your app experience will default to your custom OAuth login and registration screen, seamlessly registering, authenticating, and writing user data directly to your Auth0 database.