> ## Documentation Index
> Fetch the complete documentation index at: https://doc.qbilon.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Entra ID

> Set up Microsoft Entra ID access and configure the connector.

## Configuration

Importing data from Microsoft Entra ID (formerly "Azure AD") requires the following information:

| **Name** | **Explanation** |
| - | - |
| Client ID | the application's client ID |
| Tenant ID | the application's tenant ID |
| Client Secret | the application's client secret |
| Execution Settings | The import execution pattern can be set to "Onetime", "Scheduled" (recurring according to certain time interval) or "Dependency" (each time after a specific other data source is executed). |

**Table**: Microsoft Entra ID Connector Settings

## Access Credentials

The Qbilon Microsoft Entra ID connector uses authentication via Client ID, Client Secret and Tenant ID.

1. Create a new application in the Microsoft Entra ID in "App registration".
2. Create a new "Client secret" value with a description under the "Certificates & secrets" item. The temporarily visible "Value" is the client secret that is needed for authentication.
3. In "Overview" you will find the Application (client) ID as well as the Directory (tenant) ID that must be specified for authentication using the API.
4. Due to increased requirements, further API permissions must be assigned for the application:
   1. Add a new permission by clicking on "+ Add a permission" and select Microsoft Graph (Figures 1 and 2). Furthermore, application permissions must be granted (Figure 3).
   2. Read permission for the following types have to be set (read-only, your data is not altered):
      * User.Read.All
      * AdministrativeUnit.Read.All
      * Group.Read.All
      * Application.Read.All
      * GroupMember.Read.All
      * Organization.Read.All
      * Directory.Read.All

![Microsoft Entra ID: Access Credentials](https://mintcdn.com/qbilon-docs/lr-P4KF_9wn8x9Vs/.gitbook/assets/ebe2cde4-36e7-4690-b054-1e31201badba-image.png?fit=max\&auto=format\&n=lr-P4KF_9wn8x9Vs\&q=85\&s=7119f1873f9e3cf95d8befabcf64d0d0)

**Figure 1**: Entra ID "+ Add a permission" Field

![Microsoft Entra ID: Access Credentials](https://mintcdn.com/qbilon-docs/aJQhbcvq7mtvhV0w/.gitbook/assets/31d016ec-27e7-4c96-809d-dcd80f646f4a-image.png?fit=max\&auto=format\&n=aJQhbcvq7mtvhV0w\&q=85\&s=c83dd53620f4bc7c551a4176f7b1d4e6)

**Figure 2**: Entra ID API

![Microsoft Entra ID: Access Credentials](https://mintcdn.com/qbilon-docs/Jmla3tEw4FRYjkNT/.gitbook/assets/55a6780a-8636-4b3e-bd41-eed20bfd2af8-image.png?fit=max\&auto=format\&n=Jmla3tEw4FRYjkNT\&q=85\&s=c831c9a015c898127d7a3c3346cde2c0)

**Figure 3**: Entra ID Application Permission

After the automation task has been added and executed, you can click on the task tile to see its details on the right panel. Here, Qbilon shows the three tabs "Data Source Details", "Warning & Errors" (cf. [Warnings and Errors](https://doc.qbilon.io/06-data-sources/warnings-errors.md) chapter) and "Execution Details".


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.