Skip to content

Commit 40761b0

Browse files
committed
fixes to page
1 parent 79c00eb commit 40761b0

File tree

2 files changed

+25
-17
lines changed

2 files changed

+25
-17
lines changed

articles/defender-for-cloud/TOC.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -115,7 +115,7 @@
115115
- name: Investigate the health of your resources
116116
displayName: health, resources, outstanding, security, issues,
117117
href: investigate-resource-health.md
118-
- name: Set up email notifications
118+
- name: Configure email notifications for alerts and attack paths
119119
displayName: email,e-mail, notifications
120120
href: configure-email-notifications.md
121121
- name: Create autoresponses to alerts using an ARM template or Bicep

articles/defender-for-cloud/configure-email-notifications.md

Lines changed: 24 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,36 +1,44 @@
11
---
2-
title: Configure email notifications for alerts
2+
title: Configure email notifications for alerts and attack paths
33
description: Learn how to fine-tune the Microsoft Defender for Cloud security alert emails to ensure the right people receive timely notifications.
4-
ms.topic: quickstart
4+
ms.topic: how-to
55
ms.author: dacurwin
66
author: dcurwin
7-
ms.date: 05/12/2024
7+
ms.date: 05/19/2024
88
ms.custom: mode-other
9-
#customer intent: As a user, I want to learn how to customize email notifications for security alerts in Microsoft Defender for Cloud.
9+
#customer intent: As a user, I want to learn how to customize email notifications for alerts and attack paths in Microsoft Defender for Cloud.
1010
---
1111

12-
# Configure email notifications for security alerts
12+
# Configure email notifications for alerts and attack paths
1313

14-
In this quickstart you will learn how to configure security alert emails in Microsoft Defender for Cloud to ensure that security alerts reach the right people in your organization. By default, Microsoft Defender for Cloud emails subscription owners whenever a high-severity alert is triggered for their subscription. This page explains how to customize these notifications.
14+
Microsoft Defender for Cloud allows you to configure email notifications for alerts and attack paths. Configuring email notifications allows for the delivery of timely notifications to the appropriate recipients. By modifying the email notification settings, preferences can be defined for the severity levels of alerts and the risk level of attack paths that trigger notifications. By default, subscription owners receive email notifications for high-severity alerts and attack paths.
1515

1616
Defender for Cloud's **Email notifications** settings page allows you to define preferences for notification emails including:
1717

1818
- ***who* should be notified** - Emails can be sent to select individuals or to anyone with a specified Azure role for a subscription.
1919
- ***what* they should be notified about** - Modify the severity levels for which Defender for Cloud should send out notifications.
2020

21-
To avoid alert fatigue, Defender for Cloud limits the volume of outgoing emails. For each email address, Defender for Cloud sends:
21+
:::image type="content" source="./media/configure-email-notifications/email-notification-settings.png" alt-text="Configuring the details of the contact who is to receive emails about alerts and attack paths." lightbox="media/configure-email-notifications/email-notification-settings.png":::
22+
23+
## Email frequency
2224

23-
- approximately **four emails per day** for **high-severity** alerts
24-
- approximately **two emails per day** for **medium-severity** alerts
25-
- approximately **one email per day** for **low-severity** alerts
25+
To avoid alert fatigue, Defender for Cloud limits the volume of outgoing emails. For each email address, Defender for Cloud sends:
2626

27-
:::image type="content" source="./media/configure-email-notifications/email-notification-settings.png" alt-text="Configuring the details of the contact who is to receive emails about security alerts." lightbox="media/configure-email-notifications/email-notification-settings.png":::
27+
|Alert type | Severity/Risk level | Email volume |
28+
|--|--|--|
29+
| Alert | High | Four emails per day |
30+
| Alert | Medium | Two emails per day |
31+
| Alert | Low | One email per day |
32+
| Attack path | Critical | One email per 30 minutes |
33+
| Attack path | High | One email per hour |
34+
| Attack path | Medium | One email per two hours |
35+
| Attack path | Low | One email per three hours |
2836

2937
## Availability
3038

3139
Required roles and permissions: Security Admin, Subscription Owner or Contributor.
3240

33-
## Customize the security alerts email notifications via the portal<a name="email"></a>
41+
## Customize the email notifications in the portal
3442

3543
You can send email notifications to individuals or to all users with specific Azure roles.
3644

@@ -54,7 +62,7 @@ You can send email notifications to individuals or to all users with specific Az
5462

5563
1. Select **Save**.
5664

57-
## Customize the alerts email notifications through the API
65+
## Customize the email notifications with an API
5866

5967
You can also manage your email notifications through the supplied REST API. For full details, see the [SecurityContacts API documentation](/rest/api/defenderforcloud/security-contacts).
6068

@@ -79,10 +87,10 @@ URI: `https://management.azure.com/subscriptions/<SubscriptionId>/providers/Micr
7987
}
8088
```
8189

82-
## Next steps
83-
84-
To learn more about security alerts, see the following pages:
90+
## Related content
8591

8692
- [Security alerts - a reference guide](alerts-reference.md) - Learn about the security alerts you might see in Microsoft Defender for Cloud's Threat Protection module.
8793
- [Manage and respond to security alerts in Microsoft Defender for Cloud](managing-and-responding-alerts.yml) - Learn how to manage and respond to security alerts.
94+
- [Identify and remediate attack paths](how-to-manage-attack-path.md).
95+
- [Investigating risk with security explorer/attack paths](concept-attack-path.md)
8896
- [Workflow automation](workflow-automation.yml) - Automate responses to alerts with custom notification logic.

0 commit comments

Comments
 (0)