Skip to content

Commit e899cb2

Browse files
authored
Merge branch 'main' into 190a1007-553f-4c81-a3f6-2a5638b560c6_3
2 parents e1d02dc + 3e8d8ed commit e899cb2

File tree

72 files changed

+369
-251
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

72 files changed

+369
-251
lines changed

ATPDocs/automated-response-exclusions.md

Lines changed: 16 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -18,27 +18,30 @@ For example, an incident involving Attack Disruption, where response actions are
1818

1919
## How to add automated response exclusions
2020

21-
1. In [Microsoft Defender XDR](https://security.microsoft.com/), go to **Settings** and then **Identities**.
2221

23-
![Go to Settings, then Identities.](media/settings-identities.png)
22+
1. In the [Microsoft Defender XDR](https://security.microsoft.com/) portal, go to **Settings** and then **Microsoft Defender XDR**.
2423

25-
1. You'll then see **Automated response exclusions** in the left-hand menu.
24+
:::image type="content" source="media/automated-response-exclusions/screenshot-xdr-settings1.png" alt-text="Go to Settings, then Microsoft Defender XDR.":::
2625

27-
![Automated response exclusions.](media/automated-response-exclusions.png)
26+
27+
2. You'll see **Automated response > Identities** in the left-side menu.
2828

29-
1. To exclude specific users, select **Exclude Users**.
29+
:::image type="content" source="media/automated-response-exclusions/screenshot-xdr-automated-response.png" alt-text="Go to Automated response then Identities.":::
30+
31+
3. To exclude specific users, select **Add User Exclusion**.
3032

31-
:::image type="content" source="media/exclude-users.png" alt-text="Exclude specific users.":::
32-
33-
1. Search for the users to exclude and select the **Exclude Users** button.
33+
:::image type="content" source="media/automated-response-exclusions/screenshot-xdr-add-exclusion.png" alt-text="Exclude specific users.":::
34+
35+
4. Search for the users to exclude and select the **Exclude Users** button.
3436

3537
:::image type="content" source="media/exclude-specific-users.png" alt-text="Choose which users to exclude.":::
38+
39+
5. To remove excluded users, select the relevant users from the list and select the **Remove** button.
3640

37-
1. To remove excluded users, select the relevant users from the list and select the **Remove** button.
38-
39-
:::image type="content" source="media/remove-excluded-users.png" alt-text="Remove excluded users.":::
40-
41+
:::image type="content" source="media/remove-excluded-users.png" alt-text="Remove excluded users.":::
42+
4143
## See also
4244

4345
- [Configure event collection](deploy/configure-event-collection.md)
44-
- [Check out the Defender for Identity forum!](<https://aka.ms/MDIcommunity>)
46+
- [Check out the Defender for Identity forum!](https://aka.ms/MDIcommunity)
47+

ATPDocs/deploy/activate-capabilities.md

Lines changed: 44 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -6,11 +6,15 @@ ms.topic: how-to
66
ms.reviewer: rlitinsky
77
---
88

9-
# Activate Microsoft Defender for Identity capabilities directly on a domain controller
9+
# Activate Microsoft Defender for Identity capabilities directly on a domain controller (Preview)
1010

11-
Microsoft Defender for Endpoint customers, who have already onboarded their domain controllers to Defender for Endpoint, can activate Microsoft Defender for Identity capabilities directly on a domain controller instead of using [Microsoft Defender for Identity classic sensor](deploy-defender-identity.md).
11+
This article describes how to activate and test Microsoft Defender for Identity new sensor capabilities on your domain controller.
1212

13-
This article describes how to activate and test Microsoft Defender for Identity capabilities on your domain controller.
13+
> [!NOTE]
14+
> The capabilities described in this article are currently available as Preview features. Preview features are features that aren't complete, but are made available on a "preview" basis so customers can get early access and provide feedback.
15+
>
16+
> Preview features are still in development, have limited or restricted functionality and may be available only in selected geographic areas.
17+
> For more information, see the [Microsoft Defender XDR preview features](/defender-xdr/preview)
1418
1519
> [!IMPORTANT]
1620
> The new Defender for Identity sensor (version 3.x) is recommended for customers looking to deploy core identity protections to new domain controllers running Windows Server 2019 or newer. For all other identity infrastructure, or for customers looking to deploy the most robust identity protections available from Microsoft Defender for Identity today, we recommend deploying the classic sensor [here](quick-installation-guide.md).
@@ -71,25 +75,27 @@ Set-MDIConfiguration -Mode Domain -Configuration All
7175

7276
### Customers with domain controllers already onboarded to Defender for Endpoint
7377

78+
Microsoft Defender for Endpoint customers, who have already onboarded their domain controllers to Defender for Endpoint, can activate Microsoft Defender for Identity capabilities directly on a domain controller instead of using [Microsoft Defender for Identity classic sensor](deploy-defender-identity.md).
79+
7480
### Activate Defender for Identity capabilities
7581

7682
Activate the Defender for Identity from the [Microsoft Defender portal](https://security.microsoft.com).
7783

7884
1. Navigate to **System** > **Settings** > **Identities** > **Activation**.
7985

80-
The Activation Page now displays all servers from your device inventory, including those not currently eligible for the activation of the new Defender for Identity sensor. For each server you can find its activation state.
86+
The Activation Page now displays all servers from your device inventory, including those not currently eligible for the activation of the new Defender for Identity sensor. For each server, you can find its activation state.
8187

82-
2. Select the domain controller where you want to activate the Defender for Identity capabilities and then select **Activate**. Confirm your selection when prompted.
88+
1. Select the domain controller where you want to activate the Defender for Identity capabilities and then select **Activate**. Confirm your selection when prompted.
8389

8490
:::image type="content" source="media/activate-capabilities/1.jpg" lightbox="media/activate-capabilities/1.jpg" alt-text="Screenshot that shows how to activate the new sensor.":::
8591

8692
> [!NOTE]
8793
> You can choose to activate eligible domain controllers either automatically, where Defender for Identity activates them as soon as they're discovered, or manually, where you select specific domain controllers from the list of eligible servers.
8894
89-
3. When the activation is complete, a green success banner shows. In the banner, select **Click here to see the onboarded servers** to jump to the **Settings > Identities > Sensors** page, where you can check your sensor health.
90-
91-
:::image type="content" source="media/activate-capabilities/2.jpg" lightbox="media/activate-capabilities/2.jpg" alt-text="Screenshot that shows how to seethe onboarded servers.":::
95+
1. When the activation is complete, a green success banner shows. In the banner, select **Click here to see the onboarded servers** to jump to the **Settings > Identities > Sensors** page, where you can check your sensor health.
9296

97+
:::image type="content" source="media/activate-capabilities/2.jpg" lightbox="media/activate-capabilities/2.jpg" alt-text="Screenshot that shows how to see the onboarded servers.":::
98+
9399
### Customers without domain controllers onboarded to Defender for Endpoint
94100

95101
### Connectivity requirements
@@ -98,26 +104,32 @@ Defender for Identity capabilities directly on domain controllers use Defender f
98104

99105
For more information, see [Configure your network environment to ensure connectivity with Defender for Endpoint](/microsoft-365/security/defender-endpoint/configure-environment##enable-access-to-microsoft-defender-for-endpoint-service-urls-in-the-proxy-server).
100106

101-
### Onboard Defender for Identity capabilities
102-
Download the Defender for Identity onboarding package from the [Microsoft Defender portal] (https://security.microsoft.com)
107+
### Onboard Defender for Identity capabilities
108+
109+
Download the Defender for Identity onboarding package from the [Microsoft Defender portal](https://security.microsoft.com)
110+
111+
1. Navigate to **System** > **Settings** > **Identities** > **Activation**.
112+
113+
1. Select Download onboarding package and save the file in a location you can access from your domain controller.
114+
115+
:::image type="content" source="media/activate-capabilities/screenshot-that-shows-how-to-onboard-the-new-sensor.png" alt-text="Screenshot that shows how to onboard the new sensor" lightbox="media/activate-capabilities/screenshot-that-shows-how-to-onboard-the-new-sensor.png":::
116+
117+
1. From the domain controller, extract the zip file you downloaded from the Microsoft Defender portal, and run the `DefenderForIdentityOnlyOnboardingScript.cmd` script as an Administrator.
118+
119+
<img width="474" alt="Screenshot that shows the script." src="https://github.com/user-attachments/assets/ff2d73d4-7285-403e-979a-520e05cbf1d1" />
103120

104-
1. Navigate to **System** > **Settings** > **Identities** > **Activation**
105-
2. Select Download onboarding package and save the file in a location you can access from your domain controller.
106-
3. From the domain controller, extract the zip file you downloaded from the Microsoft Defender portal, and run the `DefenderForIdentityOnlyOnboardingScript.cmd` script as an Administrator.
107-
108121
## Onboarding Confirmation
109122

110123
To confirm the sensor has been onboarded:
111124

112125
1. Navigate to **System** > **Settings** > **Identities** > **Sensors**.
113126

114-
2. Check that the onboarded domain controller is listed.
127+
1. Check that the onboarded domain controller is listed.
115128

116-
> [!NOTE]
117-
> The onboarding doesn't require a restart/reboot. The first time you activate Defender for Identity capabilities on your domain controller, it may take up to an hour for the first sensor to show as **Running** on the **Sensors** page. Subsequent activations are shown within five minutes.
118-
> To check the onboarding on the local server you can also review the event log under **Applications and Services Logs** > **Microsoft** > **Windows** > **Sense** > **Operational**. You should receive an onboarding event:
129+
> [!NOTE]
130+
> The onboarding doesn't require a restart/reboot. The first time you activate Defender for Identity capabilities on your domain controller, it may take up to an hour for the first sensor to show as **Running** on the **Sensors** page. Subsequent activations are shown within five minutes.
119131
120-
## Test activated capabilities
132+
**Test activated capabilities**
121133

122134
Defender for Identity capabilities on domain controllers currently support the following Defender for Identity functionality:
123135

@@ -147,7 +159,7 @@ In the Defender portal, check for the following details:
147159

148160
- **Group entities**: Use the global search to find a user group, or pivot from a user or device details page where group details are shown. Check for details of group membership, view group users, and group timeline data.
149161

150-
If no event data is found on the group timeline, you may need to create some manually. For example, do this by adding and removing users from the group in Active Directory.
162+
If no event data is found on the group timeline, you may need to create some manually. For example, do this by adding and removing users from the group in Active Directory.
151163

152164
For more information, see [Investigate assets](../investigate-assets.md).
153165

@@ -226,22 +238,27 @@ For more information, see [Remediation actions in Microsoft Defender for Identit
226238
227239
If you want to deactivate Defender for Identity capabilities on your domain controller, delete it from the **Sensors** page:
228240
229-
1. Navigate to **Settings** > **Identities** > **Sensors**
230-
2. Select the domain controller where you want to deactivate Defender for Identity capabilities, select **Delete**, and confirm your selection.
241+
1. Navigate to **Settings** > **Identities** > **Sensors**.
242+
1. Select the domain controller where you want to deactivate Defender for Identity capabilities, select **Delete**, and confirm your selection.
231243
232-
:::image type="content" source="media/activate-capabilities/3.jpg" lightbox="media/activate-capabilities/3.jpg" alt-text="Screenshot that shows how to deactivate a server.":::
244+
![Screenshot that shows how to delete a sensor.](media/activate-capabilities/screenshot-that-shows-how-to-delete-a-sensor.png)
233245
234246
Deactivating Defender for Identity capabilities from your domain controller doesn't remove the domain controller from Defender for Endpoint. For more information, see [Defender for Endpoint documentation](/microsoft-365/security/defender-endpoint/).
235247
236248
### Customers without domain controllers onboarded to Defender for Endpoint
237249
238250
### Offboard Defender for Identity capabilities on your domain controller
239-
Download the Defender for Identity offboarding package from the [Microsoft Defender portal] (https://security.microsoft.com).
251+
Download the Defender for Identity offboarding package from the [Microsoft Defender portal](https://security.microsoft.com).
240252
241253
1. Navigate to **Settings** > **Identities** > **Activation**
242-
2. Select Download offboarding package and save the file in a location you can access from your domain controller.
243-
3. From the domain controller, extract the zip file you downloaded from the Microsoft Defender portal, and run the `DefenderForIdentityOnlyOffboardingScript_valid_until_YYYY-MM-DD.cmd` script as an Administrator.
244-
4. To fully remove the sensor, navigate to **Settings** > **Identities** > **Sensors**, select the server and click Delete.
254+
255+
1. Select Download offboarding package and save the file in a location you can access from your domain controller.
256+
![Screenshot that shows how to offboard the new sensor.](media/activate-capabilities/screenshot-that-shows-how-to-offboard-the-new-sensor.png)
257+
1. From the domain controller, extract the zip file you downloaded from the Microsoft Defender portal, and run the `DefenderForIdentityOnlyOffboardingScript_valid_until_YYYY-MM-DD.cmd` script as an Administrator.
258+
1. To fully remove the sensor, navigate to **Settings** > **Identities** > **Sensors**, select the server, and click **Delete**.
259+
260+
:::image type="content" source="media/activate-capabilities/screenshot-that-shows-how-to-delete-a-sensor.png" alt-text="Screenshot that shows how to delete a sensor" lightbox="media/activate-capabilities/screenshot-that-shows-how-to-delete-a-sensor.png":::
261+
245262
246263
## Next steps
247264

ATPDocs/deploy/configure-windows-event-collection.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Configure audit policies for Windows event logs | Microsoft Defender for Identity
33
description: This article describes how to configure audit policies for Windows event logs as part of deploying a Microsoft Defender for Identity sensor.
4-
ms.date: 01/16/2024
4+
ms.date: 06/04/2025
55
ms.topic: how-to
66
ms.reviewer: rlitinsky
77
---
@@ -240,6 +240,7 @@ To configure domain object auditing:
240240
- **Descendant Computer Objects**
241241
- **Descendant msDS-GroupManagedServiceAccount Objects**
242242
- **Descendant msDS-ManagedServiceAccount Objects**
243+
- **Descendant msDS-DelegatedManagedServiceAccount Objects**
243244

244245
> [!NOTE]
245246
> Assigning the auditing permissions on **All descendant objects** would also work, but you need only the object types detailed in the last step.
62.9 KB
Loading
85.5 KB
Loading
85.4 KB
Loading
82.3 KB
Loading
181 KB
Loading
12.6 KB
Loading
81.1 KB
Loading

0 commit comments

Comments
 (0)