Connect Auth0 to Venn for Identity Management

In order to enable a seamless user login experience in Venn, Venn offers integrations with third-party Identity Providers (IdPs), including Auth0.

Auth0 does not support user or group provisioning, so if you configure Auth0 as your Venn Identity Management solution, you will create users in Venn and your users' login information will be synced over from Auth0 to Venn (matching on email address). Learn how to manage Venn user access with Auth0 as your IdP.

Set up Auth0 as Your IdP

You must have Admin access to Auth0 in order to set it up as your Venn IdP.

If you already have Identity Management configured in Venn, changing your identity provider will result in all users being locked out of Venn, including Company Managers. For that reason, changes should only be made in collaboration with the Venn team or a Venn partner.

To set up Auth0 as your IdP:

  1. The Venn team or a Venn partner will guide you through the process of changing your Identity Provider to Auth0 in Venn's Company Admin.
  2. After your Identity Provider has been changed to Auth0 in Venn's Company Admin, log in to the Auth0 Dashboard to complete the IdP setup.

  3. In the menu at left, click Applications and select Applications.

    Auth0_Applications.png

  4. Set the App Name to Venn, select Regular Web Applications, and click Create.

    Auth0_Add Application.png

  5. Navigate to the Addons tab and toggle on the SAML2 option.

    Auth0_Turn on SAML.png

  6. In the window that opens, add the following on the Settings tab. 

    Auth0_SAML Details.png

    • Application Callback URL: Replace [Company_Shortname] with the abbreviation for your company that you see in the URL bar before .venn.com when you have the Workplace web app open.

      https://[Company_Shortname].venn-dev.com/sso/auth0 

    • Settings: Replace [Company_Shortname] with the abbreviation for your company that you see in the URL bar before .venn.com when you have the Workplace web app open.

      {
  "audience": "https://[Company_Shortname].venn-dev.com/sso/auth0",
  "mappings": {
    "firstName": "firstName",
    "lastName": "lastName",
    "email": "email",
    "name": "upn"
  },
  "createUpnClaim": false,
  "passthroughClaimsWithNoMapping": false,
  "mapUnknownClaimsAsIs": false,
  "mapIdentities": true,
  "signatureAlgorithm": "rsa-sha256",
  "digestAlgorithm": "sha256",
  "signResponse": false,
  "typedAttributes": true,
  "includeAttributeNameFormat": true,
  "nameIdentifierFormat": "urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified",
  "nameIdentifierProbes": [
    "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress"
  ],
  "authnContextClassRef": "urn:oasis:names:tc:SAML:2.0:ac:classes:unspecified",
  "binding": "urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST"
}
  7. Click Debug to confirm that your provided parameters are valid, and then click Save.

  8. Navigate to the Usage tab and click Download next to Identity Provider Metadata.

    Auth0_Get Metadata.png

  9. Zip and share the XML file with your Venn team. In Company Admin, they will:

    1. Click All websites in the menu at left and click Add websites.

      Auth0_Add Website.png

    2. Search for and select “Auth0” and click Identity Provider.

    3. Click Auth0 in the websites list, click Edit Identity Provider, and upload the contents of the XML file in the IdP metadata field.

Once these steps are complete, Auth0 will be set up as your IdP for Venn.

Manage User Access to Venn when Auth0 is Your IdP

Follow the steps in this article to manage user access to Venn once you have set up Auth0 as your IdP.

Was this article helpful?