Auth0

This article describes how to configure Auth0 for use as an identity provider for Perimeter 81. 

• Configuring the Auth0 SSO application
• Configuring Auth0 in the Management Platform
• Access Error troubleshooting

Please follow the steps below:

Configuring the Auth0 SSO application

1. Open the Auth0 Administrator Console.
2. Select Applications in the main navigation panel.
3. Select the + Create Application on the upper side of the screen.
   
4. Add Perimeter 81 as the name of your Application.
5. Select the "Regular Web Application " type, and click on Create.
   
6. Navigate to "Addons " and turn on the "SAML2 Web App " toggle.
   
7. In the Addon: SAML2 Web App window:

• Application Callback URL :Enter https://auth.perimeter81.com/login/callback?connection={{WORKSPACE}}-oc
• Settings: Copy the following configuration**:**

`{

"audience": "urn:auth0:perimeter81: **{{WORKSPACE}}**	  -oc",

"mappings": {

"email": "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress",

"given_name": "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname",

"family_name": "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname",

"groups": "http://schemas.xmlsoap.org/claims/Group"

}

}`

Hint: Remember to replace the {{WORKSPACE}} with your actual tenant name

8. Click Enable to save and activate the Application.

9. Click on Debug and verify your configuration.

10. Navigate to Usage.

11. Click on Download Auth0 certificate.

12. Write down the Identity Provider Login URL.

Configuring Auth0 in the Management Platform

At this point, you will configure the integration from the Perimeter 81 side.

1. Log in to your Perimeter 81 Management Platform, and navigate to Settings and then Identity Providers.
   
2. Select + Add Provider.
3. Choose SAML 2.0 Identity Providers.
4. Sign In URL: Identity Provider Login URL
5. Add your organization domain.
6. Open the Auth0 certificate file and paste its content into the X509 Signing Certificate box.
   
   
7. Select Done.

Access Error troubleshooting

If your users are getting access error after the configuration, please check these steps.