Skip to content

Commit 750c77f

Browse files
committed
updated images
1 parent 53e150c commit 750c77f

File tree

5 files changed

+20
-19
lines changed

5 files changed

+20
-19
lines changed

defender-xdr/custom-detection-rules.md

Lines changed: 20 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -224,8 +224,8 @@ When you select this frequency option, the **Run query every input** component i
224224
### 3. Define alert enrichment details
225225
You can enrich alerts by providing and defining more details, allowing you to:
226226
- [Create a dynamic alert title and description](#create-a-dynamic-alert-title-and-description-preview)
227-
- [Link entities](#link-entities)
228227
- [Add custom details](#add-custom-details-preview) to display in the alert side panel
228+
- [Link entities](#link-entities)
229229

230230
#### Create a dynamic alert title and description (Preview)
231231
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}}`
241241

242242
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.
243243

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+
244263
#### Link entities
245264

246265
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
286305

287306
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.
288307

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.
307308

308309
### 4. Specify actions
309310

75.2 KB
Loading
49.3 KB
Loading
37.8 KB
Loading
73.5 KB
Loading

0 commit comments

Comments
 (0)