Microsoft Sentinel
Developer and API

Setup Azure Storage Connector

In brief

The page’s date and authoring metadata were updated, and descriptions of the queue-based blob-pointer model and service-principal authentication were refreshed.

What Defender admins need to know

No administrator action is indicated.

Summaries are generated from the documentation change itself.

Documentation change

The comparison below shows only the changed extract. Use the full-page view for complete context.

#customer intent: As a security engineer, I want to set up an Azure Storage Blob connector so that I can ingest logs from Azure Storage into Microsoft Sentinel.

Connector resource overview

The Azure Storage Blob connector uses a queue-based blob-pointer model to subscribe to blob-created events in your storage account. An Event Grid system topic subscription listens for blob creation activity and pushes events, based on configurable filtering criteria, to an Azure Storage queue. Multiple connector instances can ingest from the same container while scoping files by folder and file pattern. You can control filtering through the portal or the connector ARMAzure Resource Manager (ARM) template by setting blob prefix and suffix patterns.

:::image type="content" source="./media/setup-azure-storage-connector/overview-diagram.png" lightbox="./media/setup-azure-storage-connector/overview-diagram.png" alt-text="A diagram showing the Azure Storage Blob connector architecture, including blob created events, Event Grid, storage queue, and Microsoft Sentinel ingestion flow.":::

  • Fetches files from the Azure Storage Blob container based on the path in the queue message.
  • Deletes the queue message after successful forwarding.

The connector authenticates to the Storage Account by using a service principal accessible to the connector application. For the application IDs per cloud and the full template schema, see the Azure Storage Blob connectors API reference. Use the ARM template automation to verify that the connector service principal exists and to apply the required role assignments on the storage account.

Create an Azure Storage Blob connector