Skip to content

Integrating Coro with Microsoft Sentinel

Use this guide to integrate Coro with Microsoft Sentinel (www.microsoft.com/en-us/security/business/siem-and-xdr/microsoft-sentinel) for collection of ticket data related to an event.

Coro connects to Microsoft Sentinel through the Logs Ingestion API. This uses Microsoft Entra ID OAuth-based authentication and utilizes DCEs (Data Collection Endpoints) and DCRs (Data Collection Rules) to filter, transform, and map incoming connections.

Prerequisites

This guide assumes you have access to the Microsoft Azure portal with admin permissions.

Before you start this procedure, make sure you have a previously-configured Log Analytics workspace in Microsoft Azure. For further information, see the Azure portal documentation.

Information for existing Sentinel users

If you have an existing Sentinel integration in Coro, be aware that Microsoft retired the previous ingestion method (from September 2026). To continue using Sentinel with Coro, you must recreate the connector using the new method described in this guide.

Coro displays a warning banner where it identifies an existing connector using the previous method:

A warning banner showing that existing Sentinel connectors need migrating

Coro does not disable Existing Sentinel connectors, but you can no longer edit the settings. Coro advises recreating the connector at the earliest opportunity to avoid service disruption.

Summary of steps

To configure Coro's Sentinel connector, you need to:

  1. Create a Data Collection Endpoint (DCE)

  2. Create a Data Collection Rule (DCR) and custom log table.

  3. Register Coro as an approved application for sending logs.

  4. Configure the Sentinel connector in Coro.

    The Coro connector configuration relies on several identifiers gathered during the previous steps in the Microsoft Azure portal. This guide advises when to keep a note of the required data items.

Creating a DCE in Azure

To create a DCE:

  1. Sign in to the Microsoft Azure portal (portal.azure.com) with adminstrative permissions.

  2. Use the search bar at the top to search for "DCE". Azure should recommend "Data collection endpoints" within the "Services" category. Select this link.

    Azure displays the Data collection endpoints page:

    Azure Data collection endpoints page
  3. Select + Create to create a new DCE.

    Azure displays the Create data collection endpoint dialog:

    Create a Data collection endpoint
  4. Enter the following details:

    • Endpoint name: Enter a name for the endpoint.
    • Subscription: Select your Azure subscription.
    • Resource group: Select the resource group used in your Log Analytics workspace.
    • Region: Select the region used in your Log Analytics workspace.
  5. Skip the Tags page and proceed to Review + create to create your new DCE.

    Azure creates the DCE and shows it on the Data collection endpoints page:

    Azure Data collection endpoints page
  6. Select your new DCE and make a note of the Logs Ingestion URL for later:

    DCE logs ingestion identifier

Creating a DCR and custom log table in Azure

To create a DCR and custom log table:

  1. Sign in to the Microsoft Azure portal (portal.azure.com) with adminstrative permissions.

  2. Use the search bar at the top to search for and select your Logs Analytics workspace.

  3. Select Settings > Tables.

    Azure displays the workspace Tables list:

    Logs Analytics workspace Tables list
  4. Select + Create.

    Azure displays the Create a custom log page:

    Create a custom log table
  5. Enter a Table name.

  6. Under Data collection rule, select Create a new data collection rule.

    Azure displays the Create a new data collection rule pane:

    Create a new DCR
  7. For the new DCR, select the same Azure subscription and resource group you used when creating your Logs Analytics workspace (and specified when creating your DCE).

  8. Enter a Name for your new DCR. Make a note of this for later.

  9. Select Done to create the DCR and automatically add it to the custom log table Data collection rule setting.

  10. For Data collection endpoint, select your DCE.

  11. Select Next.

    Azure displays the Schema and transformation step:

  12. Download this sample schema and upload to Azure.

  13. Select Next.

  14. On the Review step, make a note of the full table name for later.

  15. Select Create.

After you have created the DCR and custom log table, make a note of the Immutable ID:

  1. Use the search bar at the top to search for "DCR". Azure should recommend "Data collection rules" within the "Services" category. Select this link.

    Azure displays the Data collection rules page:

    Azure Data collection rules page
  2. Select the Data collection rules tab:

    Data collection rules tab
  3. Locate and select the DCR you created earlier.

  4. Make a note of the Immutable ID for later:

    Noting the DCR Immutable ID

Register Coro as an approved app in Azure

To register Coro as an approved app, use Microsoft Entra ID:

  1. Sign in to the Microsoft Azure portal (portal.azure.com) with adminstrative permissions.

  2. Use the search bar at the top to search for "Entra ID". Azure should recommend "Microsoft Entra ID" within the "Services" category. Select this link.

  3. On the Overview page, select + Add > App registration:

    Adding a new App registration in Entra ID

    Azure displays the Register an application dialog:

    Register an application dialog in Entra ID
  4. Enter a Name for your app.

  5. Select the account you want to use with this app.

  6. Select Register.

    After creating the app, Azure displays the app overview:

    App overview in Entra ID
  7. Make a note of the Application (client) ID and Directory (tenant) ID for later.

  8. Locate Client credentials and select Add a certificate or secret:

    Client credentials field in the app overview

    Azure displays the Certificates & secrets page, on the Client secrets tab:

    Client certificates and secrets page
  9. Select + New client secret.

    Azure displays the Add a client secret dialog:

    Add a new client secret dialog
  10. Enter a Description and Expires period that meets your requirements.

  11. Select Add.

    Azure adds the new secret to the Client secrets list.

  12. Copy the Value field for later:

    Copy the new client secret value
    Important

    You must complete this step now as the Value may not be visible after you navigate away from this page. If you need to see the value later, remove the old secret and add a new one.

After you have registered the new app, grant the app access control permission to send logs:

  1. Use the search bar at the top to search for "DCR". Azure should recommend "Data collection rules" within the "Services" category. Select this link.

    Azure displays the Data collection rules page:

    Azure Data collection rules page
  2. Select the Data collection rules tab:

    Data collection rules tab
  3. Locate and select the DCR you created earlier.

  4. Select Access control (IAM):

    Access control (IAM) link

    Azure displays the Access control (IAM) page.

  5. Select + Add > Add role assignment:

    Add new role assignment

    Azure displays the Add role assignment page.

  6. From the Role tab, use the Job function roles search bar to locate the role "Monitoring Metrics Publisher":

    Add new job function role
  7. Select this role, then select Next.

    Azure displays the Members tab:

    Add role assignment members tab
  8. For Assign access to, select User, group, or service principal.

  9. Select + Select members.

    Azure displays the Select members dialog.

  10. Search for and select the app you registered earlier:

    Select the app as a member
  11. Select Select.

  12. Select Next to continue to the Review + assign tab.

  13. Select Review + assign.

Next, configure your Resource Group with the same access control permissions:

  1. Use the search bar at the top to search for "resource group". Azure should recommend "Resource groups" within the "Services" category. Select this link.

  2. Select your resource group.

  3. In the resource group overview, select Access control (IAM):

    Select Access Control (IAM) in your resource group
  4. Repeat the previous procedure to add the same role assignment here as already completed for your DCR.

Configuring a Microsoft Sentinel connector in Coro

Important

Before you start this procedure, make sure you followed the steps in all previous sections of this guide.

To configure a Microsoft Sentinel connector in Coro:

  1. Sign in to the Coro console.

  2. From the sidebar, select Control Panel.

  3. Under Workspace, select Connectors:

    Connectors

    Coro displays the Connectors page.

  4. Select SIEM:

    The Connectors page
  5. Select ADD CONNECTOR.

    Coro displays the Add connector dialog:

    The MS Sentinel Add connector dialog
  6. Configure the following connection settings:

    • Name: Enter a suitable connector name.

    • Format: Select Azure Sentinel.

    • Tenant ID: The Directory (tenant) ID field from your registered app. See Register Coro as an approved app in Azure.

    • Client ID: The Application (tenant) ID field from your registered app. See Register Coro as an approved app in Azure.

    • Client Secret: The Value field from the client secret. See Register Coro as an approved app in Azure.

    • DCE Endpoint: The Logs Ingestion identifer from your DCE. See Creating a DCE in Azure

    • DCR Immutable ID: The Immutable ID field from your DCR. See Creating a DCR and custom log table in Azure.

    • Stream name: The custom log table name you created, prefixed with "Custom-". See Creating a DCR and custom log table in Azure.

      For example, if your table name is "Sentinel_CL" ("_CL" is added automatically by Azure to indicate a custom table), your full stream name is "Custom-Sentinel_CL".

      If you are familiar with the Azure CLI, you can optionally execute the following command to see the stream name:

      az monitor data-collection rule list -g %RESOURCE_GROUP_NAME% -o json  
      \  --query "[?immutableId=='%DCR_IMMUTABLE_ID%'].{name:name, dataFlowStreams:dataFlows[].streams, declaredStreams:keys(streamDeclarations)}" ) 
    • Apply to all customers: (MSP admin users only) Enable this option to automatically create the connector in all descendant workspaces linked to the channel workspace. Each descendant workspace then forwards events to the configured SIEM provider.

  7. Select ADD.

    Add MS Sentinel connector

    Coro sends a test event to verify your configuration. If the configuration is incorrect, Coro displays an error dialog. Select GOT IT to return to the Connectors page. Coro does not save the configuration:

    Invalid connector configuration

    If the configuration is correct, Coro creates the connector with a status of Connected:

    Successful MS Sentinel connector configuration

    For MSP channel workspaces, Coro adds the connector to the channel workspace and, if Apply to all customers is enabled, to all connected descendant workspaces.

Coro sends event data and metadata to the configured SIEM in real time. If the SIEM is unavailable, Coro cannot collect or send event data.