---
title: "Microsoft Entra ID provider"
description: "Relativity can import Entity (Employee/Custodian) data from Microsoft Azure Active Directory through Relativity Integration Points (RIP)."
feature: "Integration Points"
audience: ["end user", "developer", "system analyst", "system administrator", "system engineer"]
version: "Relativity aiR"
type: ["User Guide", "Tutorial"]
tocPath: "Features|Data transfer|Integration Points"
url: "https://help.relativity.com/RelativityaiR/Content/Relativity/Integration_Points/Azure_AD_provider.htm"
lastModified: "2026-11-20"
---

# Microsoft Entra ID provider

> **Note:** Microsoft has renamed Azure Active Directory (Azure AD) to Microsoft Entra ID. This site has been updated to reflect the name change, where applicable. Refer to [Microsoft documentation](https://learn.microsoft.com/en-us/entra/fundamentals/new-name) for more information.

You can import Entity (Employee/Custodian) data from Microsoft Entra ID, formerly known as Azure Active Directory, through Integration Points.

Before you begin, complete the following prerequisites:

In Relativity:

- Install Integration Points into your workspace. See [Installing Integration Points](https://help.relativity.com/RelativityaiR/Content/Relativity/Integration_Points/Installing_Integration_Points.md) for details.
- Install the RIP AAD Provider application from the application library.
  - This adds Microsoft Entra ID as a source within Integration Points.
  - For more information, see [Installing applications to workspaces](https://help.relativity.com/RelativityaiR/Content/Relativity/Applications/Installing_applications.md#Installi2).

Completing these two installations adds Integration Points to your workspace and adds Microsoft Entra ID as a source within Integration Points.

In Microsoft Azure:

- Set up an application in Microsoft Azure to configure an Integration Point in Relativity.
  - Only an Application Administrator with access can create an application, find credentials, and delete an application.
  - If you do not have permissions, contact your admin.
  - For more information on Application Administrators, see [Microsoft’s documentation](https://docs.microsoft.com/en-us/azure/active-directory/develop/quickstart-register-app).

Once you complete the prerequisites, import Microsoft Entra ID into Relativity. For more information, see [Importing from Microsoft Entra ID](https://help.relativity.com/RelativityaiR/Content/Relativity/Integration_Points/Importing_data_through_Integration_Points.md#ImportingMSAzureAD).

> **Note:** This documentation contains references to third-party software, or technologies. While efforts are made to keep third-party references updated, the images, documentation, or guidance in this topic may not accurately represent the current behavior or user interfaces of the third-party software. For more considerations regarding third-party software, such as copyright and ownership, see [Terms of Use](https://www.relativity.com/terms-of-use/).

## Registering an Azure application and credentials

To create your application ID and secret, you must have Application Administrator privileges to log into your Azure Portal and register an app.

Start with registering your application in the Azure portal by following the steps below.

> **Caution:** The listed permissions and roles are required and supported by Relativity.
> - Relativity does not support substitutions or reduced permissions.
> - You can submit requests for alternative or reduced permissions as product feedback.

For more information on registering an application in Azure, see [Microsoft's documentation](https://docs.microsoft.com/en-us/azure/active-directory/develop/quickstart-register-app) or [Microsoft's authentication documentation](https://docs.microsoft.com/en-us/exchange/client-developer/exchange-web-services/how-to-authenticate-an-ews-application-by-using-oauth).

> **Note:** These steps must be completed by a Microsoft 365 administrator.

1. Open your [Azure Portal](https://portal.azure.com/).
2. Click **Microsoft Entra ID** (formerly known as Azure Active Directory).
3. Click **App registrations**.
4. Click **New Registration** to display the Register an application page.
5. Enter an application name in the **Name** field.
6. Accept the default setting, **Accounts in this organizational directory only**, as the supported account type.
7. Click **Register**.
8. Once the application is registered, make note of the **Application (client) ID** and **Directory (tenant) ID** for use later when configuring the data source in Relativity aiR Collect.

Next, from the app's page, add permissions to the web API by following the steps below:

1. Click **API Permissions**.
2. Click **Add a permission**.
3. Click **Microsoft Graph**.
4. Select **Application Permissions**.
5. Select the following options from the Application Permissions section:
   - Directory – **Directory.Read.All**
   - Group – **Group.Read.All**
   - User – **User.Read.All**

     > **Note:** This permission is required if Filter by Group functionality is used.
6. Click **Add Permission**.
7. Click **Grant Permission**.

Finally, grant Admin consent for the API by following the steps below:

1. Click the **API Permissions** tab.
2. Click **Grant admin consent for \[tenant\]**.
3. In the pop-up window, click **Accept**.

## Finding Azure credentials

If an application is already created and you need to find the application information to complete the Source Connection step, follow the steps below in the Azure Portal. For more information, see relevant Microsoft documentation on the Microsoft site.

1. Open your [Azure Portal](https://portal.azure.com/).
2. Click **Microsoft Entra ID** (formerly known as Azure Active Directory).
3. Navigate to **Enterprise applications**.
4. In the list of applications, locate and click on your application.The application page displays.
5. Navigate to **Properties**.
6. Click the **copy icon** next to the **Application ID**. The ID is copied to your clipboard to use as needed.  
   ![Properties dialog showing Application ID](https://help.relativity.com/RelativityaiR/Content/Resources/Images/Features/Integration_Points/SCR_AzureApplication.png)

## Removing application access

Removing access to an application can be done outside of Relativity in Microsoft Entra ID. To remove access, follow the steps below in the [Azure Portal](https://portal.azure.com/):

1. Click **Microsoft Entra ID** (formerly known as Azure Active Directory).
2. In the navigation menu, click **Enterprise applications**.
3. In the list of applications, locate and open the desired application.
4. In the application, click **Delete**.
