--- title: "Microsoft Entra App Role Inventory" slug: "ms-entra-app-role-inventory" updated: 2026-06-17T15:11:42Z published: 2026-06-17T15:11:42Z canonical: "docs.databee.buzz/ms-entra-app-role-inventory" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.databee.buzz/llms.txt > Use this file to discover all available pages before exploring further. # Microsoft Entra App Role Inventory Microsoft Entra App Role Inventory provides visibility into application access and permissions by retrieving app role assignments for service principals. It helps track which users, groups, or principals have access to applications, enforce the principle of least privilege, and audit role-based access controls (RBAC) within Microsoft Entra ID. For more information refer to the [Microsoft Entra App Role Inventory Documentation](https://learn.microsoft.com/en-us/graph/api/resources/serviceprincipal?view=graph-rest-1.0). **Integration Method:** API **Tables:** User Access Management (3005) This integration supports the following events. | **Event** | **Description** | | --- | --- | | App Role Inventory | Retrieves app role assignments for a service principal, showing which users, groups, or principals have access to an application. | This integration supports the following versions. | Microsoft Entra App Role Inventory API Version | v1 | | --- | --- | > [!NOTE] > **Note:** > > Microsoft Entra App Role Inventory is a continuously updated cloud service. As for this document preparation, the latest release was in March 24, 2026. ## Prerequisites - The user should have access to the [Azure](https://portal.azure.com/) portal with an account that has the Global Administrator privileges. - The user should have access to the DataBee console. ## Configuration Overview 1. [Create an application](/user-manual/docs/microsoft-entra-app-role-inventory#create-an-application) with required permissions to fetch the data. 2. Add the [Microsoft Entra App Role Inventory](/user-manual/docs/microsoft-entra-app-role-inventory#databee-configuration) in the DataBee console with the below parameters. | **DataBee Feed Parameter** | **Azure Parameter** | | --- | --- | | Client Key | [Application (client) ID](/docs/ms-entra-app-role-inventory#azure_client_id_secret_application_id) | | Client Secret | [Client Secret Value](/docs/ms-entra-app-role-inventory#secret) | | Token URL() | [Directory (Tenant) ID](/docs/ms-entra-app-role-inventory#azure_client_id_secret_application_id) | ## Azure Configuration ### Create an application 1. Log on to [Azure](https://portal.azure.com/) portal with an account that has the **Global Administrator** privileges. 2. In the **search bar**, search for **App registrations** and select it. ![Inserting image...](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-app-role-inventory-image-tdmmal24.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A43Z&se=2026-10-30T12%3A38%3A43Z&sr=c&sp=r&sig=H1XjGltSQVwYowqB%2Fc3eXYpDc4sfsY8oFuvvN5H1APA%3D) 3. On the “App registrations” page, select **New registration**, then **“**Register an application” window will appear. ![Inserting image...](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-app-role-inventory-image-vh9sb652.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A43Z&se=2026-10-30T12%3A38%3A43Z&sr=c&sp=r&sig=H1XjGltSQVwYowqB%2Fc3eXYpDc4sfsY8oFuvvN5H1APA%3D) 4. On the “Register an application” window: - Under **Name** enter your Application Name then click on **Register** to create the application. ![Inserting image...](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-app-role-inventory-image-e9gmuz7k.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A43Z&se=2026-10-30T12%3A38%3A43Z&sr=c&sp=r&sig=H1XjGltSQVwYowqB%2Fc3eXYpDc4sfsY8oFuvvN5H1APA%3D) 5. On the app **Overview** page, copy the **Application (client) ID** and **Directory (tenant) ID** for later use. ![Inserting image...](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-app-role-inventory-image-8ngommfp.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A43Z&se=2026-10-30T12%3A38%3A43Z&sr=c&sp=r&sig=H1XjGltSQVwYowqB%2Fc3eXYpDc4sfsY8oFuvvN5H1APA%3D) ### Add Endpoint Access Once the application is created, permission should be provided to fetch the data. The following section details how to configure and add permissions to the required endpoints. **Add Permissions** To add permissions for the endpoints outlined above, from the **Azure Active Directory portal**: 1. Select the application registered in the previous [step](/user-manual/docs/microsoft-entra-app-role-inventory#create-an-application). 2. Under **Manage***,* click **API permissions** and then click **Add a p****ermission**, the “Request API permissions” window will appear. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-app-role-inventory-image-7switr6d.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A43Z&se=2026-10-30T12%3A38%3A43Z&sr=c&sp=r&sig=H1XjGltSQVwYowqB%2Fc3eXYpDc4sfsY8oFuvvN5H1APA%3D) 3. On “Request API permissions” window, click on **Microsoft APIs** then on **Microsoft Graph**. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-app-role-inventory-image-31nbmz1y.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A43Z&se=2026-10-30T12%3A38%3A43Z&sr=c&sp=r&sig=H1XjGltSQVwYowqB%2Fc3eXYpDc4sfsY8oFuvvN5H1APA%3D) 4. Click on **Application permissions**. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-app-role-inventory-image-bnw53bdh.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A43Z&se=2026-10-30T12%3A38%3A43Z&sr=c&sp=r&sig=H1XjGltSQVwYowqB%2Fc3eXYpDc4sfsY8oFuvvN5H1APA%3D) 5. The following permissions need to be granted for the endpoint to function properly: | **Event** | **Type** | **Permission** | | --- | --- | --- | | App Role Inventory | Application | Application.Read.All | 6. In the **Select permissions** search bar, enter the permission shown above, and check the box to include it. 7. Click the **Add permissions** button after selecting the required permission. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-app-role-inventory-image-gfjr6epj.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A43Z&se=2026-10-30T12%3A38%3A43Z&sr=c&sp=r&sig=H1XjGltSQVwYowqB%2Fc3eXYpDc4sfsY8oFuvvN5H1APA%3D) 8. On the “API permissions” page, ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-app-role-inventory-image-qij7udsu.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A43Z&se=2026-10-30T12%3A38%3A43Z&sr=c&sp=r&sig=H1XjGltSQVwYowqB%2Fc3eXYpDc4sfsY8oFuvvN5H1APA%3D) ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-app-role-inventory-image-6rksc70x.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A43Z&se=2026-10-30T12%3A38%3A43Z&sr=c&sp=r&sig=H1XjGltSQVwYowqB%2Fc3eXYpDc4sfsY8oFuvvN5H1APA%3D) 1. Click **Grant Admin Consent** **for **. 2. Click the **Yes** button on the consent confirmation. ### Create the Client Secret The final step to accessing the APIs is creating a Client Secret. To create it from the Azure Portal: 1. Select the application created above. 2. Under **Manage**, click **Certificates & secrets**, and then **Client secrets**. ![Inserting image...](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-app-role-inventory-image-48jf71eq.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A43Z&se=2026-10-30T12%3A38%3A43Z&sr=c&sp=r&sig=H1XjGltSQVwYowqB%2Fc3eXYpDc4sfsY8oFuvvN5H1APA%3D) 3. Click **New client secret**. Then “Add a client secret” window appears. ![Inserting image...](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-app-role-inventory-image-6n3bd4j8.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A43Z&se=2026-10-30T12%3A38%3A43Z&sr=c&sp=r&sig=H1XjGltSQVwYowqB%2Fc3eXYpDc4sfsY8oFuvvN5H1APA%3D) 4. On “Add a client secret” window: 1. Enter a **Description** for this client secret and select the desired expiry period from the **Expires** drop-list. 2. Then click on **Add** to create the client secret. ![Inserting image...](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-app-role-inventory-image-i32vwb9z.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A43Z&se=2026-10-30T12%3A38%3A43Z&sr=c&sp=r&sig=H1XjGltSQVwYowqB%2Fc3eXYpDc4sfsY8oFuvvN5H1APA%3D) 5. Copy client secrets **Value** fields for later use. ![Inserting image...](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-app-role-inventory-image-fsz9z34p.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A43Z&se=2026-10-30T12%3A38%3A43Z&sr=c&sp=r&sig=H1XjGltSQVwYowqB%2Fc3eXYpDc4sfsY8oFuvvN5H1APA%3D) > [!NOTE] > **Note**: > > The user needs to re-create the client secret when it expires. ## DataBee Configuration 1. Login to the DataBee UI, navigate to **Data** > **Data Feeds** and click the **Add New Data Feed** button. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-app-role-inventory-image-mqpuxfho.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A43Z&se=2026-10-30T12%3A38%3A43Z&sr=c&sp=r&sig=H1XjGltSQVwYowqB%2Fc3eXYpDc4sfsY8oFuvvN5H1APA%3D) 2. Search for the **Microsoft Entra App Role Inventory** and click it as shown below. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-app-role-inventory-image-b30jhts2.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A43Z&se=2026-10-30T12%3A38%3A43Z&sr=c&sp=r&sig=H1XjGltSQVwYowqB%2Fc3eXYpDc4sfsY8oFuvvN5H1APA%3D) 3. Click on the **API Ingest** option for collection method. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-app-role-inventory-image-18y9qnxg.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A43Z&se=2026-10-30T12%3A38%3A43Z&sr=c&sp=r&sig=H1XjGltSQVwYowqB%2Fc3eXYpDc4sfsY8oFuvvN5H1APA%3D) 4. Enter **feed contact information**. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-app-role-inventory-image-z7jlwyj7.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A43Z&se=2026-10-30T12%3A38%3A43Z&sr=c&sp=r&sig=H1XjGltSQVwYowqB%2Fc3eXYpDc4sfsY8oFuvvN5H1APA%3D) 5. In the configuration page, enter the following - **Authorization Method**: OAuth2 - **Client Key:** Paste the [Application (client) ID](/docs/ms-entra-app-role-inventory#azure_client_id_secret_application_id) generated earlier - **Client Secret**: Paste the [Client Secret](/docs/ms-entra-app-role-inventory#secret) value generated earlier - **Token URL:** Replace with your [Tenant ID.](/docs/ms-entra-app-role-inventory#azure_client_id_secret_application_id) - **Event Types:** Preselected for all the event types that integration pulls. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-app-role-inventory-image-btu1vt0d.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A43Z&se=2026-10-30T12%3A38%3A43Z&sr=c&sp=r&sig=H1XjGltSQVwYowqB%2Fc3eXYpDc4sfsY8oFuvvN5H1APA%3D) 6. Click **Submit**. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-app-role-inventory-image-93sguzcv.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A43Z&se=2026-10-30T12%3A38%3A43Z&sr=c&sp=r&sig=H1XjGltSQVwYowqB%2Fc3eXYpDc4sfsY8oFuvvN5H1APA%3D) ## Troubleshooting Tips - Ensure the token is pasted correctly. Since you cannot view the token after the 1st time, re-create the token, paste it on a text editor to ensure no spaces or unexpected characters are included and reconfigure the DataBee feed. - Ensure the Microsoft Entra App Role Inventory permissions are correct. ## ##