---
title: "Azure Entra ID"
description: "Configure Azure Entra ID Single Sign-On"
---

<Note>
Azure SSO is only available on Pangolin Cloud and Enterprise deployments. In enterprise, you must enable `use_org_only_idp` in your [private config file](/self-host/advanced/private-config-file) `privateConfig.yml`.
</Note>

The following steps will integrate Microsoft SSO using the built in Azure Entra ID identity provider in Pangolin.

<iframe
  className="w-full aspect-video rounded-xl mb-10"
  src="https://www.youtube.com/embed/41OWI8uHPZg?si=VYGGAerzsIDe6wUx"
  title="YouTube video player"
  frameBorder="0"
  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
  allowFullScreen
></iframe>

<Accordion title="How to create and set up an App Registration in Microsoft Azure from scratch">

#### Create an App Registration

In Azure, go to "Microsoft Entra ID". Under "Manage", click "App registrations". On the "All applications" tab, select "Register an application".

Give it a name like "Pangolin", select your preferred supported account types, and click "Register". Leave the redirect URI blank for now; we will come back to this.

#### Copy Credentials

On the new app registration, select the "Overview" tab. Here, you can copy the "Application (client) ID" and save for later.

Now we need to generate the client secret. Click "Add a certificate or secret". Then click "New client secret". Enter a description like "Pangolin credentials" and choose an expiration time. Note that once this secret expires, you will need to generate a new one and replace it in the Pangolin dashboard for the associated IdP.

Copy the "Value" field and save for later.

<Note>
We will revisit the **Authorised redirect URIs** field later, as we do not have Pangolin set up for Azure yet.
</Note>

</Accordion>

## Creating an Azure Entra ID IdP in Pangolin

In Pangolin, go to "Identity Providers" and click "Add Identity Provider". Select the Azure Entra ID provider option.

<Frame>
  <img src="/images/create-azure-idp.png" />
</Frame>

In the OAuth2/OIDC Configuration, you'll need the following fields:

<ResponseField name="Client ID" type="string" required>
  The application (client) ID from the "Overview" section of your app registration
</ResponseField>

<ResponseField name="Client Secret" type="string" required>
  The client secret value from the "Certificates and secrets" section of your app registration
</ResponseField>

## Token Configuration

When you're done, click "Create Identity Provider". Then, copy the Redirect URL in the "General" tab as you will now need this for your app registration.

## Returning to Azure

Lastly, you'll need to return to your app registration in order to add the redirect URI created by Pangolin. On the "Overview" tab, click "Add a Redirect URI". The click "Add a platform", and select "Web". Here, you can add the redirect URL from Pangolin and click "Configure". Your configuration should now be complete. You'll now need to add an external user to Pangolin, or if you have "Auto Provision Users" enabled, you can now log in using Azure SSO.
