Darktrace AI Analyst
| Id | ffa2977f-3077-4bba-b1bf-f3417699cbb0 |
| Rulename | Darktrace AI Analyst |
| Description | This rule creates Microsoft Sentinel Incidents based on Darktrace AI Analyst Incidents, fetched every 5 minutes. |
| Severity | High |
| Required data connectors | DarktraceRESTConnector |
| Kind | NRT |
| Query frequency | 5m |
| Query period | 5m |
| Trigger threshold | 0 |
| Trigger operator | gt |
| Source Uri | https://github.com/Azure/Azure-Sentinel/blob/master/Solutions/Darktrace/Analytic Rules/CreateIncidentFromAIAnalystIncident.yaml |
| Version | 1.1.0 |
| Arm template | ffa2977f-3077-4bba-b1bf-f3417699cbb0.json |
darktrace_model_alerts_CL
| where dtProduct_s =="AI Analyst"
| project-rename EventStartTime=startTime_s, EventEndTime = endTime_s, NetworkRuleName=title_s, DtCurrentGroup=externalId_g, ThreatCategory=dtProduct_s, ThreatRiskLevel=score_d, SrcHostname=hostname_s, SrcIpAddr=deviceIP_s, DtURL=url_s, DtSummary=summary_s, DtGroupScore=groupScore_d, DtGroupCategory=groupCategory_s, DtSrcDeviceName=bestDeviceName_s, DtIndentifier=identifier_s, ActivityID=activityId_s, DtGroupingID=groupingId_s, DtGroupByActivity=groupByActivity_b, DtSummaryFirstSentence=summaryFirstSentence_s, DtNewEvent=newEvent_b, DtCGLegacy=currentGroup_s, DtGroupPreviousGroups=groupPreviousGroups_s, DtTime=time_s, DtSeverity=Severity, DtLongitude=longitude_d, DtLatitude=latitude_d
| extend EventVendor = "Darktrace", EventProduct = "Darktrace DETECT", DtSentinelCategory=DtGroupCategory
| extend DtSentinelCategory = case (DtGroupCategory == "compliance", "Low",
DtGroupCategory == "suspicious", "Medium",
"High") //compliance -> low, suspcious -> medium, critical -> high
query: |
darktrace_model_alerts_CL
| where dtProduct_s =="AI Analyst"
| project-rename EventStartTime=startTime_s, EventEndTime = endTime_s, NetworkRuleName=title_s, DtCurrentGroup=externalId_g, ThreatCategory=dtProduct_s, ThreatRiskLevel=score_d, SrcHostname=hostname_s, SrcIpAddr=deviceIP_s, DtURL=url_s, DtSummary=summary_s, DtGroupScore=groupScore_d, DtGroupCategory=groupCategory_s, DtSrcDeviceName=bestDeviceName_s, DtIndentifier=identifier_s, ActivityID=activityId_s, DtGroupingID=groupingId_s, DtGroupByActivity=groupByActivity_b, DtSummaryFirstSentence=summaryFirstSentence_s, DtNewEvent=newEvent_b, DtCGLegacy=currentGroup_s, DtGroupPreviousGroups=groupPreviousGroups_s, DtTime=time_s, DtSeverity=Severity, DtLongitude=longitude_d, DtLatitude=latitude_d
| extend EventVendor = "Darktrace", EventProduct = "Darktrace DETECT", DtSentinelCategory=DtGroupCategory
| extend DtSentinelCategory = case (DtGroupCategory == "compliance", "Low",
DtGroupCategory == "suspicious", "Medium",
"High") //compliance -> low, suspcious -> medium, critical -> high
eventGroupingSettings:
aggregationKind: AlertPerResult
queryPeriod: 5m
alertDetailsOverride:
alertSeverityColumnName:
alertDynamicProperties:
- value: DtURL
alertProperty: AlertLink
- value: EventVendor
alertProperty: ProviderName
- value: EventProduct
alertProperty: ProductName
- value: ThreatCategory
alertProperty: ProductComponentName
- value: DtSentinelCategory
alertProperty: Severity
alertTacticsColumnName:
alertDescriptionFormat: '{{DtSummary}}'
alertDisplayNameFormat: 'Darktrace: {{ThreatRiskLevel}} - {{NetworkRuleName}}'
name: Darktrace AI Analyst
id: ffa2977f-3077-4bba-b1bf-f3417699cbb0
relevantTechniques: []
requiredDataConnectors:
- connectorId: DarktraceRESTConnector
dataTypes:
- darktrace_model_alerts_CL
severity: High
triggerOperator: gt
OriginalUri: https://github.com/Azure/Azure-Sentinel/blob/master/Solutions/Darktrace/Analytic Rules/CreateIncidentFromAIAnalystIncident.yaml
version: 1.1.0
tactics: []
kind: NRT
customDetails:
EventStartTime: EventStartTime
ThreatRiskLevel: ThreatRiskLevel
DtCurrentGroup: DtCurrentGroup
DtSentinelCategory: DtSentinelCategory
DtGroupCategory: DtGroupCategory
DtSeverity: DtSeverity
DtGroupScore: DtGroupScore
NetworkRuleName: NetworkRuleName
EventEndTime: EventEndTime
DtSrcDeviceName: DtSrcDeviceName
DtNewEvent: DtNewEvent
DtSummary: DtSummary
entityMappings:
- entityType: Host
fieldMappings:
- identifier: HostName
columnName: SrcHostname
- entityType: IP
fieldMappings:
- identifier: Address
columnName: SrcIpAddr
triggerThreshold: 0
description: |
'This rule creates Microsoft Sentinel Incidents based on Darktrace AI Analyst Incidents, fetched every 5 minutes.'
queryFrequency: 5m
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"workspace": {
"type": "String"
}
},
"resources": [
{
"apiVersion": "2024-01-01-preview",
"id": "[concat(resourceId('Microsoft.OperationalInsights/workspaces/providers', parameters('workspace'), 'Microsoft.SecurityInsights'),'/alertRules/ffa2977f-3077-4bba-b1bf-f3417699cbb0')]",
"kind": "NRT",
"name": "[concat(parameters('workspace'),'/Microsoft.SecurityInsights/ffa2977f-3077-4bba-b1bf-f3417699cbb0')]",
"properties": {
"alertDetailsOverride": {
"alertDescriptionFormat": "{{DtSummary}}",
"alertDisplayNameFormat": "Darktrace: {{ThreatRiskLevel}} - {{NetworkRuleName}}",
"alertDynamicProperties": [
{
"alertProperty": "AlertLink",
"value": "DtURL"
},
{
"alertProperty": "ProviderName",
"value": "EventVendor"
},
{
"alertProperty": "ProductName",
"value": "EventProduct"
},
{
"alertProperty": "ProductComponentName",
"value": "ThreatCategory"
},
{
"alertProperty": "Severity",
"value": "DtSentinelCategory"
}
],
"alertSeverityColumnName": null,
"alertTacticsColumnName": null
},
"alertRuleTemplateName": "ffa2977f-3077-4bba-b1bf-f3417699cbb0",
"customDetails": {
"DtCurrentGroup": "DtCurrentGroup",
"DtGroupCategory": "DtGroupCategory",
"DtGroupScore": "DtGroupScore",
"DtNewEvent": "DtNewEvent",
"DtSentinelCategory": "DtSentinelCategory",
"DtSeverity": "DtSeverity",
"DtSrcDeviceName": "DtSrcDeviceName",
"DtSummary": "DtSummary",
"EventEndTime": "EventEndTime",
"EventStartTime": "EventStartTime",
"NetworkRuleName": "NetworkRuleName",
"ThreatRiskLevel": "ThreatRiskLevel"
},
"description": "'This rule creates Microsoft Sentinel Incidents based on Darktrace AI Analyst Incidents, fetched every 5 minutes.'\n",
"displayName": "Darktrace AI Analyst",
"enabled": true,
"entityMappings": [
{
"entityType": "Host",
"fieldMappings": [
{
"columnName": "SrcHostname",
"identifier": "HostName"
}
]
},
{
"entityType": "IP",
"fieldMappings": [
{
"columnName": "SrcIpAddr",
"identifier": "Address"
}
]
}
],
"eventGroupingSettings": {
"aggregationKind": "AlertPerResult"
},
"OriginalUri": "https://github.com/Azure/Azure-Sentinel/blob/master/Solutions/Darktrace/Analytic Rules/CreateIncidentFromAIAnalystIncident.yaml",
"query": "darktrace_model_alerts_CL \n| where dtProduct_s ==\"AI Analyst\"\n| project-rename EventStartTime=startTime_s, EventEndTime = endTime_s, NetworkRuleName=title_s, DtCurrentGroup=externalId_g, ThreatCategory=dtProduct_s, ThreatRiskLevel=score_d, SrcHostname=hostname_s, SrcIpAddr=deviceIP_s, DtURL=url_s, DtSummary=summary_s, DtGroupScore=groupScore_d, DtGroupCategory=groupCategory_s, DtSrcDeviceName=bestDeviceName_s, DtIndentifier=identifier_s, ActivityID=activityId_s, DtGroupingID=groupingId_s, DtGroupByActivity=groupByActivity_b, DtSummaryFirstSentence=summaryFirstSentence_s, DtNewEvent=newEvent_b, DtCGLegacy=currentGroup_s, DtGroupPreviousGroups=groupPreviousGroups_s, DtTime=time_s, DtSeverity=Severity, DtLongitude=longitude_d, DtLatitude=latitude_d \n| extend EventVendor = \"Darktrace\", EventProduct = \"Darktrace DETECT\", DtSentinelCategory=DtGroupCategory\n| extend DtSentinelCategory = case (DtGroupCategory == \"compliance\", \"Low\", \n DtGroupCategory == \"suspicious\", \"Medium\",\n \"High\") //compliance -> low, suspcious -> medium, critical -> high\n",
"queryFrequency": "PT5M",
"queryPeriod": "PT5M",
"severity": "High",
"subTechniques": [],
"suppressionDuration": "PT1H",
"suppressionEnabled": false,
"tactics": [],
"techniques": [],
"templateVersion": "1.1.0",
"triggerOperator": "GreaterThan",
"triggerThreshold": 0
},
"type": "Microsoft.OperationalInsights/workspaces/providers/alertRules"
}
]
}