> For the complete documentation index, see [llms.txt](https://docs.dropzone.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dropzone.ai/integrations/data/ms_data/mssentinel_data.md).

# Microsoft Sentinel

{% hint style="success" %}
Microsoft Sentinel is an SIEM integration. SIEM integrations are used to perform analysis of any SIEM generated alerts, and/or to use generated data as part of investigation analysis.

Note that this is different from Microsoft 365/Microsoft Defender.
{% endhint %}

Dropzone AI integrates with the [Microsoft Sentinel](https://learn.microsoft.com/en-us/azure/sentinel/) security SIEM. Many customers ingest other alert sources into Microsoft Sentinel (e.g. IDPs) and integrate Dropzone into Microsoft Sentinel rather than the source systems.

### Integration Overview

To enable these integrations you will perform the following actions:

* Register a new application in Microsoft Entra Admin
* Locate your Client ID, Tenant ID, and create a Client Secret
* Assign necessary API permissions to the application
* Assign roles to the application in Microsoft Sentinel
* Locate your Workspace Name and Workspace ID

See the [Microsoft Integrations](https://docs.dropzone.ai/integrations/data/ms_data.md) page for instructions on how to register a new application, locate your Client ID and Tenant ID, and to create a Client Secret.

### Set Application Permissions

General instructions on how to assign API permissions to the application can be found in the [Microsoft Integrations](https://docs.dropzone.ai/integrations/data/ms_data.md) page.

Enabling MS Sentinel will require the following APIs and permissions:

| API             | Permissions               |
| --------------- | ------------------------- |
| Log Analytics   | `Data.Read`               |
| Microsoft Graph | `SecurityEvents.Read.All` |

To add the Log Analytics API, do the following:

* In the API permissions page, click "Add a permission"
* Navigate to "APIs my organization uses"
* In the search bar, input "Log Analytics API," and select it

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FNjVsQCjk7dQiMtTEoo9K%2Fmssentinel-api-8-1.png?alt=media" alt=""><figcaption><p>Select Log Analytics API</p></figcaption></figure>

* Click "Application permissions"
* In the search bar, input "Data.Read" and select it. Click "Add permissions"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FmGJvcw1Dqzp952bBiRLD%2Fmssentinel-api-9-1.png?alt=media" alt=""><figcaption><p>Add the Data.Read permission</p></figcaption></figure>

* Once back in the Application API permissions page, click "Grant admin consent for \[mycompany.net]"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FSjNbg9HEvtAwfwOTeRWh%2Fmssentinel-api-12-1.png?alt=media" alt=""><figcaption><p>Grant admin consent</p></figcaption></figure>

* Click "Yes"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FGPisUH5SRBVHx3ZDBcQi%2Fmssentinel-api-13-1.png?alt=media" alt=""><figcaption><p>Grant admin consent</p></figcaption></figure>

If your integration requires access to security alerts via Microsoft Graph, do the following:

* In the API permissions page, click "Add a permission"
* Under the Microsoft API header, select "Microsoft Graph"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FV10sVYaiY9FXBPUEDp3k%2Fmssentinel-api-10-1.png?alt=media" alt=""><figcaption><p>Select Microsoft Graph</p></figcaption></figure>

* Click "Application permissions"
* Check the permission "SecurityEvents.Read.All," then click "Add permissions"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2F1CBJZY6ZzKZcySnohhAv%2Fmssentinel-api-11-1.png?alt=media" alt=""><figcaption><p>Add the SecurityEvents.Read.All permission</p></figcaption></figure>

* Once back in the Application API permissions page, click "Grant admin consent for \[mycompany.net]"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FSjNbg9HEvtAwfwOTeRWh%2Fmssentinel-api-12-1.png?alt=media" alt=""><figcaption><p>Grant admin consent</p></figcaption></figure>

* Click "Yes"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FGPisUH5SRBVHx3ZDBcQi%2Fmssentinel-api-13-1.png?alt=media" alt=""><figcaption><p>Grant admin consent</p></figcaption></figure>

### Assign Roles in Microsoft Sentinel

To allow the application to access Microsoft Sentinel data, you must assign the application roles based on your desired access level.

* Navigate to [your Azure portal](https://portal.azure.com)
* Under the "Azure Services" heading, navigate to Microsoft Sentinel

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FG2NHGCAwYHuli7I3APex%2Fmssentinel-api-1.png?alt=media" alt=""><figcaption><p>Navigate to Microsoft Sentinel</p></figcaption></figure>

* Select the Log Analytics Workspace you wish to analyze

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FkvhcKJ0M4c3QBQNSpJx4%2Fmssentinel-api-10.png?alt=media" alt=""><figcaption><p>Select your workspace</p></figcaption></figure>

* Navigate to Configuration > Settings

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FdSe1IIdVEtI7qRdPOH2F%2Fmssentinel-api-14-1.png?alt=media" alt=""><figcaption><p>Navigate to Settings</p></figcaption></figure>

* Click on "Workspace settings"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2Fc9kJKfeyrAJoM1B5SUiz%2Fmssentinel-api-15-1.png?alt=media" alt=""><figcaption><p>Click on Workspace settings</p></figcaption></figure>

* Navigate to "Access control (IAM)"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FEtHW7I3tTAipuPKCoiqy%2Fmssentinel-api-16-1.png?alt=media" alt=""><figcaption><p>Click on Access control (IAM)</p></figcaption></figure>

* Select Add > Add role assignment

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2F5XXoZwTO3kcdVbCR8ov3%2Fmssentinel-api-17-1.png?alt=media" alt=""><figcaption><p>Add a role assignment</p></figcaption></figure>

* Select a [role](https://learn.microsoft.com/en-us/azure/sentinel/roles) based on your desired access level:
  * Read-only access: Log Analytics Reader or Microsoft Sentinel Reader
  * Read and write access: Microsoft Sentinel Responder or Microsoft Sentinel Contributor

{% hint style="info" %}
If you wish to enable Ticket Sync, you must assign the application a Read and write access role.
{% endhint %}

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FBeCgD30hJMmWjjaJ7Mla%2Fmssentinel-api-18-1.png?alt=media" alt=""><figcaption><p>Select your role</p></figcaption></figure>

{% hint style="info" %}
For the purpose of this documentation, the Log Analytics Reader role has been selected.
{% endhint %}

* Once you have selected your role, click "Members"
* Next to "Assign access to," select "User, group, or service principal"
* Click "Select members"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FBxfwe0ibQRpJdw2Hj3ZS%2Fmssentinel-api-19-1.png?alt=media" alt=""><figcaption><p>Click Select members</p></figcaption></figure>

* Search for your application (such as Dropzone AI Sentinel Integration) and click "Select"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2Fnoj8cLrVdiup3F74LjCG%2Fmssentinel-api-20-1.png?alt=media" alt=""><figcaption><p>Assign members</p></figcaption></figure>

* In the bottom left hand corner, click "Review + assign" twice

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FBsMpBC0DAucVegYpfMtD%2Fmssentinel-api-21-1.png?alt=media" alt=""><figcaption><p>Click Review + assign</p></figcaption></figure>

### Workspace IDs

To obtain your Workspace Name and Workspace ID, do the following:

* Navigate to [your Azure portal](https://portal.azure.com)
* Under the "Azure Services" heading, navigate to Microsoft Sentinel

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FCAFoe5hCvtgxDgSx21fH%2Fmssentinel-api-1-1.png?alt=media" alt=""><figcaption><p>Navigate to Microsoft Sentinel</p></figcaption></figure>

* Select the Workspace you wish to analyze

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FkvhcKJ0M4c3QBQNSpJx4%2Fmssentinel-api-10.png?alt=media" alt=""><figcaption><p>Select your workspace</p></figcaption></figure>

* In the left sidebar, navigate to Configuration > Settings

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FdSe1IIdVEtI7qRdPOH2F%2Fmssentinel-api-14-1.png?alt=media" alt=""><figcaption><p>Navigate to settings</p></figcaption></figure>

* Click on "Workspace Settings"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2Fc9kJKfeyrAJoM1B5SUiz%2Fmssentinel-api-15-1.png?alt=media" alt=""><figcaption><p>Navigate to settings</p></figcaption></figure>

* Copy the Workspace ID, Subscription ID, and Resource Group shown for use later in the Dropzone UI

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FhXic4uPHj4Gg4JpWDZhS%2Fmssentinel-api-13.png?alt=media" alt=""><figcaption><p>Copy the integration details</p></figcaption></figure>

## Enable Microsoft Sentinel

To enable the Data Source integration, you will need the following information:

| Dropzone Field  | Source                                 |
| --------------- | -------------------------------------- |
| Client ID       | The Application ID copied earlier      |
| Tenant ID       | The Directory ID copied earlier        |
| Client Secret   | The Client Secret Value copied earlier |
| Workspace ID    | The Workspace ID copied earlier        |
| Subscription ID | The Subscription ID copied earlier     |
| Resource Group  | The Resource group copied earlier      |

To enable the Data Source integration, do the following:

* Navigate to your Dropzone AI tenant home page e.g. https\://*mycompany*.dropzone.app
* In the left side bar, navigate to Platform Settings > Integrations

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FQKQGU2YK0KqsewZWvh0i%2Fui-integrations-dropdown.png?alt=media" alt=""><figcaption><p>Integrations Dropdown</p></figcaption></figure>

* Click "Library"

{% hint style="info" %}
If you have previously integrated this application, click "Configured"
{% endhint %}

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2Fx4O3FuRG5IqPwx5sFuHr%2Fapp_system_integrations_library.png?alt=media" alt=""><figcaption><p>Click Library</p></figcaption></figure>

* In the Search bar, search Microsoft Sentinel, then click "Configure"

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FAcaaSTtufgP2qx90Zdcf%2Fapp_system_integrations_available_Microsoft_Sentinel.png?alt=media" alt=""><figcaption><p>The Microsoft Sentinel Tile</p></figcaption></figure>

* Under the Data Source heading, input the Client ID, Tenant ID, and Client Secret
* Select your Microsoft Cloud Environment from the dropdown

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FCynovcDBagIlm3OONaqs%2Fapp_system_integrations_available_mssentinel_data_config.png?alt=media" alt=""><figcaption><p>The Microsoft Sentinel Data Integration pt 1</p></figcaption></figure>

* Under the Workspaces heading, click "Add item." Input the details of your workspace
* If you have multiple workspaces, click "Add item" for each one

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2Ftqg01yvFbgk2CVvDjpQu%2Fapp_system_integrations_available_mssentinel_data_config-1.png?alt=media" alt=""><figcaption><p>The Microsoft Sentinel Data Integration pt 2</p></figcaption></figure>

* If you wish to help guide the AI's information gathering process, enable the [Query Guidance](https://docs.dropzone.ai/integrations/data) feature. Click "Add Item" and input your Condition and Instruction pairs

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FcYfD24VJsFX1ZjoP5UDb%2Fintegration-query-guidance.png?alt=media" alt=""><figcaption><p>The Datadog Data Source Configuration (pt 2)</p></figcaption></figure>

* Click "Test & Save" to finish

<figure><img src="https://3968177484-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDt9gEGwbp9ApiQAJP3hQ%2Fuploads%2FzlXvpTSeEcWS1gYQgTan%2Fui-test-and-save.png?alt=media" alt=""><figcaption></figcaption></figure>

If you have any errors contact our Customer Success team.
