Skip to main content

Configure Microsoft Entra ID based sign-in

Revision supports a number of identity providers for signing in, Microsoft Entra (formally known as Azure AD) being one of them.

All SSO-based sign-in is configured under "Settings" and "Security" in the app and requires that the users have the Administrator role.

Configure an App Registration in Azure Portal​

Sign in to the Azure portal and the tenant you are planning to use. Navigate to the Azure Entra ID product and look for the App Registrations.

Azure Entra ID, App Registrations interface showing the navigation menu

The Azure App Registration needs the Redirect URI from Revision to redirect the user back to the application after sign-in. You can find that URI on the settings page in Revision.

Redirect URI​

The SSO configuration page in Revision showing redirect URI field

Configuring the Redirect URI for the Azure App Registration in the authentication settings

Client ID and Directory ID​

On the overview page for the App Registration, you can see the client ID for the app registration and the Directory ID for your tenant. Copy those values into the Revision form.

Azure App Registration overview page showing Application ID and Directory ID

Create client credentials​

Finally, you need to create client credentials by clicking the "Add a certificate or secret" link on the overview page. Create a new client secret and copy the value to the Revision form.

Azure App Registration client secret creation dialog

Require SSO based login​

The "Force SSO login for all non-admin users" will disable username and password-based login for all users that don't have the Administrator role. Administrators will still be able to sign in using both methods.

Force SSO login checkbox setting in Revision security configuration