# Microsoft 365 Integration

This guide shows how to enable Microsoft 365 API access in CybrHawk SIEM.

> **Requirements:**
>
> * Access to Microsoft 365 services, including Microsoft 365 Compliance Center and Microsoft Entra ID
> * Any Microsoft 365 licensing tier

Click any screenshot to open the full-size image.

***

## Step 1: Enable auditing in Microsoft 365

Enable auditing before you continue. Follow Microsoft’s guide to [turn auditing on or off](https://learn.microsoft.com/en-us/purview/audit-log-enable-disable).

***

## Step 2: Register an application in Entra ID

1. Download CybrHawk’s Entra ID integration certificate from the SOC team.
2. Sign in to the [Entra ID portal](https://portal.azure.com).
3. Open **Microsoft Entra ID**

<figure><img src="/files/znwxpj2SD9UknYk94ctU" alt=""><figcaption></figcaption></figure>

4. Select **App registrations** and click **New registration**

<figure><img src="/files/wFOv7JxMraImHf3iQqhF" alt=""><figcaption></figcaption></figure>

5. Enter the required details, then click **Register**

<figure><img src="/files/YCz9CU9moYWBWcw24O0a" alt=""><figcaption></figcaption></figure>

6. Save the **Application (client) ID** and **Directory (tenant) ID** for later

<figure><img src="/files/JqqMEidqiY2zJ85VkBAn" alt=""><figcaption></figcaption></figure>

7. Open **Certificates & secrets**.

<figure><img src="/files/FudHRnjeFMgY0AUlLrBt" alt=""><figcaption></figcaption></figure>

8. Click **Upload certificate**

<figure><img src="/files/qurYnZCvqkFJvGM1kpkL" alt=""><figcaption></figcaption></figure>

9. Upload the certificate from step 1, then click **Add**.

***

## Step 3: Grant API Permissions

1. After creating the application, grant permissions to the Office 365 Management APIs

<figure><img src="/files/gXrYeOrqySLKWJnuirwV" alt=""><figcaption></figcaption></figure>

1. Open **API permissions** and select **Office 365 Management APIs**

<figure><img src="/files/Fnew7cJ9XqZSsMBqAj1o" alt=""><figcaption></figcaption></figure>

1. Select **Application permissions** and enable the following:

```
ActivityFeed.Read
ActivityFeed.ReadDlp
```

4. Click **Grant admin consent** and confirm

<figure><img src="/files/A48vZeBVDMaHqziSqpja" alt=""><figcaption></figcaption></figure>

***

## Step 4: Configure CybrHawk SIEM

1. Log in to the **CybrHawk SIEM Portal**.
2. Go to **Deployments** > **Integrations**.
3. Click **Add** and select **Microsoft 365**.

***

## Step 5: Add Microsoft Graph Integration

For advanced security auditing, Defender event ingestion, and user isolation features, complete the [MS365 Graph API](/cybrhawk-docs/microsoft-365/ms-graph.md).

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://cybrhawksoc.gitbook.io/cybrhawk-docs/microsoft-365/microsoft-365.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
