> ## Documentation Index
> Fetch the complete documentation index at: https://docs-dev-docs-ai-docs-migration-poc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Learn how to configure Auth0 as an identity provider using the SAML2 Web App addon for Workpath.

# Configure Workpath as SAML Service Provider

Use the following <Tooltip tip="Security Assertion Markup Language (SAML): Standardized protocol allowing two parties to exchange authentication information without a password." cta="View Glossary" href="/docs/glossary?term=SAML">SAML</Tooltip> configuration for Workpath.

1. Go to [Dashboard > Applications > Applications](https://manage.auth0.com/#/applications) and either create a new application or click the name of an application to update.

2. Go to the **Addons** tab and enable the **SAML2 Web App** toggle.

3. On the **Settings** tab, set the **Application Callback URL** to: `https://api.workpath.com/v1/saml/assert/{yourWorkpathSubdomain}`.

   <Frame>
     <img src="https://mintcdn.com/docs-dev-docs-ai-docs-migration-poc/frCTjKq-WyUjSqji/docs/images/cdy7uua7fh8z/6dJgYkcOgMZ73HVTkAWt1x/fe9dbbf306e6c587cb3326c00a3b4e1f/2025-02-27_13-59-00.png?fit=max&auto=format&n=frCTjKq-WyUjSqji&q=85&s=2740ab4916df3410fd46a93ece192686" alt="Dashboard Applications Applications Addons Tab SAML2 Web App Settings Tab" width="606" height="757" data-path="docs/images/cdy7uua7fh8z/6dJgYkcOgMZ73HVTkAWt1x/fe9dbbf306e6c587cb3326c00a3b4e1f/2025-02-27_13-59-00.png" />
   </Frame>

4. Paste the following code into the **Settings** text box and click **Debug**.

   ```json lines theme={null}
   {
         "audience": "https://api.workpath.com/v1/saml/metadata/{yourWorkpathSubdomain}",
         "mappings": {
       "email": "email",
       "given_name": "first_name",
       "family_name": "last_name"
         }
       }
   ```

5. Scroll to the bottom of the page and click **Enable**.

6. On the **Usage** tab, locate **Identity Provider Metadata**, and click **Download** to download the metadata file. You'll need this when you configure Auth0 as the identity provider.

   <Frame>
     <img src="https://mintcdn.com/docs-dev-docs-ai-docs-migration-poc/B6vbwc1szQPxGMTr/docs/images/cdy7uua7fh8z/3T90BDpyTXFUWDp1JkncBU/86bdba6bed8130b34b42b25c9bf2d232/dashboard-applications-applications-addons-saml2-web-app-usage.png?fit=max&auto=format&n=B6vbwc1szQPxGMTr&q=85&s=57d957062d031c657b1627039e4ff502" alt="Dashboard Applications Applications Addons Tab SAML2 Web App Usage Tab" width="400" height="440" data-path="docs/images/cdy7uua7fh8z/3T90BDpyTXFUWDp1JkncBU/86bdba6bed8130b34b42b25c9bf2d232/dashboard-applications-applications-addons-saml2-web-app-usage.png" />
   </Frame>
