---
title: "Microsoft Purview"
slug: "microsoft-purview"
updated: 2026-05-22T14:07:36Z
published: 2026-05-22T14:07:36Z
canonical: "docs.databee.buzz/microsoft-purview"
---

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

**Microsoft Purview** is a unified data governance and compliance platform that provides APIs for managing data assets across hybrid and multi-cloud environments. Purview supports automated data discovery, classification, and lineage tracking to maintain a centralized metadata catalog, and it integrates with compliance and security services to enforce policies such as data classification, access control, and Data Loss Prevention (DLP).

More information can be found at [Microsoft Purview](https://learn.microsoft.com/en-us/rest/api/purview/?view=rest-purview-scanningdataplane-2023-09-01) Website page.

**Integration Method:** API Ingest

**Tables**: Entity Management (3004), Scan Activity (6007), Cloud Resource Inventory info (5023)

This integration supports the following events.

| **Event** | **Description** |
| --- | --- |
| Scan run History | Retrieves the execution details of data source scans, including status, timestamps, and outcomes of each scan run. |
| Policies | Captures the creation, update, or deletion of governance and compliance policies. |

> [!NOTE]
> **Note**:
> 
> This feed must be initially onboarded to the **staging environment** prior to production. Contact your support team for questions

## 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 with the required roles to fetch the data.
2. Create [Microsoft Purview Feed](/docs/microsoft-purview#purview_config) in the DataBee console with the required Client credentials.

| **DataBee Parameter** | **Azure Parameter** |
| --- | --- |
| Client Key | [Application (client) ID](/docs/microsoft-purview#client_id_and_tenant_id) |
| Client Secret | [Client Secret Value](/docs/microsoft-purview#client_secret) |
| Token URL(<tenant_id>) | [Directory (Tenant) ID](/docs/microsoft-purview#client_id_and_tenant_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. ![A screenshot of a computer AI-generated content may be incorrect.](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-purview-image-fx9x772n.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A07%3A29Z&se=2026-10-30T13%3A07%3A29Z&sr=c&sp=r&sig=oIFETCvcqqIRlliIVeAiUeJRmU4UauRwAp8YVELVdec%3D)
3. On the **App registrations** page, select **New registration**, the **Register an application** window will appear. ![A screenshot of a computer AI-generated content may be incorrect.](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-purview-image-tpfizgp7.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A07%3A29Z&se=2026-10-30T13%3A07%3A29Z&sr=c&sp=r&sig=oIFETCvcqqIRlliIVeAiUeJRmU4UauRwAp8YVELVdec%3D)
4. On the **Register an application** window:

Under **Name**, enter your Application Name then click on **Register** to create the application.

![A screenshot of a computer AI-generated content may be incorrect.](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-purview-image-e03rqail.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A07%3A29Z&se=2026-10-30T13%3A07%3A29Z&sr=c&sp=r&sig=oIFETCvcqqIRlliIVeAiUeJRmU4UauRwAp8YVELVdec%3D)
5. On the app **Overview** page, copy the **Application (client) ID** and **Directory (tenant) ID** for later use. ![A screenshot of a computer AI-generated content may be incorrect.](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-purview-image-09g8z2iu.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A07%3A29Z&se=2026-10-30T13%3A07%3A29Z&sr=c&sp=r&sig=oIFETCvcqqIRlliIVeAiUeJRmU4UauRwAp8YVELVdec%3D)

### Create the Client Secret

The final step in 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**. ![A screenshot of a computer AI-generated content may be incorrect.](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-purview-image-o4tp9kca.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A07%3A29Z&se=2026-10-30T13%3A07%3A29Z&sr=c&sp=r&sig=oIFETCvcqqIRlliIVeAiUeJRmU4UauRwAp8YVELVdec%3D)
3. Click **New client secret**. Then **Add a client secret** window appears. ![A screenshot of a computer AI-generated content may be incorrect.](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-purview-image-vivca4mx.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A07%3A29Z&se=2026-10-30T13%3A07%3A29Z&sr=c&sp=r&sig=oIFETCvcqqIRlliIVeAiUeJRmU4UauRwAp8YVELVdec%3D)
4. On **Add a client secret** window:

Enter a **Description** for this client secret and select the desired expiry period from the **Expires** drop-list.

Then click on **Add** to create the client secret. ![A screenshot of a computer AI-generated content may be incorrect.](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-purview-image-wwz8o9yq.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A07%3A29Z&se=2026-10-30T13%3A07%3A29Z&sr=c&sp=r&sig=oIFETCvcqqIRlliIVeAiUeJRmU4UauRwAp8YVELVdec%3D)

> [!NOTE]
> **Note:**
> 
> The user needs to re-create the client secret when it expires.
5. Copy the **Value** fields for later use. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-purview-image-h35z8pdr.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A07%3A29Z&se=2026-10-30T13%3A07%3A29Z&sr=c&sp=r&sig=oIFETCvcqqIRlliIVeAiUeJRmU4UauRwAp8YVELVdec%3D)

### Add Roles

Once the application is created in the Microsoft Azure Portal, it must be granted the appropriate roles in Microsoft Purview to access and retrieve data from endpoint. Assigning roles to the application’s service principal ensures it has the necessary roles to interact with Purview endpoints. The following section outlines how to configure and assign the required roles within Purview.

#### Granting Roles

Log in into your [**Microsoft Purview Portal**](https://web.purview.azure.com/resource/dx-iddl-uat/main/datashare/shares?feature.tenant=906aefe9-76a7-4f65-b82d-5ec20775d5aa):

1. Navigate to **Settings → Account** and copy the **Resource Name**. This value should be used as the domain in the Microsoft Purview endpoint.

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-purview-image-6iucud26.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A07%3A29Z&se=2026-10-30T13%3A07%3A29Z&sr=c&sp=r&sig=oIFETCvcqqIRlliIVeAiUeJRmU4UauRwAp8YVELVdec%3D)
2. Select the **data map** icon on left.
3. Then navigate to **Collection**. Click on **Role assignments**.
4. Select **Collection admins** and **Data source admins** roles from the drop down. Both roles are assigned to provide full access to collection data and scan/data source operations in Microsoft Purview.
5. Search the **application name** created on previous step in the dialogue box on left, then click **Ok**.

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-purview-image-g6axb2ym.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A07%3A29Z&se=2026-10-30T13%3A07%3A29Z&sr=c&sp=r&sig=oIFETCvcqqIRlliIVeAiUeJRmU4UauRwAp8YVELVdec%3D)

## DataBee Configuration

1. Login to the DataBee UI, navigate to **Data** > **Data Feeds** and click the **Add New Data Feed** button. ![A screenshot of a computer AI-generated content may be incorrect.](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-purview-image-pgm62op8.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A07%3A29Z&se=2026-10-30T13%3A07%3A29Z&sr=c&sp=r&sig=oIFETCvcqqIRlliIVeAiUeJRmU4UauRwAp8YVELVdec%3D)
2. Search for the **Microsoft Purview** and click it as shown below. ![A screenshot of a computer AI-generated content may be incorrect.](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-purview-image-9q2cer54.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A07%3A29Z&se=2026-10-30T13%3A07%3A29Z&sr=c&sp=r&sig=oIFETCvcqqIRlliIVeAiUeJRmU4UauRwAp8YVELVdec%3D)
3. Click on the **API Ingest** option for collection method. ![A screenshot of a computer AI-generated content may be incorrect.](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-purview-image-b2738qep.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A07%3A29Z&se=2026-10-30T13%3A07%3A29Z&sr=c&sp=r&sig=oIFETCvcqqIRlliIVeAiUeJRmU4UauRwAp8YVELVdec%3D)
4. Enter **feed contact information** and scroll down. ![A screenshot of a computer AI-generated content may be incorrect.](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-purview-image-w0awafvq.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A07%3A29Z&se=2026-10-30T13%3A07%3A29Z&sr=c&sp=r&sig=oIFETCvcqqIRlliIVeAiUeJRmU4UauRwAp8YVELVdec%3D)
5. This feed is currently in BETA. Set the environment to **Staging**. Contact DataBee support for more information.

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-purview-image-8kmb5cii.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A07%3A29Z&se=2026-10-30T13%3A07%3A29Z&sr=c&sp=r&sig=oIFETCvcqqIRlliIVeAiUeJRmU4UauRwAp8YVELVdec%3D)
6. In the configuration section, enter the following:
  - **Authorization Method**: OAuth2
  - **API Base URL**: Replace the <domain> with the domain name in purview portal.
  - **Client Key:** Paste the [Client ID](/docs/microsoft-purview#client_id_and_tenant_id) generated earlier in the Azure portal.
  - **Client Secret**: Paste the [Client Secret](/docs/microsoft-purview#client_secret) value generated earlier in the Azure portal.
  - **Token URL:** Replace <tenant_id> with your [Directory (Tenant) ID](/docs/microsoft-purview#client_id_and_tenant_id).
  - **Event Types**: Preselected for all the event types that integration pulls. ![A screenshot of a computer AI-generated content may be incorrect.](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-purview-image-ljktuahu.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A07%3A29Z&se=2026-10-30T13%3A07%3A29Z&sr=c&sp=r&sig=oIFETCvcqqIRlliIVeAiUeJRmU4UauRwAp8YVELVdec%3D)
7. Click on **Test Connection**, once the **connection is successful**, as shown below. Click **Submit**.

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/microsoft-purview-image-27t8jtye.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A07%3A29Z&se=2026-10-30T13%3A07%3A29Z&sr=c&sp=r&sig=oIFETCvcqqIRlliIVeAiUeJRmU4UauRwAp8YVELVdec%3D)

## Troubleshooting Tips

- If you are facing an **invalid client** or **unauthorized client** error, this might be possibly due to incorrect credentials. Ensure the client key, client secret and Tenant ID are pasted correctly. Since you cannot view the client secret after the 1st time, re-create it, paste it on a text editor to ensure no spaces or unexpected characters are included and reconfigure the DataBee feed.
- If you are facing a 403-response code, this might be possibly due to missing roles. Ensure that all the required roles are assigned correctly as per the above-mentioned steps.