External identity provider setup

DevRev can be configured to use external identity providers for SSO.

If you want DevRev to use an external identity provider, follow the instructions for your organization’s provider.

Before you begin

To register DevRev as a SAML 2.0 application, you need the slug for your dev org. You can find it in DevRev under Settings > General.

To get the dev_oid and slug, run the following command:

1 curl --location --request GET 'https://api.devrev.ai/internal/dev-orgs.self.get' \
2 --header 'Authorization: <your PAT>'

For example, if your DevRev App URL is https://app.devrev.ai/myorgslug, then the value of the slug is myorgslug. In the configuration instructions, replace <DEV_ORG_SLUG> with your org's slug.

Identity providers

You can register DevRev as an identity provider in any of the following services.

Log in to Azure Active Directory and select Enterprise applications > + New application.
Search for "Azure AD SAML Toolkit" in the Browse Azure AD Gallery and select it.
Enter DevRev as the name and click Create.
Select Single sign-on > SAML.
Edit the Basic SAML Configuration and enter the following parameters.
- Identifier (Entity ID): urn:auth0:tf-devrev-prod:<DevOID>-<CUSTOM_STRING>
- Reply URL (Assertion Consumer Service URL): https://auth.devrev.ai/login/callback?connection=<DEVOID>-<CUSTOM_STRING>
- Sign on URL: https://app.devrev.ai/<DEV_ORG_SLUG>
The value of <CUSTOM_STRING> can be anything you select, and it must be the same in both parameters.
Go to Copy > SAML Certificates and save the App Federation Metadata URL.
In the Azure portal, go to the application named "DevRev" that you created earlier under Enterprise applications. Within the application, go to Users and Groups and assign the users who can access the app.

External identity provider setup

Before you begin

Identity providers

On this page