---
title: "Microsoft Entra MFA"
slug: "microsoft-entra-mfa"
updated: 2025-05-30T00:06:54Z
published: 2025-05-30T00:06:54Z
canonical: "docs.databee.buzz/microsoft-entra-mfa"
---

> ## 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 MFA

Microsoft Entra MFA (Multi-Factor Authentication) enhances security by requiring users to verify their identity using multiple authentication methods, such as passwords, biometrics, or one-time passcodes. It helps protect against unauthorized access, phishing, and identity theft by adding an extra layer of security beyond just passwords. It integrates with Microsoft Entra ID (formerly Azure AD) and supports various authentication methods, including push notifications, SMS, voice calls, and security keys. More information can be found at [Microsoft Entra MFA](https://learn.microsoft.com/en-us/entra/identity/authentication/concept-mfa-howitworks).

**Integration Method:** API

**Tables:** Device Inventory Info (5001), User Inventory Info (5003), Base Class(0), Entity Management (3004)

This integration supports the following events.

| **Event** | **Description** |
| --- | --- |
| User Registration Details | Get a list of the authentication methods registered for a user as defined in the [userRegistrationDetails](https://learn.microsoft.com/en-us/graph/api/resources/userregistrationdetails?view=graph-rest-beta) object. |
| User Registration by Feature | Get the users capable of multi-factor authentication, self-service password reset, and password less authentication. |
| User Registration by Method | Get the users registered for each authentication method. |
| User Credential Usage Details | Get a list of [userCredentialUsageDetails](https://learn.microsoft.com/en-us/graph/api/resources/usercredentialusagedetails?view=graph-rest-beta) objects for a given tenant. Details include user information, status of the reset, and the reason for failure. |
| Credential User Registration Count | Report the current state of how many users in your organization are registered for self-service password reset and multifactor authentication (MFA) capabilities. |
| Credential Usage Summary | Report the current state of how many users in your organization used the self-service password reset capabilities. |
| Devices | Retrieve a list of devices registered in the directory. |
| Users | Retrieve a list of users along with their registered authentication methods. |
| Policies | Retrieve a list of policies along with the group members included and excluded from policy. |

This integration supports the following versions.

| Microsoft Entra MFA API Version | Beta |
| --- | --- |

> [!NOTE]
> **Note:**
> 
> Microsoft Entra MFA is a continuously updated cloud service. As for this document preparation, the latest release was in January 2025.

## Prerequisites

- The user should have access to the Azure 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 with required permissions to fetch the data.
2. Add the [Microsoft Entra MFA](/docs/microsoft-entra-mfa#_DataBee_Configuration) in the DataBee console with the below parameters.

| **DataBee Feed Parameter** | **Azure Parameter** |
| --- | --- |
| Client Key | Application (client) ID |
| Client Secret | Client Secret Value |
| Token URL(<application_id>) | Directory (Tenant) ID |

## Azure Configuration

### Create an application

1. Log on to [Azure portal](https://portal.azure.com/) 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-mfa-may2025-image-jf4h5x4c.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A06Z&se=2026-10-30T12%3A37%3A06Z&sr=c&sp=r&sig=%2FT%2FDqDG%2B5xbqW%2BiXuUKu9J7AI79lodQGDsDFI0BvrVI%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-mfa-may2025-image-fo9n8i9h.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A06Z&se=2026-10-30T12%3A37%3A06Z&sr=c&sp=r&sig=%2FT%2FDqDG%2B5xbqW%2BiXuUKu9J7AI79lodQGDsDFI0BvrVI%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-mfa-may2025-image-w5nqiuos.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A06Z&se=2026-10-30T12%3A37%3A06Z&sr=c&sp=r&sig=%2FT%2FDqDG%2B5xbqW%2BiXuUKu9J7AI79lodQGDsDFI0BvrVI%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-mfa-may2025-image-0xac9vf2.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A06Z&se=2026-10-30T12%3A37%3A06Z&sr=c&sp=r&sig=%2FT%2FDqDG%2B5xbqW%2BiXuUKu9J7AI79lodQGDsDFI0BvrVI%3D)

### Add Endpoint Access

Once the application is created, three permissions should be provided in order to fetch data. The appropriate permissions for the application are needed to access these endpoints. The following section details how to configure and add permissions to the required endpoints.

#### Add Permissions

To add permissions for the six endpoints outlined above, from the **Azure Active Directory portal**:

1. Select the application registered in the previous step.
2. Under **Manage,** click **API Permissions** and then click **Add a Permission,** the “Request API permissions” window will appear.

![Inserting image...](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-mfa-may2025-image-xcnuod9i.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A06Z&se=2026-10-30T12%3A37%3A06Z&sr=c&sp=r&sig=%2FT%2FDqDG%2B5xbqW%2BiXuUKu9J7AI79lodQGDsDFI0BvrVI%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-mfa-may2025-image-xpo8tehk.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A06Z&se=2026-10-30T12%3A37%3A06Z&sr=c&sp=r&sig=%2FT%2FDqDG%2B5xbqW%2BiXuUKu9J7AI79lodQGDsDFI0BvrVI%3D)
4. Click on **Application Permissions.** ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-mfa-may2025-image-8pcrhde0.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A06Z&se=2026-10-30T12%3A37%3A06Z&sr=c&sp=r&sig=%2FT%2FDqDG%2B5xbqW%2BiXuUKu9J7AI79lodQGDsDFI0BvrVI%3D)
5. The following permissions need to be granted for the six endpoints to function properly:

| **Event** | **Type** | **Permission** |
| --- | --- | --- |
| User Registration Details | Application | AuditLog.Read.All |
| User Registration By Feature | Application | AuditLog.Read.All |
| User Registration By Method | Application | AuditLog.Read.All |
| User Credential Usage Details | Application | Reports.Read.All |
| Credential User Registration Count | Application | Reports.Read.All |
| Credential Usage Summary | Application | Reports.Read.All |
| Devices | Application | Device.Read.All |
| Users | Application | UserAuthenticationMethod.Read.All |
| Policies | Application | Policy.Read.All GroupMember.Read.All |

In the Select permissions search bar, enter the permissions shown above one by one, and check the box for each to include it.

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-mfa-may2025-image-4jtfektv.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A06Z&se=2026-10-30T12%3A37%3A06Z&sr=c&sp=r&sig=%2FT%2FDqDG%2B5xbqW%2BiXuUKu9J7AI79lodQGDsDFI0BvrVI%3D)

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-mfa-may2025-image-lkstpric.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A06Z&se=2026-10-30T12%3A37%3A06Z&sr=c&sp=r&sig=%2FT%2FDqDG%2B5xbqW%2BiXuUKu9J7AI79lodQGDsDFI0BvrVI%3D)

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-mfa-may2025-image-3g92kt6s.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A06Z&se=2026-10-30T12%3A37%3A06Z&sr=c&sp=r&sig=%2FT%2FDqDG%2B5xbqW%2BiXuUKu9J7AI79lodQGDsDFI0BvrVI%3D)

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-mfa-may2025-image-r38s512t.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A06Z&se=2026-10-30T12%3A37%3A06Z&sr=c&sp=r&sig=%2FT%2FDqDG%2B5xbqW%2BiXuUKu9J7AI79lodQGDsDFI0BvrVI%3D)

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-mfa-may2025-image-m5bjqc3a.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A06Z&se=2026-10-30T12%3A37%3A06Z&sr=c&sp=r&sig=%2FT%2FDqDG%2B5xbqW%2BiXuUKu9J7AI79lodQGDsDFI0BvrVI%3D)

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-mfa-may2025-image-bmzw7qy2.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A06Z&se=2026-10-30T12%3A37%3A06Z&sr=c&sp=r&sig=%2FT%2FDqDG%2B5xbqW%2BiXuUKu9J7AI79lodQGDsDFI0BvrVI%3D)
6. Click the **Add permissions** button after selecting all required permissions.
7. On the “API permissions” page,

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-mfa-may2025-image-ia5mhijq.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A06Z&se=2026-10-30T12%3A37%3A06Z&sr=c&sp=r&sig=%2FT%2FDqDG%2B5xbqW%2BiXuUKu9J7AI79lodQGDsDFI0BvrVI%3D)
  1. Click **Grant Admin Consent** **for <tenant>**.
  2. Click the **Yes** button on the consent confirmation.
8. The required permissions are now added for the endpoints. The overall permissions are shown below. Ensure type is Application for all ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-mfa-may2025-image-aqnsbtcb.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A06Z&se=2026-10-30T12%3A37%3A06Z&sr=c&sp=r&sig=%2FT%2FDqDG%2B5xbqW%2BiXuUKu9J7AI79lodQGDsDFI0BvrVI%3D)

### 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 and Secrets**, and then **Client Secrets**. ![Inserting image...](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-mfa-may2025-image-jdhpp506.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A06Z&se=2026-10-30T12%3A37%3A06Z&sr=c&sp=r&sig=%2FT%2FDqDG%2B5xbqW%2BiXuUKu9J7AI79lodQGDsDFI0BvrVI%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-mfa-may2025-image-xfz522ut.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A06Z&se=2026-10-30T12%3A37%3A06Z&sr=c&sp=r&sig=%2FT%2FDqDG%2B5xbqW%2BiXuUKu9J7AI79lodQGDsDFI0BvrVI%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-mfa-may2025-image-vsswazt9.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A06Z&se=2026-10-30T12%3A37%3A06Z&sr=c&sp=r&sig=%2FT%2FDqDG%2B5xbqW%2BiXuUKu9J7AI79lodQGDsDFI0BvrVI%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-mfa-may2025-image-mm297u5q.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A06Z&se=2026-10-30T12%3A37%3A06Z&sr=c&sp=r&sig=%2FT%2FDqDG%2B5xbqW%2BiXuUKu9J7AI79lodQGDsDFI0BvrVI%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. ![Inserting image...](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-mfa-may2025-image-isha1rl7.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A06Z&se=2026-10-30T12%3A37%3A06Z&sr=c&sp=r&sig=%2FT%2FDqDG%2B5xbqW%2BiXuUKu9J7AI79lodQGDsDFI0BvrVI%3D)
2. Search for the **Microsoft Entra MFA** and click it as shown below. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-mfa-may2025-image-jro82o6f.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A06Z&se=2026-10-30T12%3A37%3A06Z&sr=c&sp=r&sig=%2FT%2FDqDG%2B5xbqW%2BiXuUKu9J7AI79lodQGDsDFI0BvrVI%3D)
3. Click on the **API Ingest** option for collection method. ![Inserting image...](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-mfa-may2025-image-h40o9wn0.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A06Z&se=2026-10-30T12%3A37%3A06Z&sr=c&sp=r&sig=%2FT%2FDqDG%2B5xbqW%2BiXuUKu9J7AI79lodQGDsDFI0BvrVI%3D)
4. Enter feed contact information and click **Next**. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-mfa-may2025-image-dhgtkrn3.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A06Z&se=2026-10-30T12%3A37%3A06Z&sr=c&sp=r&sig=%2FT%2FDqDG%2B5xbqW%2BiXuUKu9J7AI79lodQGDsDFI0BvrVI%3D)
5. In the configuration page, enter the following

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-entra-mfa-may2025-image-gy1bqzh0.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A06Z&se=2026-10-30T12%3A37%3A06Z&sr=c&sp=r&sig=%2FT%2FDqDG%2B5xbqW%2BiXuUKu9J7AI79lodQGDsDFI0BvrVI%3D)
  - Authorization Method: OAuth2
  - Client Key: paste the Application (client) ID generated earlier.
  - Client Secret: paste the Client Secret value generated earlier.
  - Token URL: replace <application_id> with your Application ID.
  - Event Types: preselected for all the event types that integration pulls.
6. Click **Submit**.

## 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 MFA scopes/permissions are correct.

#