Description
In order to integrate Auth0 with ConcealBrowse and leverage Single Sign-On(SSO) within your organization, you will first need to make sure that you have an application created in Auth0, configured that application for SSO, and uploading data into the Conceal dashboard. This guide will outline all of these steps.
Applies to
- ConcealBrowse Version 3+
-
Auth0
Procedure
Before you begin
Important!
- You can only set SSO up with one domain and use that domain to login (ex: if you set it up with @example.com, only @example.com domains will be allowed via SSO, no variations such as @examples.com would be allowed)
- You need to be logged into the Conceal dashboard with the same domain you plan to set up with SSO (Ex: john@example.com would need to be logged in to upload the data to the Conceal dashboard. john@examples.com would not work if you are configuring the SSO for john@example.com)
Configuring Application for SSO
- Open your web browser and log into the Conceal Dashboard at dashboard.conceal.io, login if necessary.
- In the left hand menu, click the section labeled Settings.
- Click the dropdown arrow on the right next to SAML Single Sign On and choose the option labeled Auth0.
- Here you will find prerequisites that are needed to configure your application in Auth0, the Application Callback URL and Settings. Click the copy icon to copy the values and paste into the Auth0 application.
Setting up a new application in Auth0
- Please follow Auth0's documentation on setting up a new application: Create a new application in Auth0 and use the above information during your application creation.
Provide metadata to Conceal
- In your Auth0 application navigate to Applications -> Choose your Application -> go to the Add Ons tab -> click the SAML2 Web App tile -> Usage tab -> Download the Identity Provider Metadata file.
- In the Conceal dashboard still on the Auth0 settings, click to Upload SAML Metadata. You can also choose to copy and paste the metadata into the field.
- Once that is uploaded, click Configure SSO Provider to save your changes.
You should now have Auth0 integrated with ConcealBrowse!
Note: As of now, even though SSO has been integrated, each employee will still have to login to the extension the first time to be authenticated. After login, they will then show as a user in the dashboard.
*Never hesitate to contact your Customer Success Manager for any questions or concerns. You may also open a support ticket at support.conceal.io by scrolling to the bottom and clicking Submit a request.