Overview

The Azure Sentinel integration uses the Microsoft Sentinel REST API to read:

  • Incidents and their lifecycle changes
  • Analytics rule alerts and entity mappings
  • Bookmarks and investigation comments
  • Watchlist updates

This is useful when Sentinel acts as a primary detection engine and you want to correlate its incidents alongside other Atatus telemetry.


Prerequisites

  • A Microsoft Sentinel-enabled Log Analytics workspace.
  • An Azure AD app registration with permission to read Sentinel data (Microsoft Sentinel Reader role on the resource group or workspace).

Step 1: Register an app in Azure AD

  1. In the Azure portal, open Microsoft Entra ID → App registrations → New registration.
  2. Name it atatus-sentinel-reader and click Register.
  3. Copy the Application (client) ID and Directory (tenant) ID from the Overview page.
  4. Open Certificates & secrets → New client secret, copy the secret Value.

Step 2: Grant Sentinel access

  1. Open the Resource group that contains the Sentinel workspace (or the workspace itself).
  2. Go to Access control (IAM) → Add role assignment.
  3. Choose the role Microsoft Sentinel Reader, then assign it to the app you registered.

Step 3: Connect Azure Sentinel in Atatus

  1. In Atatus, go to Security → Cloud SIEM → Integrations.
  2. Locate the Azure Sentinel card and click Connect.
  3. Fill in the form:
Field Description Example
Tenant ID Directory (tenant) ID. 00000000-0000-0000-0000-000000000000
Client ID App registration client ID. 11111111-1111-1111-1111-111111111111
Client Secret The client secret value. ••••••••
Subscription ID Subscription containing the workspace. 22222222-2222-2222-2222-222222222222
Resource Group Resource group of the workspace. rg-security
Workspace Name Log Analytics workspace name. sentinel-prod
Poll Interval (minutes) How often to fetch new incidents. 5
Enabled Turn collection on. true
  1. Click Connect.

Verification

  • The Azure Sentinel card shows Configured.
  • Sentinel incidents and alerts appear in Security → Cloud SIEM → Audit Logs → Events with source azure_sentinel.