Skip to content

Commit 55dcb63

Browse files
Merge pull request #2530 from MicrosoftDocs/maccruz-cdrequired
Update custom detection requirements
2 parents 1cea7ef + 0f2733f commit 55dcb63

File tree

1 file changed

+21
-17
lines changed

1 file changed

+21
-17
lines changed

defender-xdr/custom-detection-rules.md

Lines changed: 21 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -71,24 +71,28 @@ In the Microsoft Defender portal, go to **Advanced hunting** and select an exist
7171
7272
#### Required columns in the query results
7373

74-
To create a custom detection rule, the query must return the following columns:
7574

76-
- `Timestamp`- Used to set the timestamp for generated alerts
77-
- `ReportId`- Enables lookups for the original records
78-
- One of the following columns that identify specific devices, users, or mailboxes:
79-
- `DeviceId`
80-
- `DeviceName`
81-
- `RemoteDeviceName`
82-
- `RecipientEmailAddress`
83-
- `SenderFromAddress` (envelope sender or Return-Path address)
84-
- `SenderMailFromAddress` (sender address displayed by email client)
85-
- `RecipientObjectId`
86-
- `AccountObjectId`
87-
- `AccountSid`
88-
- `AccountUpn`
89-
- `InitiatingProcessAccountSid`
90-
- `InitiatingProcessAccountUpn`
91-
- `InitiatingProcessAccountObjectId`
75+
To create a custom detection rule, the query must return the following columns:
76+
1. `Timestamp` - Used to set the timestamp for generated alerts
77+
2. A column or combination of columns that uniquely identify the event in Defender XDR tables:
78+
- For Microsoft Defender for Endpoint tables, the `Timestamp`, `DeviceId`, and `ReportId` columns must appear in the same event
79+
- For Alert* tables, `Timestamp` must appear in the event
80+
- For Observation* tables, `Timestamp`and `ObservationId` must appear in the same event
81+
- For all others, `Timestamp` and `ReportId` must appear in the same event
82+
3. One of the following columns that contain a strong identifier for an impacted asset:
83+
- `DeviceId`
84+
- `DeviceName`
85+
- `RemoteDeviceName`
86+
- `RecipientEmailAddress`
87+
- `SenderFromAddress` (envelope sender or Return-Path address)
88+
- `SenderMailFromAddress` (sender address displayed by email client)
89+
- `RecipientObjectId`
90+
- `AccountObjectId`
91+
- `AccountSid`
92+
- `AccountUpn`
93+
- `InitiatingProcessAccountSid`
94+
- `InitiatingProcessAccountUpn`
95+
- `InitiatingProcessAccountObjectId`
9296

9397
> [!NOTE]
9498
> Support for additional entities will be added as new tables are added to the [advanced hunting schema](advanced-hunting-schema-tables.md).

0 commit comments

Comments
 (0)