> ## Documentation Index
> Fetch the complete documentation index at: https://docs.datafold.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Entra ID

> Configure Microsoft Entra ID (Azure AD) as a SAML identity provider for Datafold SSO. Step-by-step setup and configuration guide.

## Azure AD / Entra ID as a SAML Identity Provider

You can create an **Enterprise Application** and use that to configure access to Datafold. Click on **New application** and **Create your own application**.

![](https://mintcdn.com/datafold/7pWtpSckJi2T0xZR/images/AzureEntraIDSAMLEnterpriseApp-ac80b4305fc06a4a80a45532d718710a.png?fit=max\&auto=format\&n=7pWtpSckJi2T0xZR\&q=85\&s=f046f4325a41d25294d72b72bc7e7f32)

**Copy** the **App Federation Metadata Url**.

![](https://mintcdn.com/datafold/7pWtpSckJi2T0xZR/images/AzureEntraIDSAMLEnterpriseAppInitialConfig-6d5935f0a7efeec4595856d5171c3182.png?fit=max\&auto=format\&n=7pWtpSckJi2T0xZR\&q=85\&s=c0e3cd95b03d1101df57c76076ad7b50)

Go to `Datafold` and create a new SSO integration. Navigate to **Settings** → **Integrations** → **Add new Integration** → **SAML**.

Paste the **copied** URL into **Identity Provider Metadata URL**.

![](https://mintcdn.com/datafold/9DgdnO4sVNte36u-/images/saml_create-3716c6fe01352ea69c647a7856adf189.png?fit=max\&auto=format\&n=9DgdnO4sVNte36u-\&q=85\&s=d664571269b205f66ed0bfb051107a91)

Go to `Azure` and edit the **Basic SAML Configuration** in your Enterprise App.

Copy from Datafold the read-only field **Service Provider ACS URL** and paste it into **Reply URL**.

Copy from Datafold the read-only field **Service Provider Entity ID** and paste it into **Identifier**.

![](https://mintcdn.com/datafold/7pWtpSckJi2T0xZR/images/AzureEntraIDSAMLEnterpriseAppSAMLConfig-f04cd556cd232163a85a3ff2e47e5e7e.png?fit=max\&auto=format\&n=7pWtpSckJi2T0xZR\&q=85\&s=914fa717d4ab2ed87ffc04a67c99cf0e)

Go to `Datafold` and click **Save** to create the SAML integration.

Next, edit the **Attributes & Claims**. By default, the **Unique User Identifier** is already correctly set to `user.userprincipalname`. If you have multiple domains (e.g., `@datafold.com` and `@datafoldonmicrosoft.com`), please make sure this maps correctly to the email addresses of the users in Datafold.

(Optional step) Add two attributes: `first_name` and `last_name`.

![](https://mintcdn.com/datafold/7pWtpSckJi2T0xZR/images/AzureEntraIDSAMLEnterpriseAppSAMLAttribute-99692a9fa1d102a1eaa818d36c6b812e.png?fit=max\&auto=format\&n=7pWtpSckJi2T0xZR\&q=85\&s=0e1e60e7e3feeff95983c959da115188)

Finally, edit the **SAML Certificates**. Set the signing option to **Sign SAML response and assertion**.

![](https://mintcdn.com/datafold/7pWtpSckJi2T0xZR/images/AzureEntraIDSAMLEnterpriseAppCertificates-c4582a0cf51f8dcdae03013810278e00.png?fit=max\&auto=format\&n=7pWtpSckJi2T0xZR\&q=85\&s=8fd247f9d4d784561868cf9359a16d6f)

After making sure you are added as a user to the Enterprise Application, log out from Datafold. Click on **Test** under **Test single sign-on with DatafoldSSO**.

## Synchronize user with Datafold \[Optional]

This step is essential if you want to ensure that users from your organization are disabled if they are no longer assigned to the configured Microsoft Entra App.

1. Navigate to App registrations → API permissions.
2. Add the following permissions: `Group.Read.All` and `User.ReadBasic.All`.
   2.1 Click `Add a permission`.
   2.2 Select Microsoft Graph.

![](https://mintcdn.com/datafold/7pWtpSckJi2T0xZR/images/1-e2efd77a0267ffe5f9fb14ef6be44c1f.png?fit=max\&auto=format\&n=7pWtpSckJi2T0xZR\&q=85\&s=a720a15fa9d640f9391f8fab7c9211c0)

2.3 Select application permissions and add the required permissions.

![](https://mintcdn.com/datafold/7pWtpSckJi2T0xZR/images/2-00a764fe8abf4ef520abeaf7ae07d49e.png?fit=max\&auto=format\&n=7pWtpSckJi2T0xZR\&q=85\&s=13b9a24078632afb55d8c665f4e40f1f)

![](https://mintcdn.com/datafold/7pWtpSckJi2T0xZR/images/3-eadbef3fd2f9c1d0326ed8a9721c16c2.png?fit=max\&auto=format\&n=7pWtpSckJi2T0xZR\&q=85\&s=fd83b4f6265f71cc3ca338d47104ada1)

3. Grant admin consent.

![](https://mintcdn.com/datafold/7pWtpSckJi2T0xZR/images/4-40f90f212a27572e669806bc36325bc7.png?fit=max\&auto=format\&n=7pWtpSckJi2T0xZR\&q=85\&s=fb0aa1f158f2aec6d6f4a1b3a081c20f)

4. You should now see a  next to the permissions.

![](https://mintcdn.com/datafold/7pWtpSckJi2T0xZR/images/5-257e23569930de31a6168ac10aaf5bf3.png?fit=max\&auto=format\&n=7pWtpSckJi2T0xZR\&q=85\&s=f28ea21f758290a2876d69fa51dc2da7)

5. Generate a secret so that Datafold can interact with the API.
   5.1 Click `Certificates & secrets`.

![](https://mintcdn.com/datafold/7pWtpSckJi2T0xZR/images/6-015ef3a0d51e4ee205d6bd5d5c888e8d.png?fit=max\&auto=format\&n=7pWtpSckJi2T0xZR\&q=85\&s=53b9bd989e8c0fabbe436dfd3464a1c1)

5.2 Click `New client secret`.
5.3 Type in a description and click `Add`.

![](https://mintcdn.com/datafold/7pWtpSckJi2T0xZR/images/7-a95118698bae900f1620b47905433fc4.png?fit=max\&auto=format\&n=7pWtpSckJi2T0xZR\&q=85\&s=552b5f52d806aa8b90681cc449584711)

6. Go to `Datafold` and navigate to **Settings** → **Integrations** → **SSO** → **Add new Integration** and select the Microsoft Entra ID Logo.

![](https://mintcdn.com/datafold/7pWtpSckJi2T0xZR/images/8-bfcf9d1f0679293415dad2a9b7c5ef6c.png?fit=max\&auto=format\&n=7pWtpSckJi2T0xZR\&q=85\&s=53e7d8df3ed9743261d59ffb842bd934)

7. Paste in the four required fields:\

   7.1 Tenant ID - [you can find this in the overview page](https://learn.microsoft.com/en-us/entra/fundamentals/how-to-find-tenant)\

   7.2 Navigate to the application overview\

   7.3 Copy Application ID and paste it into Client Id\

   7.4 Copy the secret we created in the previous steps and paste it into Client Secret\

   7.5 Navigate to the enterprise application and copy Object ID and paste it into Principal Id.\

   7.6 Click **Save** to create the integration.\


If the update is successful, it means that the integration is valid. Users that do not have access to the configured application will be disabled and logged out in at most one hour.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.