.png)
Microsoft Sentinel Integration Guide
Integrate Microsoft Sentinel with enterprise systems through Azure REST APIs, Log Analytics KQL queries, Entra ID OAuth 2.0, and selected Logic Apps automation callbacks.
Microsoft Sentinel integration options at a glance
Microsoft Sentinel provides Azure Resource Manager REST APIs for incidents, alerts, analytics rules, watchlists, bookmarks, data connectors, and automation rules. Its Azure Monitor Log Analytics Query API supports KQL-based access to workspace data. Sentinel automation rules and Logic Apps playbooks can provide selected event-driven callbacks to a Martini API, although coverage depends on the configured trigger and playbook. Microsoft Entra ID OAuth 2.0 and Azure RBAC govern access. Martini can orchestrate scheduled polling, API calls, callback processing, pagination, checkpointing, transformation, enrichment, and controlled writes to downstream systems.
Common Microsoft Sentinel integration patterns
Common Microsoft Sentinel data objects used in integrations
Authentication and security considerations
Microsoft Entra ID and Azure RBAC
Microsoft Sentinel integrations generally use Entra ID OAuth 2.0 bearer tokens. Server-to-server Martini workflows can use client credentials with a secret or certificate, while delegated access is appropriate when an integration acts for a signed-in user.
Azure Resource Manager APIs commonly use the Azure management resource audience. Log Analytics query access also requires Entra authorization. Assign the narrowest practical Sentinel role and Azure RBAC scope, such as Microsoft Sentinel Reader, Responder, or Contributor, according to the operation.
Secrets and permissions
- Store client credentials, certificates, tenant IDs, subscription IDs, resource groups, and workspace identifiers in Martini secrets or environment configuration.
- Separate read-only querying from workflows that create or update incidents, watchlists, or automation configuration.
- Do not treat a workspace ID as a credential, and never log tokens or client secrets.
Operational considerations for Microsoft Sentinel integrations
Reliability and scale
- Keep Sentinel API versions configurable because versions differ by resource and may include stable or preview behavior.
- Follow pagination and continuation links; use bounded KQL time windows, explicit projections, and batch queries where appropriate.
- Handle Azure throttling with Retry-After support, exponential backoff, bounded concurrency, and separate retry policies for authentication, transient server, and validation errors.
- Use incident or alert IDs as idempotency keys and retain overlap windows around checkpoints to account for ingestion delay.
Data and schema behavior
- Decide whether downstream systems receive incidents, alerts, or incidents with related alerts because these objects are not interchangeable.
- Normalize Azure timestamps to UTC and tolerate missing optional fields, new entity types, and additional evidence.
- Capture HTTP status, Azure correlation identifiers, source object IDs, query context, retry counts, and target IDs without recording unnecessary sensitive payloads.
Testing
Test API permissions, pagination, throttling, duplicate delivery, delayed ingestion, malformed callback payloads, schema changes, and target-system failures with representative Sentinel objects and KQL results.
Why use Martini instead of scripts or point-to-point integrations?
Orchestration instead of isolated scripts
Martini provides a maintainable workflow layer around Sentinel REST APIs, Log Analytics queries, Logic Apps callbacks, and downstream applications. Teams can keep authentication, pagination, transformation, business rules, retries, checkpoints, and monitoring in reusable integration assets rather than duplicating them across scripts.
Controlled APIs and reusable models
Martini can expose a controlled API that abstracts Sentinel operations for internal consumers, normalize incidents and alerts into canonical models, and apply consistent authorization and validation before data reaches target systems.
Operational consistency
- Support scheduled, event-driven, and API-led integration patterns in one platform.
- Centralize mapping, enrichment, idempotency, retry, and exception handling.
- Keep environment-specific credentials, resource scopes, and API versions configurable for safer deployment and maintenance.