Introduction

This guide provides information on how to:

• Set up Beyond Identity as a passwordless authentication solution for your Auth0 Workforce environment.
• Set up Auth0 to use Beyond Identity as an Identity Provider (Enterprise Connection).

 

Prerequisites

Ensure that you have an Auth0 account with admin privileges.

 

Beyond Identity Configuration

Information to provide to the Beyond Identity Field Team:

 

Information you will receive from the Beyond Identity Field Team

 

Auth0 Configuration

To configure Beyond Identity as the IdP in Auth0, follow the steps below. Once these steps are taken, you will be ready to enable Beyond Identity for test users.

Step 1: Setup Beyond Identity Admin Application in Auth0

1. Click on Applications > Applications > Create Application

 

2. Call the application “Beyond Identity Admin Portal”, Choose “Regular Web Application” and click ‘Save’

3. In the ‘Settings’ Tab scroll down and record the “Domain” for your tenant and also record the “Client ID” and “Client Secret” assigned to Application. Beyond Identity team will collect and use those values to configure access into the Beyond Identity Admin Portal.

4. Optional step  - Add the Beyond Identity logo to the “Application Logo” field:

“https://byndid-public-assets.s3-us-west-2.amazonaws.com/logos/beyondidentity.png”

5. Scroll down again to the Application URIs section and enter the following values:
   1. Application Login URI = https://admin.byndid.com/login
   2. Allowed Callback URLs = https://admin.byndid.com/auth/callback

6. Scroll all the way down and click ‘Save Changes’ - all the other settings should be left as default.

Step 2: Setup Admin Portal Access

1. Provide “Client ID” and “Client Secret” assigned to Admin Application in Auth0 (as per Step 1) to Beyond Identity SE. Beyond Identity team will collect and configure those values at the backend.

 

Step 3: Setup Beyond Identity User Portal Application in Auth0

prerequisites - you will require a beyond identity tenant name which will be provided by your beyond identity SE

1. Click on Applications > Applications > Create Application

 

2. Call the application “Beyond Identity User Portal”, Choose “Regular Web Application” and click ‘Save’

3. In the ‘Settings’ Tab scroll down and record the “Domain” for your tenant and also record the “Client ID” and “Client Secret” assigned to Application. These values will be needed in the next step to configure access into the Beyond Identity User Portal.

 

4. Optional step  - Add the Beyond Identity logo to the “Application Logo” field:

“https://byndid-public-assets.s3-us-west-2.amazonaws.com/logos/beyondidentity.png”

5. Scroll down again to the Application URIs section and enter the following values:
   1. Application Login URI = https://user.byndid.com/auth-user/?org_id=<beyond-identity-tenant-name>
   2. Allowed Callback URLs = https://user.byndid.com/auth-user/callback
6. Scroll all the way down and click ‘Save Changes’ - all the other settings should be left as default.

 

Step 4: Setup Beyond Identity User Portal Authentication

1. Once logged into Beyond Identity Admin UI, click on Account Settings.

 

 

2. Click on “User Portal” tab and click on Edit.

 

3. Update SSO Issuer, Client Id, and Client Secret fields from the previous step.

SSO Issuer is same as Auth0 domain URL.

SSO Client ID and SSO Client Secret is collected during Step 3.3

 

Step 5: Setup Beyond Identity Service for User Authentication:

1. Once logged into Beyond Identity Admin UI, click on “Integrations” tab and then click on OIDC Clients.
2. Click on “Add OIDC Client” and complete the following fields:
   1. Name = “Auth0 SSO” or similar
   2. Redirect URL = “https://<auth0 domain>.auth0.com/login/callback” - replacing <auth0 domain> with your Auth0 domain URL or configured custom domain. 

For example -https://byndid-auth0-demo.us.auth0.com/login/callback 

3. Leave Token Signing Algorithm and Auth Method as default

3. Click ‘Save Changes’

 

4. Click on the newly created OIDC Client configuration and write down Client ID and Client Secret Value (see below screenshot). You will be using these values in the next step.

Step 6: Enable New Login Experience required for OIDC connections

1. In the Auth0 Management Dashboard, on the left hand-navigation window click ‘Branding’ and then ‘Universal Login’ on the expanded sub-menu. 

2. In the ‘Settings’ tab - Select the ‘New’ Experience.

3. Scroll down and click ‘Save Changes’ 

Step 7: Configure Beyond Identity as the Identity Provider in Auth0

1. On the left navigation pane click ‘Authentication’, the menu will expand, then click ‘Enterprise’
2. On the Enterprise Connections page - Click ‘Open ID Connect’

3. Then within the Open ID Connect menu click ‘Create Connection’
4. Enter the following values:
   1. Connection Name: “Beyond-Identity”
   2. Issuer URL: “https://auth.byndid.com/v2”
   3. Client ID: From Step 5.4
   4. Client Secret: From Step 5.4

5. Click ‘Create’

 

6. On the ‘Settings Tab’ under ‘Issuer URL’ click ‘Show Issuer Details’ and complete with the following values:

 

7. Scroll down to ‘Scopes’ and enter “openid”

8. Click “Save Changes”
9. Now scroll back up and click on the next tab along ‘Login Experience’

 

10. Under this tab, find the section called ‘Connection button’ and check (enable) the checkbox field labelled ‘Display connection as a button’
11. Enter the ‘Button display name’ as “Beyond Identity”
12. Add the following url for the ‘Button Logo URL’ - https://byndid-public-assets.s3-us-west-2.amazonaws.com/logos/beyondidentity.png

 

13. Scroll down and click ‘Save’

Step 8: Enable the Beyond Identity Connection in Auth0

1. Lastly, on the Applications tab within the OIDC connection - enable this connection for the Beyond Identity Admin and User portal applications which were created in Step 1 and 3.

Step 9: Check Auth0 callback URL is correct in Beyond Identity OIDC integration

1.  In the Auth0 management dashboard, under the ‘Settings’ tab of the Beyond Identity OIDC connection just created in Step 7, make a note of the ‘Callback URL’ as below.

2. In Beyond Identity Admin UI, click on “Integrations” tab and then click on OIDC Clients. Find the OIDC client created in Step 5 and click ‘Edit’.
3. Ensure that the ‘Redirect URI’ value matches with the value in Auth0 connection (Step 9.1). If the values do not match, update the value with the Callback URL extracted in Step 9.1 and Save Changes.

 

Setting up test users

 

 

User Provisioning

Before your users can start authenticating with Beyond Identity, they need to be provisioned in the Beyond Identity Directory. As Auth0 does not support SCIM, users need to manually provisioned using the Beyond Identity admin portal or using the Beyond Identity REST API.  Please see admin portal video tutorial here which shows navigating to the directory area of the admin portal - https://www.beyondidentity.com/resources/beyond-identity-admin-console-overview 

 

1. In the Admin portal under the ‘Directory’ tab click Add User’
2. Enter the following values:
   1. External ID: oidc|Beyond-Identity|<email_address>
   2. Email: <email_address>
   3. Username: <email_address>
   4. Display Name: <Full Name>
3. Click ‘ Save Changes’
4. The user will now be sent a welcome email to the email address supplied above. See User Enrollment section. 

 

Note: The External ID format above must be adhered to as this will be the user ID of the user in Auth0. 

User Enrollment

 

1. Enrolled (provisioned) user will receive an email from Beyond Identity welcoming them to the new Identity Provider.
   1. See image below for reference:

 

 

2. Each enrolled user will be asked to follow the two steps below:
   1. Step 1: Download the Beyond Identity Authenticator to their device.
      1. When the user clicks “View Download Options”, the Beyond Identity Authenticator downloads page will open in a browser with all supported platforms displayed. The user should download and install the Beyond Identity Authenticator on their device if they have not already.
      2. Now that the user has the Authenticator installed on their device, they should proceed to Step 2 as there is not yet a user credential associated with the Authenticator on that device.
   2. Step 2: Register their Credential in the Beyond Identity IdP.
      1. By clicking on Step 2 “Register New Credential”, the user’s credential will get enrolled in the Beyond Identity service on the back end. On the front end, users who click Step 2 will be taken to the Beyond Identity Authenticator where they will see the progress of their credential registration. Once completed, the user will see a credentials in the Authenticator. 
      2. See example image below:

 

 

User Authentication (Signing in)

1. Each enrolled user can visit any application supported by the SSO to passwordlessly sign into the corporate applications. 
2. The SSO-supported application will ask the user to enter their username. 
3. Once the username is submitted, a prompt to use or open the Beyond Identity app for authentication will display for the user.
4. The user should click affirmatively on the prompt to be signed into their application, without the use of a password. The Beyond Identity app along with a success notification will display.
   1. Note: For iOS devices, some application sign-in processes will ask the user to exit out of the Beyond Identity Authenticator to return to their app after successful authentication.

User Deprovisioning

To deprovision a user from the Beyond Identity experience, manually delete users from Beyond Identity Admin Portal.