Integrating Microsoft Sentinel
Microsoft Sentinel is a cloud-native security information and event management (SIEM) solution for proactive threat detection, investigation, and response. You can integrate Microsoft Sentinel with the Delinea Platform by using webhooks.
Prerequisites
Ensure that you have all the required accounts and utilities before starting the integration:
-
Admin account on the Delinea Platform
-
Azure subscription
-
Access to the Microsoft Sentinel portal
-
Log Analytics workspace
This integration does not rely on the deprecated Log Analytics Agent, which was retired on August 31, 2024. Instead, it leverages HTTP requests to trigger Azure Logic Apps workflows that generate custom log entries or alerts in Azure Sentinel. This integration does not depend on either the Log Analytics Agent or the Azure Monitor Agent (AMA), ensuring a modern, agentless solution.
Configuring Microsoft Sentinel
To configure Microsoft Azure Sentinel, create a Logic app and set up Sentinel Log Analytics.
Creating a Logic App in Sentinel
To create a logic app:
-
Log in to the Azure portal dashboard.
-
Enter Logic App in the search area, and then select Logic App.
-
Select Create.
-
Click Select.
-
Fill in the required information for your Logic App and select Review + Create.
-
Once the deployment is done, your Logic App is created in Sentinel.
Setting up Sentinel Log Analytics
To set up Sentinel log analytics:
-
In the Logic App, go to Workflows and select Add to add a new workflow. The Create Workflow window opens.
-
Enter the Workflow Name and select Stateless as the state type.
-
Select Create. Note: Depending on screen resolution, the Create button might be hidden at the bottom of the app tile.
-
Open the newly-created workflow.
-
On the Designer page, select the plus sign, then select Add trigger.
-
Search for "HTTP" and select When an HTTP request is received in the Request section. You will use this trigger later when setting up a webhook on the Delinea Platform.
-
Paste the following code into the field. (Alternatively, you can retrieve the schema payload from the Marketplace >Test webhook Request body) :
-
Copy
{
"AuditEventMessageId": "87b928df-ccc5-46ed-8cc5-b2e88866a2b5",
"TenantId": "7968fc7c-9205-4bd8-ad41-1432ffb8f7d3",
...
"ForceCompress": false
} -
Select Done , then select Save.
-
Search for "Log Analytics" and select Send Data. The Create a connection page opens.
-
Provide the Workspace ID and Shared Key. Where to Find Your Workspace ID and Key:
-
In the Sentinel portal, go to Home > Microsoft Sentinel.
-
Navigate to Settings > Workspace settings > Settings > Agents.
-
Click the arrow icon to expand the Log Analytics agent instructions.
-
-
Copy your Workspace ID and either the Primary Key or Secondary Key.
-
Paste the Workspace ID into the Create new connection page.
-
Select Create New.
-
The Send Data page opens. Under the Parameters tab, select the JSON Request Body field, and select the second option.
-
Select the Dynamic content tab and enter 'Body' in the Search field.
-
Provide a new name for the Custom Log Name (e.g. MarketPlace Event)
-
Select Save.
Integrating Webhooks and Microsoft Sentinel
To integrate webhooks and Microsoft Sentinel, follow these steps.
-
Log in to the Delinea Platform.
-
From the left navigation menu, select Settings, then Webhooks.
-
In the Endpoint URL field, enter the HTTP request URL—an HTTP trigger configured in the Logic App.
-
Select Save.
-
Verify the configured webhook on the Delinea Platform (see Testing a webhook).
Verifying Logs for the Microsoft Sentinel Webhook
After you have set up the integration, we recommend verifying that the Delinea Platform events are being collected for Azure Sentinel.
-
Log in to the Delinea Platform and perform an activity that will generate a new audit log.
-
Open your Logic App.
-
Select the activity log and verify that logs from the Delinea Platform are triggered automatically.
-
Go to the Sentinel dashboard in the Microsoft Sentinel Portal.
-
From the left navigation menu, select Logs.
-
In the query editor, enter the following KQL query:
MarketPlaceEvents_CL
| order by TimeGenerated desc
| take 10