> ## Documentation Index
> Fetch the complete documentation index at: https://requestly-mintlify-changelog-requestly-past-week-38456.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Set up Microsoft Entra ID

> Set up SSO with Microsoft Entra ID

If your company uses [Microsoft Entra ID](https://www.microsoft.com/en-us/security/business/identity-access/microsoft-entra-id), you can set up the single sign-on feature for use with Requestly. This gives your employees the convenience of a one-click login, without using additional multi-factor authentication.

## Step 1. **Create an Microsoft Entra ID enterprise application**

1. Go to the <a target="_blank" href="https://entra.microsoft.com/">**Microsoft Entra ID**</a> portal.

2. Go to **Identity > Applications > Enterprise applications.**

3. Click on **+** **New application.**

   <img src="https://mintcdn.com/requestly-mintlify-changelog-requestly-past-week-38456/vF3qe2iiJjRDLN_B/images/how-to-set-up-sso-with-microsoft-entra-id/4ca2707a-b5d7-432c-b658-be6ec164d66d.png?fit=max&auto=format&n=vF3qe2iiJjRDLN_B&q=85&s=7d1b030af8816ffd163b26357b63b8b0" align="center" fullwidth="false" width="1431" height="859" data-path="images/how-to-set-up-sso-with-microsoft-entra-id/4ca2707a-b5d7-432c-b658-be6ec164d66d.png" />

4. Enter app name as desired, select **Integrate any other application you don’t find in the gallery (Non-gallery)**, and click **Create**

   <img src="https://mintcdn.com/requestly-mintlify-changelog-requestly-past-week-38456/vF3qe2iiJjRDLN_B/images/how-to-set-up-sso-with-microsoft-entra-id/353eb1f4-5052-4ccb-a653-36744c7e44e9.png?fit=max&auto=format&n=vF3qe2iiJjRDLN_B&q=85&s=7e0ba7a6c14bb6d2ed6e7c8ec5967139" align="center" fullwidth="false" width="1431" height="855" data-path="images/how-to-set-up-sso-with-microsoft-entra-id/353eb1f4-5052-4ccb-a653-36744c7e44e9.png" />

5. After this you're redirected to the newly created Requestly application **Overview**.

## Step 2. Configure Microsoft Entra ID SAML Application

1. On the app's **Overview** page, select **2. Set up single sign-on**. You can assign users and groups later.

   <img src="https://mintcdn.com/requestly-mintlify-changelog-requestly-past-week-38456/vF3qe2iiJjRDLN_B/images/how-to-set-up-sso-with-microsoft-entra-id/68c57f5a-2641-4e40-8459-fd10163a37ee.png?fit=max&auto=format&n=vF3qe2iiJjRDLN_B&q=85&s=c996f78c85e9c18324492fb0a02796b3" align="center" fullwidth="false" width="678" height="286" data-path="images/how-to-set-up-sso-with-microsoft-entra-id/68c57f5a-2641-4e40-8459-fd10163a37ee.png" />

2. On the app's **Single sign-on** page, select **SAML** as the single sign-on method.

3. Under the **Basic SAML Configuration** section, click **Edit.**

4. Add the following values and **save**:

   * **Identifier (Entity ID):** `urn:requestly.io`

   * **Reply URL:** `https://app.requestly.io/__/auth/handler`

   * **Sign on URL (optional):** Leave it empty. We don’t support IDP initiated SSO right now

     <img src="https://mintcdn.com/requestly-mintlify-changelog-requestly-past-week-38456/vF3qe2iiJjRDLN_B/images/how-to-set-up-sso-with-microsoft-entra-id/290821e7-a92c-4cc6-b502-e1e19194c9af.png?fit=max&auto=format&n=vF3qe2iiJjRDLN_B&q=85&s=4e9b6db3cfb4bf02ba0390039a1a2ae3" align="center" fullwidth="false" width="1569" height="374" data-path="images/how-to-set-up-sso-with-microsoft-entra-id/290821e7-a92c-4cc6-b502-e1e19194c9af.png" />

## Step 3. Setup SAML claims

1. Under the **Attributes and Claims** section, click **Edit**. 

2. Enter the following values:

| Unique User Identifier (Name ID) | user.mail      |
| -------------------------------- | -------------- |
| first\_name                      | user.givenname |
| last\_name                       | user.surname   |
| email                            | user.mail      |

<img src="https://mintcdn.com/requestly-mintlify-changelog-requestly-past-week-38456/vF3qe2iiJjRDLN_B/images/how-to-set-up-sso-with-microsoft-entra-id/1338f76e-6299-4eb6-b3a9-b35f6f1146b3.png?fit=max&auto=format&n=vF3qe2iiJjRDLN_B&q=85&s=76e89573d644a53b8d4ee8cefa377b84" align="center" fullwidth="false" width="1562" height="376" data-path="images/how-to-set-up-sso-with-microsoft-entra-id/1338f76e-6299-4eb6-b3a9-b35f6f1146b3.png" />

## Step 4. Share SAML metadata with Requestly

1. Under **SAML Certificates** section, copy the **App Federation Metadata URL**.

2. Share the copied value with us `contact@requestly.io`
