> ## Documentation Index
> Fetch the complete documentation index at: https://docs.requestly.com/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/J2qFDsPkU9iKOyXZ/images/how-to-set-up-sso-with-microsoft-entra-id/4ca2707a-b5d7-432c-b658-be6ec164d66d.png?fit=max&auto=format&n=J2qFDsPkU9iKOyXZ&q=85&s=ad9046a4522d0a0e0611d955d076b6bf" 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/J2qFDsPkU9iKOyXZ/images/how-to-set-up-sso-with-microsoft-entra-id/353eb1f4-5052-4ccb-a653-36744c7e44e9.png?fit=max&auto=format&n=J2qFDsPkU9iKOyXZ&q=85&s=2a38fccbe0a294bbdd180d5504bf1a91" 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/J2qFDsPkU9iKOyXZ/images/how-to-set-up-sso-with-microsoft-entra-id/68c57f5a-2641-4e40-8459-fd10163a37ee.png?fit=max&auto=format&n=J2qFDsPkU9iKOyXZ&q=85&s=feec55f396709ffaf3f0ca378cb9cb61" 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/J2qFDsPkU9iKOyXZ/images/how-to-set-up-sso-with-microsoft-entra-id/290821e7-a92c-4cc6-b502-e1e19194c9af.png?fit=max&auto=format&n=J2qFDsPkU9iKOyXZ&q=85&s=fbf10b11438df5da624a288db8ad62d5" 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/J2qFDsPkU9iKOyXZ/images/how-to-set-up-sso-with-microsoft-entra-id/1338f76e-6299-4eb6-b3a9-b35f6f1146b3.png?fit=max&auto=format&n=J2qFDsPkU9iKOyXZ&q=85&s=e758fd150ea16ec64196e0bbce67db8f" 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`
