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-endpoint/troubleshoot-asr.md
+22-19Lines changed: 22 additions & 19 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,7 +6,7 @@ ms.localizationpriority: medium
6
6
audience: ITPro
7
7
author: denisebmsft
8
8
ms.author: deniseb
9
-
ms.date: 07/28/2023
9
+
ms.date: 11/05/2024
10
10
ms.reviewer:
11
11
manager: deniseb
12
12
ms.custom: asr
@@ -33,8 +33,8 @@ search.appverid: met150
33
33
34
34
When you use [attack surface reduction rules](attack-surface-reduction.md) you might run into issues, such as:
35
35
36
-
- A rule blocks a file, process, or performs some other action that it shouldn't (false positive)
37
-
- A rule doesn't work as described, or doesn't block a file or process that it should (false negative)
36
+
- A rule blocks a file, process, or performs some other action that it shouldn't (false positive); or
37
+
- A rule doesn't work as described, or doesn't block a file or process that it should (false negative).
38
38
39
39
There are four steps to troubleshooting these problems:
40
40
@@ -47,41 +47,43 @@ There are four steps to troubleshooting these problems:
47
47
48
48
Attack surface reduction rules only work on devices with the following conditions:
49
49
50
-
- Endpoints are running Windows 10 Enterprise or later.
50
+
- Devices are running Windows 10 Enterprise or later.
51
+
- Devices are using Microsoft Defender Antivirus as the sole antivirus protection app. [Using any other antivirus app causes Microsoft Defender Antivirus to disable itself](/windows/security/threat-protection/microsoft-defender-antivirus/microsoft-defender-antivirus-compatibility).
52
+
-[Real-time protection](/windows/security/threat-protection/microsoft-defender-antivirus/configure-real-time-protection-microsoft-defender-antivirus) is enabled.
53
+
- Audit mode isn't enabled. Use Group Policy to set the rule to `Disabled` (value: `0`) as described in [Enable attack surface reduction rules](enable-attack-surface-reduction.md).
51
54
52
-
- Endpoints are using Microsoft Defender Antivirus as the sole antivirus protection app. [Using any other antivirus app causes Microsoft Defender Antivirus to disable itself](/windows/security/threat-protection/microsoft-defender-antivirus/microsoft-defender-antivirus-compatibility).
55
+
If these prerequisites are met, proceed to the next step to test the rule in audit mode.
53
56
54
-
-[Real-time protection](/windows/security/threat-protection/microsoft-defender-antivirus/configure-real-time-protection-microsoft-defender-antivirus) is enabled.
57
+
## Best practices when setting up attack surface reduction rules using Group Policy
55
58
56
-
- Audit mode isn't enabled. Use Group Policy to set the rule to **Disabled** (value: **0**) as described in [Enable attack surface reduction rules](enable-attack-surface-reduction.md).
59
+
When setting up the attack surface reduction rules by using Group Policy, here are a few best practices to avoid making common mistakes:
57
60
58
-
If these prerequisites are met, proceed to the next step to test the rule in audit mode.
61
+
1. Make sure when adding the GUID for attack surface reduction rules, there are **no double quotes** (like this: "ASR Rules GUID") at the beginning or at the end of the GUID.
62
+
63
+
2. Make sure that there are **no spaces** at the beginning or at the end when adding the GUID for attack surface reduction rules.
59
64
60
65
## Use audit mode to test the rule
61
66
62
67
Follow these instructions in [Use the demo tool to see how attack surface reduction rules work](attack-surface-reduction-rules-deployment-test.md) to test the specific rule you're encountering problems with.
63
68
64
-
1. Enable audit mode for the specific rule you want to test. Use Group Policy to set the rule to **Audit mode** (value: **2**) as described in [Enable attack surface reduction rules](enable-attack-surface-reduction.md). Audit mode allows the rule to report the file or process, but allows it to run.
65
-
66
-
2. Perform the activity that is causing an issue (for example, open or execute the file or process that should be blocked but is being allowed).
69
+
1. Enable audit mode for the specific rule you want to test. Use Group Policy to set the rule to `Audit mode` (value: `2`) as described in [Enable attack surface reduction rules](enable-attack-surface-reduction.md). Audit mode allows the rule to report the file or process, but allows it to run.
67
70
68
-
3.[Review the attack surface reduction rule event logs](attack-surface-reduction.md) to see if the rule would block the file or process if the rule were set to **Enabled**.
71
+
2. Perform the activity that is causing an issue. For example, open the file or run the process that should be blocked, but is allowed.
69
72
70
-
If a rule isn't blocking a file or process that you're expecting it should block, first check if audit mode is enabled.
73
+
3.[Review the attack surface reduction rule event logs](attack-surface-reduction.md) to see if the rule would block the file or process if the rule were set to `Enabled`.
71
74
72
-
Audit mode might be enabled for testing another feature, or by an automated PowerShell script, and might not be disabled after the tests were completed.
75
+
If a rule isn't blocking a file or process that you're expecting it should block, first check to see if audit mode is enabled. Audit mode might be enabled for testing another feature, or by an automated PowerShell script, and might not be disabled after the tests were completed.
73
76
74
77
If you've tested the rule with the demo tool and with audit mode, and attack surface reduction rules are working on preconfigured scenarios, but the rule isn't working as expected, proceed to either of the following sections based on your situation:
75
78
76
-
1. If the attack surface reduction rule is blocking something that it shouldn't block (also known as a false positive), you can [first add an attack surface reduction rule exclusion](#add-exclusions-for-a-false-positive).
77
-
78
-
2. If the attack surface reduction rule isn't blocking something that it should block (also known as a false negative), you can proceed immediately to the last step, [collecting diagnostic data and submitting the issue to us](#collect-diagnostic-data-for-file-submissions).
79
+
- If the attack surface reduction rule is blocking something that it shouldn't block (also known as a false positive), you can [first add an attack surface reduction rule exclusion](#add-exclusions-for-a-false-positive).
80
+
- If the attack surface reduction rule isn't blocking something that it should block (also known as a false negative), you can proceed immediately to the last step, [collecting diagnostic data and submitting the issue to us](#collect-diagnostic-data-for-file-submissions).
79
81
80
82
## Add exclusions for a false positive
81
83
82
84
If the attack surface reduction rule is blocking something that it shouldn't block (also known as a false positive), you can add exclusions to prevent attack surface reduction rules from evaluating the excluded files or folders.
83
85
84
-
To add an exclusion, see [Customize Attack surface reduction](attack-surface-reduction-rules-deployment-implement.md#customize-attack-surface-reduction-rules).
86
+
To add an exclusion, see [Customize attack surface reduction](attack-surface-reduction-rules-deployment-implement.md#customize-attack-surface-reduction-rules).
85
87
86
88
> [!IMPORTANT]
87
89
> You can specify individual files and folders to be excluded, but you cannot specify individual rules.
@@ -95,7 +97,7 @@ Use the [Microsoft Security Intelligence web-based submission form](https://www.
95
97
96
98
When you report a problem with attack surface reduction rules, you're asked to collect and submit diagnostic data that can be used by Microsoft support and engineering teams to help troubleshoot issues.
97
99
98
-
1. Open an elevated command prompt and change to the Windows Defender directory:
100
+
1. Open Command Prompt as an administrator and open the Windows Defender directory:
99
101
100
102
```console
101
103
cd "c:\program files\Windows Defender"
@@ -114,4 +116,5 @@ When you report a problem with attack surface reduction rules, you're asked to c
0 commit comments