---
title: "Azure Tenant Activity"
slug: "azure-tenant-activity"
updated: 2025-11-04T19:58:18Z
published: 2025-11-04T19:58:18Z
canonical: "docs.databee.buzz/azure-tenant-activity"
---

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

# Azure Tenant Activity

Azure Tenant Activity Logs provide a comprehensive record of actions, capturing operations that impact resources, such as creating, updating, or deleting resources at tenant level. For details, refer to [Microsoft’s official documentation](https://learn.microsoft.com/en-us/rest/api/monitor/tenant-activity-logs?view=rest-monitor-2015-04-01).

**Integration Method:** API

**Tables**: Entity Management (3004)

This integration supports the following events.

| **Event** | **Description** |
| --- | --- |
| Tenant Activity | Gets the Activity Logs for the Tenant. |

This integration supports the following versions.

| Azure Tenant Activity API version | 2015-04-01 |
| --- | --- |

> [!NOTE]
> **Note:**
> 
> Azure Activity is a continuously updated cloud service. As for this document preparation, the latest release was in [July 2025](https://azure.microsoft.com/en-us/updates).

## 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/azure-tenant-activity-new#create-an-application) with required permissions to fetch the data
2. Add the [Azure Tenant Activity data feed](/user-manual/docs/azure-tenant-activity-new#databee-configuration) in the DataBee console with the below parameters.

| **DataBee Parameter** | **Azure Parameter** |
| --- | --- |
| Client Key | Application (client ID) |
| Client Secret | Client secret |
| Token URL(<tenant_id>) | Directory (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** role.
2. In the **search bar**, search for **App registrations** and select it.

![Picture 1860176046, Picture](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/azure-tenant-activity---api-ingest-image-272hba9e.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A39Z&se=2026-10-30T12%3A38%3A39Z&sr=c&sp=r&sig=0Vq4Wkn0ZtsAZwqCmTp7Gu2UYB%2BWg3njw4AD%2F7FsOwE%3D)
3. On the “Register an application” window:

![Picture 612821350, Picture](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/azure-tenant-activity---api-ingest-image-3xq4lyfn.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A39Z&se=2026-10-30T12%3A38%3A39Z&sr=c&sp=r&sig=0Vq4Wkn0ZtsAZwqCmTp7Gu2UYB%2BWg3njw4AD%2F7FsOwE%3D)
  1. Under **Name,** enter your Application Name then click on **Register** to create the application.
4. On the app **Overview** page, copy the **Application (client) ID** and **Directory (tenant) ID** for later use.

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/image(413).png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A39Z&se=2026-10-30T12%3A38%3A39Z&sr=c&sp=r&sig=0Vq4Wkn0ZtsAZwqCmTp7Gu2UYB%2BWg3njw4AD%2F7FsOwE%3D)
5. Login on to [Azure](https://portal.azure.com/) portal with an account that has the **Global Administrator** role. In the search bar check for **subscriptions** and select it.

![Picture 259221383, Picture](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/azure-tenant-activity---api-ingest-image-rvk07qf0.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A39Z&se=2026-10-30T12%3A38%3A39Z&sr=c&sp=r&sig=0Vq4Wkn0ZtsAZwqCmTp7Gu2UYB%2BWg3njw4AD%2F7FsOwE%3D)
6. Select the **Subscription** name as shown below. ![Picture 1190632405, Picture](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/image-1761889879324.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A39Z&se=2026-10-30T12%3A38%3A39Z&sr=c&sp=r&sig=0Vq4Wkn0ZtsAZwqCmTp7Gu2UYB%2BWg3njw4AD%2F7FsOwE%3D)
7. On the **Overview** page, copy the **Subscription ID** for later use.

![Picture 751417398, Picture](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/azure-tenant-activity---api-ingest-image-rbnqeyzt.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A39Z&se=2026-10-30T12%3A38%3A39Z&sr=c&sp=r&sig=0Vq4Wkn0ZtsAZwqCmTp7Gu2UYB%2BWg3njw4AD%2F7FsOwE%3D)

### Add Endpoint Access

Once the application is created, three permissions should be provided 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**

Open Azure CLI and run below command to assign root level permission the application created from previous step to fetch tenant logs.

```plaintext
az role assignment create --assignee <client-id> --role Reader --scope "/"
```

Verify if the clientId is assigned with root permission by referring following steps. From the **Azure Active Directory portal**:

1. Search for **Management groups** 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/azure-tenant-activity---api-ingest-image-t48g51c6.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A39Z&se=2026-10-30T12%3A38%3A39Z&sr=c&sp=r&sig=0Vq4Wkn0ZtsAZwqCmTp7Gu2UYB%2BWg3njw4AD%2F7FsOwE%3D)
2. Select **Tenant Root Group**. ![A screenshot of a computer AI-generated content may be incorrect.](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/image-1761889975352.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A39Z&se=2026-10-30T12%3A38%3A39Z&sr=c&sp=r&sig=0Vq4Wkn0ZtsAZwqCmTp7Gu2UYB%2BWg3njw4AD%2F7FsOwE%3D)
3. Select **Access Control (IAM)** from left menu and you should be seeing client added with root level scope. ![A screenshot of a computer AI-generated content may be incorrect.](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/image-1761890048644.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A39Z&se=2026-10-30T12%3A38%3A39Z&sr=c&sp=r&sig=0Vq4Wkn0ZtsAZwqCmTp7Gu2UYB%2BWg3njw4AD%2F7FsOwE%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**. ![Picture 1545205779, Picture](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/azure-tenant-activity---api-ingest-image-y4k62rvg.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A39Z&se=2026-10-30T12%3A38%3A39Z&sr=c&sp=r&sig=0Vq4Wkn0ZtsAZwqCmTp7Gu2UYB%2BWg3njw4AD%2F7FsOwE%3D)
3. Click **New client secret**. Then “Add a client secret” window appears. ![Picture 1476844340, Picture](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/azure-tenant-activity---api-ingest-image-ypo5q3i0.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A39Z&se=2026-10-30T12%3A38%3A39Z&sr=c&sp=r&sig=0Vq4Wkn0ZtsAZwqCmTp7Gu2UYB%2BWg3njw4AD%2F7FsOwE%3D)
4. On “Add a client secret” window:

![Picture 85534202, Picture](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/azure-tenant-activity---api-ingest-image-uszjr8a9.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A39Z&se=2026-10-30T12%3A38%3A39Z&sr=c&sp=r&sig=0Vq4Wkn0ZtsAZwqCmTp7Gu2UYB%2BWg3njw4AD%2F7FsOwE%3D)

> [!NOTE]
> **Note**:
> 
> The user needs to re-create the client secret when it expires.
  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.
5. Copy the **Value** fields for later use. ![Picture 1710568377, Picture](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/azure-tenant-activity---api-ingest-image-efvm6x2c.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A39Z&se=2026-10-30T12%3A38%3A39Z&sr=c&sp=r&sig=0Vq4Wkn0ZtsAZwqCmTp7Gu2UYB%2BWg3njw4AD%2F7FsOwE%3D)

This completes the setup for Azure Activity API integration.

## 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/azure-tenant-activity---api-ingest-image-mrftafvm.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A39Z&se=2026-10-30T12%3A38%3A39Z&sr=c&sp=r&sig=0Vq4Wkn0ZtsAZwqCmTp7Gu2UYB%2BWg3njw4AD%2F7FsOwE%3D)
2. Search for the **Azure Tenant Activity** 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/azure-tenant-activity---api-ingest-image-u2nvhkwr.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A39Z&se=2026-10-30T12%3A38%3A39Z&sr=c&sp=r&sig=0Vq4Wkn0ZtsAZwqCmTp7Gu2UYB%2BWg3njw4AD%2F7FsOwE%3D)
3. Click on the **API Ingest** option for collection method. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/azure-tenant-activity---api-ingest-image-ti6nym5q.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A39Z&se=2026-10-30T12%3A38%3A39Z&sr=c&sp=r&sig=0Vq4Wkn0ZtsAZwqCmTp7Gu2UYB%2BWg3njw4AD%2F7FsOwE%3D)
4. Enter feed contact information and click **Next**. ![A screenshot of a computer AI-generated content may be incorrect.](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/azure-tenant-activity---api-ingest-image-fif5q2t4.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A39Z&se=2026-10-30T12%3A38%3A39Z&sr=c&sp=r&sig=0Vq4Wkn0ZtsAZwqCmTp7Gu2UYB%2BWg3njw4AD%2F7FsOwE%3D)
5. In the configuration page, confirm the following:

![A screenshot of a computer AI-generated content may be incorrect.](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/azure-tenant-activity---api-ingest-image-asjsbrlo.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A38%3A39Z&se=2026-10-30T12%3A38%3A39Z&sr=c&sp=r&sig=0Vq4Wkn0ZtsAZwqCmTp7Gu2UYB%2BWg3njw4AD%2F7FsOwE%3D)
  - **API Base URL:** This is the base URL that DataBee will interact with
  - **Client Key:** Paste the Application (Client) ID generated previously
  - **Client Secret:** Paste the Client Secret generated previously
  - **Token URL:** Replace <tenant_id> placeholder with your Directory (Tenant) ID
  - **Event Types:** Preselected for all the event types that integration pulls
6. Click **Submit**.

## 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 response code - 403 this might be possibly due to missing permissions. Ensure that all the required permissions are granted correctly as per the above-mentioned steps.

#