Skip to main content

Microsoft Sentinel Integration

Integration Guide: Connecting Microsoft Sentinel with HiperAI This guide describes the necessary steps to configure Microsoft Sentinel to receive security logs from SecureAI via Azure Data Collection Rules (DCR).

Step 1: Create the Application Identity (App Registration)

First, we’ll create an identity for your application in Azure, allowing it to authenticate securely.

A. Go to Azure Active Directory

In the Azure portal, search for and select Azure Active Directory.
Azure Active Directory Search

B. New Registration

On the left menu, navigate to App registrations and click + New registration.
App Registrations Menu

C. Name the Application

Provide a clear name, such as SecureAI-Log-Ingester and leave the other options as their defaults. Click Register.
App Registration Form

D. Copy the IDs

From the new application’s Overview page, copy and securely store the following values:
  • Application (client) ID
  • Directory (tenant) ID
Application Overview with IDs

E. Create the Client Secret

On the left menu, go to Certificates & secrets and click + New client secret. Provide a description (e.g., “SentinelLogKey”) and click Add.
Create Client Secret
CRITICAL STEP: Immediately copy the secret’s Value. This is the only time it will be fully visible. Store it securely with the other IDs.
Client Secret Value

Step 2: Create the Azure Ingestion Infrastructure

Now, we will build the “pathway” and “storage” for your logs.

A. Create the Data Collection Endpoint (DCE)

1. Find the Service

In the Azure search bar, search for and select Data Collection Endpoints.
Search Data Collection Endpoints

2. Create a New DCE

Click + Create.
Create Data Collection Endpoint

3. Configure the DCE

  • Name: dce-secureai-integration
  • Region: Choose the same region as your Log Analytics Workspace
  • Click Review + create, and then Create
Review and Create DCE

4. Copy the URI

Once deployed, navigate to the resource. On its Overview page, copy the Logs ingestion URI and save it.
DCE Overview with URI

B. Create the Custom Table and Data Collection Rule (DCR)

1. Go to Log Analytics

Navigate to your Log Analytics Workspace.

2. Create a Custom Table

On the left menu, click Tables, then + Create, and select New custom log (DCR-based).
Create Custom Table

3. “Basics” Tab

  • Table name: secureaitosiem (Azure will automatically append _CL, making the full name secureaitosiem_CL)
  • Data collection rule: Select “Create a new…” and name it dcr-secureai-events
Data Collection Rule Setup
  • Data collection endpoint: Select the DCE you created earlier (dce-secureai-integration)
  • Click Next: Schema and transformation
Next Schema and Transformation

4. “Schema and transformation” Tab

Upload a sample file: The system will prompt you. Create a .json file with the following content and upload it:
Download Sample File: You can also download the complete sample JSON file to use directly: 📥 sample.json

5. Apply the Transformation

The system may show a warning about the TimeGenerated field. Click the Transformation editor button, delete all existing content, and paste the following complete KQL query:
KQL Transformation Query
Click Apply. You should see a preview of the table with all the correct columns and data types.
Apply Transformation

6. Finalize Creation

Click Next: Review + create and then Create.
Review and Create DCR

Step 3: Connect the Identity to the Infrastructure (Permissions)

This crucial step grants our application permission to use the data collection rule we just created.

A. Go to your new DCR

Search for and open your Data Collection Rule, dcr-secureai-events and in “Overview”, copy the immutable ID and save it for integration.
DCR Overview with Immutable ID

B. Assign the Role

On the left menu, go to Access control (IAM) and click + Add → Add role assignment.
Add Role Assignment
Role: Search for and select Monitoring Metrics Publisher.
Select Monitoring Metrics Publisher Role
Members: Click Select members and search for your App Registration name (SecureAI-Log-Ingester). Select it.
Select App Registration Member
Click Review + assign.

Step 4: Finalize and Share Information

You’re almost done. Just one final step.

A. Gather the Information

To complete the integration, the application needs the following six pieces of information:
  1. Tenant ID: (From Step 1)
  2. Client ID: (From Step 1)
  3. Client Secret: (From Step 1)
  4. DCE URI: (From Step 2A)
  5. DCR Immutable ID: (Navigate to your DCR dcr-secureai-events and copy this from the JSON View)
  6. Stream Name: This is a constructed value. The format is Custom-{TableName}. In our case, it will be: Custom-secureaitosiem_CL

B. Configure the Application

Input these 6 values into your application’s configuration settings.
Application Configuration Settings

Step 5: Verify the Integration

Once you have entered the integration details into the SecureAI application, you can verify that the connection is working correctly.

A. Test the Connection

Use the “Test Connection” button within our application. This will send a test event to your Microsoft Sentinel workspace.

B. Find the Test Event in Log Analytics

To see if the event arrived in Microsoft Sentinel, go to your Log Analytics Workspace and click on Logs. Run the following query to see your incoming data:
You should see your log data appearing with all columns (TimeGenerated, Level_s, Message_s, etc.) correctly populated. If so, your integration is a success! ✅
Successful Integration Verification
Note: Depending on network traffic and system load, it can sometimes take up to 10 minutes for logs to appear in Microsoft Sentinel.

Done!

With these steps, your Microsoft Sentinel instance is fully configured to integrate with SecureAI 😎.