Skip to content

Commit b76e57b

Browse files
Merge pull request #2596 from AruneemaXD/AruneemaXD-patch-4
Update linux-exclusions.md -- Emm is reviewing
2 parents 760f6bf + 11804dd commit b76e57b

File tree

1 file changed

+20
-13
lines changed

1 file changed

+20
-13
lines changed

defender-endpoint/linux-exclusions.md

Lines changed: 20 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,8 @@
22
title: Configure and validate exclusions for Microsoft Defender for Endpoint on Linux
33
description: Provide and validate exclusions for Microsoft Defender for Endpoint on Linux. Exclusions can be set for files, folders, and processes.
44
ms.service: defender-endpoint
5-
ms.author: deniseb
6-
author: denisebmsft
5+
ms.author: ewalsh
6+
author: emmwalshh
77
ms.reviewer: gopkr, ardeshmukh
88
ms.localizationpriority: medium
99
manager: deniseb
@@ -15,7 +15,7 @@ ms.collection:
1515
ms.topic: conceptual
1616
ms.subservice: linux
1717
search.appverid: met150
18-
ms.date: 10/14/2024
18+
ms.date: 01/31/2025
1919
---
2020

2121
# Configure and validate exclusions for Microsoft Defender for Endpoint on Linux
@@ -39,22 +39,26 @@ You can exclude certain files, folders, processes, and process-opened files from
3939
Exclusions can be useful to avoid incorrect detections on files or software that are unique or customized to your organization. Global exclusions are useful for mitigating performance issues caused by Defender for Endpoint on Linux.
4040

4141
> [!WARNING]
42-
> Defining exclusions lowers the protection offered by Defender for Endpoint on Linux. You should always evaluate the risks that are associated with implementing exclusions, and you should only exclude files that you are confident are not malicious.
42+
> Defining exclusions lowers the protection offered by Defender for Endpoint on Linux. You should always evaluate the risks that are associated with implementing exclusions, and you should only exclude files that you're confident aren't malicious.
4343
4444
## Supported exclusion scopes
4545

4646
As described in an earlier section, we support two exclusion scopes: antivirus (`epp`) and global (`global`) exclusions.
4747

48-
Antivirus exclusions can be used to exclude trusted files and processes from real-time protection while still having EDR visibility. Global exclusions are applied at sensor level and to mute the events that match exclusion conditions very early in the flow, before any processing is done, thus stopping all EDR alerts and antivirus detections.
48+
Antivirus exclusions can be used to exclude trusted files and processes from real-time protection while still having EDR visibility. Global exclusions are applied at sensor level and to mute the events that match exclusion conditions early in the flow, before any processing is done, thus stopping all EDR alerts and antivirus detections.
4949

5050
> [!NOTE]
51-
> Global (`global`) is a new exclusion scope that we are introducing in addition to antivirus (`epp`) exclusion scopes that are already supported by Microsoft.
51+
> Global (`global`) is a new exclusion scope that we're introducing in addition to antivirus (`epp`) exclusion scopes that are already supported by Microsoft.
5252
5353
| Exclusion Category | Exclusion Scope | Description |
5454
| --- | --- | --- |
5555
| Antivirus Exclusion | Antivirus engine <br/>*(scope: epp)* | Excludes content from antivirus (AV) scans and on-demand scans.|
5656
| Global Exclusion | Antivirus and endpoint detections and response engine <br/>*(scope: global)* | Excludes events from real time protection and EDR visibility. Doesn't apply to on-demand scans by default. |
5757

58+
> [!IMPORTANT]
59+
> Global exclusions don't apply to network protection, so alerts generated by network protection will still be visible.
60+
> To exclude processes from network protection, please use `mdatp network-protection exclusion`
61+
5862
## Supported exclusion types
5963

6064
The following table shows the exclusion types supported by Defender for Endpoint on Linux.
@@ -73,15 +77,15 @@ File, folder, and process exclusions support the following wildcards:
7377

7478
> [!NOTE]
7579
> File path needs to be present before adding or removing file exclusions with scope as global.
76-
> Wildcards are not supported while configuring global exclusions.
80+
> Wildcards aren't supported while configuring global exclusions.
7781
7882
Wildcard|Description|Examples|
7983
---|---|---
8084
\*|Matches any number of any characters including none <br/> *(note if this wildcard isn't used at the end of the path then it substitutes only one folder)* | `/var/*/tmp` includes any file in `/var/abc/tmp` and its subdirectories, and `/var/def/tmp` and its subdirectories. It doesn't include `/var/abc/log` or `/var/def/log` <p> <p> `/var/*/` only includes any files in its subdirectories such as `/var/abc/`, but not files directly inside `/var`.
8185
?|Matches any single character|`file?.log` includes `file1.log` and `file2.log`, but not`file123.log`
8286

8387
> [!NOTE]
84-
> For antivirus exclusions, when using the * wildcard at the end of the path, it will match all files and subdirectories under the parent of the wildcard.
88+
> For antivirus exclusions, when using the * wildcard at the end of the path, it matches all files and subdirectories under the parent of the wildcard.
8589
8690
## How to configure the list of exclusions
8791

@@ -153,7 +157,7 @@ mdatp exclusion
153157
154158
Examples:
155159

156-
- Add an exclusion for a file extension *(Extension exclusion isn't supported for global exclusion scope)* :
160+
- Add an exclusion for a file extension *(Extension exclusion isn't supported for global exclusion scope)* :
157161

158162
```bash
159163
mdatp exclusion extension add --name .txt
@@ -253,14 +257,14 @@ Examples:
253257
- Add an exclusion for a folder with a wildcard in it:
254258

255259
> [!NOTE]
256-
> Wildcards are not supported while configuring global exclusions.
260+
> Wildcards aren't supported while configuring global exclusions.
257261
258262
```bash
259263
mdatp exclusion folder add --path "/var/*/tmp"
260264
```
261265
262266
> [!NOTE]
263-
> This will only exclude paths under */var/\*/tmp/*, but not folders which are siblings of *tmp*; for example, */var/this-subfolder/tmp*, but not */var/this-subfolder/log*.
267+
> This excludes paths under */var/\*/tmp/*, but not folders which are siblings of *tmp*; for example, */var/this-subfolder/tmp*, but not */var/this-subfolder/log*.
264268
265269
```bash
266270
mdatp exclusion folder add --path "/var/" --scope epp
@@ -272,7 +276,7 @@ Examples:
272276
```
273277
274278
> [!NOTE]
275-
> This will exclude all paths whose parent is */var/*; for example, */var/this-subfolder/and-this-subfolder-as-well*.
279+
> This excludes all paths whose parent is */var/*; for example, */var/this-subfolder/and-this-subfolder-as-well*.
276280
277281
```console
278282
Folder exclusion configured successfully
@@ -317,12 +321,15 @@ Examples:
317321
318322
```bash
319323
mdatp exclusion process add --name cat --scope epp
320-
mdatp exclusion process add --name dog --scope global
324+
mdatp exclusion process add --name /usr/bin/dog --scope global
321325
```
322326
323327
```console
324328
Process exclusion configured successfully
325329
```
330+
331+
> [!NOTE]
332+
> Use full path for process exclusion with `global` scope.
326333
327334
## Validate exclusions lists with the EICAR test file
328335

0 commit comments

Comments
 (0)