You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: defender-xdr/custom-detection-rules.md
+20-19Lines changed: 20 additions & 19 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -224,8 +224,8 @@ When you select this frequency option, the **Run query every input** component i
224
224
### 3. Define alert enrichment details
225
225
You can enrich alerts by providing and defining more details, allowing you to:
226
226
-[Create a dynamic alert title and description](#create-a-dynamic-alert-title-and-description-preview)
227
-
-[Link entities](#link-entities)
228
227
-[Add custom details](#add-custom-details-preview) to display in the alert side panel
228
+
-[Link entities](#link-entities)
229
229
230
230
#### Create a dynamic alert title and description (Preview)
231
231
You can dynamically craft your alert’s title and description using the results of your query to make them accurate and indicative. This feature can boost SOC analysts’ efficiency when triaging alerts and incidents, and when trying to quickly understand the essence of an alert.
@@ -241,6 +241,25 @@ For example: `User {{AccountName}} unexpectedly signed in from {{Location}}`
241
241
242
242
To help you decide on the exact column names you want to reference, you can select **Explore query and results**, which opens the Advanced hunting context pane on top of the rule creation wizard, where you can examine your query logic and its results.
243
243
244
+
#### Add custom details (Preview)
245
+
246
+
You can further enhance your SOC analysts’ productivity by showing important details in the alert side panel. You can surface events’ data in alerts that are constructed from those events. This gives your SOC analysts immediate event content visibility of their incidents, enabling them to triage, investigate, and draw conclusions faster.
247
+
248
+
In the **Custom details** section, add key-value pairs corresponding to the details you want to surface:
249
+
- In the **Key** field, enter a name of your choosing that will appear as the field name in alerts.
250
+
- In the **Parameter** field, choose the event parameter you wish to surface in the alerts from the dropdown list. This list will be populated by values corresponding to the columns names that your KQL query outputs.
251
+
252
+
:::image type="content" source="/defender/media/ah-custom-details.png" alt-text="Screenshot that shows the Custom details option in the Custom detections setup guide." lightbox="/defender/media/ah-custom-details.png":::
253
+
254
+
The following screenshot shows how the custom details are surfaced in the alert side panel:
255
+
256
+
:::image type="content" source="/defender/media/ah-custom-details-panel.png" alt-text="Screenshot that shows the custom details as they appear in the alert side panel of the Defender portal." lightbox="/defender/media/ah-custom-details-panel.png":::
257
+
258
+
>[!IMPORTANT]
259
+
>Custom details have the following limitations:
260
+
>1. Each rule is limited to up to 20 key/values pairs of custom details
261
+
>2. The combined size limit for all custom details and their values in a single alert is 4 KB. If the custom details array exceeds this limit, the whole custom details array is dropped from the alert.
262
+
244
263
#### Link entities
245
264
246
265
Identify the columns in your query results where you expect to find the main affected or impacted entity. For example, a query might return sender (`SenderFromAddress` or `SenderMailFromAddress`) and recipient (`RecipientEmailAddress`) addresses. Identifying which of these columns represent the main impacted entity helps the service aggregate relevant alerts, correlate incidents, and target response actions.
@@ -286,24 +305,6 @@ After an entity type is selected, select an identifier type that exists in the s
286
305
287
306
After selecting the identifier, select a column from the query results that contain the selected identifier. You can select **Explore query and results** to open the advanced hunting context panel. This allows you to explore your query and results to make sure you choose the right column for the selected identifier.
288
307
289
-
#### Add custom details (Preview)
290
-
291
-
You can further enhance your SOC analysts’ productivity by showing important details in the alert side panel. You can surface events’ data in alerts that are constructed from those events. This gives your SOC analysts immediate event content visibility of their incidents, enabling them to triage, investigate, and draw conclusions faster.
292
-
293
-
In the **Custom details** section, add key-value pairs corresponding to the details you want to surface:
294
-
- In the **Key** field, enter a name of your choosing that will appear as the field name in alerts.
295
-
- In the **Parameter** field, choose the event parameter you wish to surface in the alerts from the dropdown list. This list will be populated by values corresponding to the columns names that your KQL query outputs.
296
-
297
-
:::image type="content" source="/defender/media/ah-custom-details.png" alt-text="Screenshot that shows the Custom details option in the Custom detections setup guide." lightbox="/defender/media/ah-custom-details.png":::
298
-
299
-
The following screenshot shows how the custom details are surfaced in the alert side panel:
300
-
301
-
:::image type="content" source="/defender/media/ah-custom-details-panel.png" alt-text="Screenshot that shows the custom details as they appear in the alert side panel of the Defender portal." lightbox="/defender/media/ah-custom-details-panel.png":::
302
-
303
-
>[!IMPORTANT]
304
-
>Custom details have the following limitations:
305
-
>1. Each rule is limited to up to 20 key/values pairs of custom details
306
-
>2. The combined size limit for all custom details and their values in a single alert is 4 KB. If the custom details array exceeds this limit, the whole custom details array is dropped from the alert.
0 commit comments