Skip to content

Commit c8b469a

Browse files
authored
Merge pull request #2143 from MicrosoftDocs/mde-linux
Mde linux
2 parents 73152a9 + de7f224 commit c8b469a

File tree

1 file changed

+22
-22
lines changed

1 file changed

+22
-22
lines changed

defender-endpoint/comprehensive-guidance-on-linux-deployment.md

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -14,11 +14,14 @@ ms.collection:
1414
ms.topic: conceptual
1515
ms.subservice: linux
1616
search.appverid: met150
17-
ms.date: 10/28/2024
17+
ms.date: 12/10/2024
1818
---
1919

2020
# Advanced deployment guidance for Microsoft Defender for Endpoint on Linux
2121

22+
> [!TIP]
23+
> We are excited to share that Microsoft Defender for Endpoint on Linux now extends support for ARM64-based Linux servers in preview! For more information, see [Microsoft Defender for Endpoint on Linux for ARM64-based devices (preview)](mde-linux-arm.md).
24+
2225
This article provides advanced deployment guidance for Microsoft Defender for Endpoint on Linux. You get a brief summary of the deployment steps, learn about the system requirements, then be guided through the actual deployment steps. You'll also learn how to verify that the device has been correctly onboarded.
2326

2427
For information about Microsoft Defender for Endpoint capabilities, see [Advanced Microsoft Defender for Endpoint capabilities](#advanced-microsoft-defender-for-endpoint-capabilities).
@@ -29,23 +32,21 @@ To learn about other ways to deploy Microsoft Defender for Endpoint on Linux, se
2932
- [Puppet based deployment](linux-install-with-puppet.md)
3033
- [Ansible based deployment](linux-install-with-ansible.md)
3134
- [Deploy Defender for Endpoint on Linux with Chef](linux-deploy-defender-for-endpoint-with-chef.md)
35+
- [Microsoft Defender for Endpoint on Linux for ARM64-based devices (preview)](mde-linux-arm.md)
3236

3337
## Deployment summary
3438

35-
Learn about the general guidance on a typical Microsoft Defender for Endpoint on Linux deployment. The applicability of some steps is determined by the requirements of your Linux environment.
39+
Learn about the general guidance on a typical Microsoft Defender for Endpoint on Linux deployment. The applicability of some steps is determined by the requirements of your Linux environment. Some of the steps are optional and aren't specific to Defender for Endpoint; however, consider doing all the steps for best results.
3640

3741
1. [Prepare your network environment](#1-prepare-your-network-environment).
3842

3943
2. [Capture performance data from the endpoint](#2-capture-performance-data-from-the-endpoint).
4044

41-
> [!NOTE]
42-
> Consider doing the following optional items, even though they are not Microsoft Defender for Endpoint specific, they tend to improve performance in Linux systems.
43-
44-
3. [(Optional) Check for filesystem errors 'fsck' (akin to chkdsk)](#3-optional-check-for-filesystem-errors-fsck-akin-to-chkdsk).
45+
3. (Optional) [Check for filesystem errors 'fsck' (akin to chkdsk)](#3-optional-check-for-filesystem-errors-fsck-akin-to-chkdsk).
4546

46-
4. [(Optional) Update storage subsystem drivers](#4-optional-update-storage-subsystem-drivers).
47+
4. (Optional) [Update storage subsystem drivers](#4-optional-update-storage-subsystem-drivers).
4748

48-
5. [(Optional) Update nic drivers](#5-optional-update-nic-drivers).
49+
5. (Optional) [Update nic drivers](#5-optional-update-nic-drivers).
4950

5051
6. [Confirm system requirements and resource recommendations are met](#6-confirm-system-requirements-and-resource-recommendations-are-met).
5152

@@ -85,27 +86,27 @@ Learn about the general guidance on a typical Microsoft Defender for Endpoint on
8586

8687
Add the Microsoft Defender for Endpoint URLs and/or IP addresses to the allowed list, and prevent traffic from being SSL inspected.
8788

88-
8989
### Network connectivity of Microsoft Defender for Endpoint
9090

9191
Use the following steps to check the network connectivity of Microsoft Defender for Endpoint:
9292

93-
1. See [Step 1: Allow destinations for the Microsoft Defender for Endpoint traffic](#step-1-allow-destinations-for-the-microsoft-defender-for-endpoint-traffic) that are allowed for the Microsoft Defender for Endpoint traffic.
93+
1. See [Allow destinations for the Microsoft Defender for Endpoint traffic](#step-1-allow-destinations-for-the-microsoft-defender-for-endpoint-traffic).
9494

95-
2. If the Linux servers are behind a proxy, then set the proxy settings. For more information, see [Set up proxy settings](#step-2-set-up-proxy-settings).
95+
2. If the Linux servers are behind a proxy, set proxy settings. For more information, see [Set up proxy settings](#step-2-set-up-proxy-settings).
9696

9797
3. Verify that the traffic isn't being inspected by SSL inspection (TLS inspection). This is the most common network related issue when setting up Microsoft Defender Endpoint, see [Verify SSL inspection isn't being performed on the network traffic](#step-3-verify-ssl-inspection-isnt-being-performed-on-the-network-traffic).
9898

9999
> [!NOTE]
100-
> - Traffic for Defender for Endpoint should NOT be inspected by SSL inspection (TLS inspection). This applies to all supported operating systems (Windows, Linux, and MacOS).
100+
> - Traffic for Defender for Endpoint should NOT be inspected by SSL inspection (TLS inspection). This applies to all supported operating systems (Windows, Linux, and Mac).
101101
> - To allow connectivity to the consolidated set of URLs or IP addresses, ensure your devices are running the latest component versions. See [Onboarding devices using streamlined connectivity for Microsoft Defender for Endpoint](configure-device-connectivity.md) for more information.
102102
103-
For more information see [Troubleshoot cloud connectivity issues](#troubleshoot-cloud-connectivity-issues).
103+
For more information, see [Troubleshoot cloud connectivity issues](#troubleshoot-cloud-connectivity-issues).
104104

105105
#### Step 1: Allow destinations for the Microsoft Defender for Endpoint traffic
106106

107-
1. Go to [STEP 1: Configure your network environment to ensure connectivity with Defender for Endpoint service](configure-environment.md) to find the relevant destinations that need to be accessible to devices inside your network environment
108-
2. Configure your Firewall/Proxy/Network to allow the relevant URLs and/or IP addresses
107+
1. See [Configure your network environment to ensure connectivity with Defender for Endpoint service](configure-environment.md) to find the relevant destinations that need to be accessible to devices inside your network environment
108+
109+
2. Configure your Firewall/Proxy/Network to allow the relevant URLs and/or IP addresses.
109110

110111
#### Step 2: Set up proxy settings
111112

@@ -125,15 +126,15 @@ The following table lists the supported proxy settings:
125126

126127
#### Step 3: Verify SSL inspection isn't being performed on the network traffic
127128

128-
To prevent man-in-the-middle attacks, all Microsoft Azure hosted traffic uses certificate pinning. As a result, SSL inspections by major firewall systems aren't allowed. You must bypass SSL inspection for Microsoft Defender for Endpoint URLs. For additional information about the certificate pinning process, see [enterprise-certificate-pinning](/windows/security/identity-protection/enterprise-certificate-pinning).
129+
To prevent man-in-the-middle attacks, all Microsoft Azure hosted traffic uses certificate pinning. As a result, SSL inspections by major firewall systems aren't allowed. You must bypass SSL inspection for Microsoft Defender for Endpoint URLs. For more information about the certificate pinning process, see [enterprise-certificate-pinning](/windows/security/identity-protection/enterprise-certificate-pinning).
129130

130131
##### Troubleshoot cloud connectivity issues
131132

132133
For more information, see [Troubleshooting cloud connectivity issues for Microsoft Defender for Endpoint on Linux](linux-support-connectivity.md).
133134

134135
## 2. Capture performance data from the endpoint
135136

136-
Capture performance data from the endpoints that have Defender for Endpoint installed. This includes disk space availability on all mounted partitions, memory usage, process list, and CPU usage (aggregate across all cores).
137+
Capture performance data from the endpoints that have Defender for Endpoint installed. This data includes disk space availability on all mounted partitions, memory usage, process list, and CPU usage (aggregate across all cores).
137138

138139
## 3. (Optional) Check for filesystem errors 'fsck' (akin to chkdsk)
139140

@@ -157,21 +158,21 @@ For a detailed list of supported Linux distros, see [System requirements](micros
157158
|---|---|
158159
|Disk space |Minimum: 2 GB <br> NOTE: More disk space might be needed if cloud diagnostics are enabled for crash collections. |
159160
|RAM |1 GB<br> 4 GB is preferred|
160-
|CPU |If the Linux system is running only one vcpu, we recommend it be increased to two vcpu's<br> 4 cores are preferred |
161+
|CPU |If the Linux system is running only one vcpu, we recommend it be increased to two vcpu's<br> Four cores are preferred |
161162

162163
|OS version|Kernel filter driver|Comments|
163164
|---|---|---|
164-
|RHEL 7.x, RHEL 8.x, and RHEL 9.x |No kernel filter driver, the fanotify kernel option must be enabled|akin to Filter Manager (fltmgr, accessible via `fltmc.exe`) in Windows|
165+
|RHEL 7.x, RHEL 8.x, and RHEL 9.x |No kernel filter driver, the `fanotify` kernel option must be enabled|akin to Filter Manager (fltmgr, accessible via `fltmc.exe`) in Windows|
165166
## 7. Add your existing solution to the exclusion list for Microsoft Defender Antivirus
166167

167168
This step of the setup process involves adding Defender for Endpoint to the exclusion list for your existing endpoint protection solution and any other security products your organization is using. You can choose from several methods to add your exclusions to Microsoft Defender Antivirus.
168169

169170
> [!TIP]
170171
> To get help configuring exclusions, refer to your solution provider's documentation.
171172
172-
- Your ability to run Microsoft Defender for Endpoint on Linux alongside a non-Microsoft antimalware product depends on the implementation details of that product. If the other antimalware product uses fanotify, it has to be uninstalled to eliminate performance and stability side effects resulting from running two conflicting agents.
173+
- Your ability to run Microsoft Defender for Endpoint on Linux alongside a non-Microsoft antimalware product depends on the implementation details of that product. If the other antimalware product uses `fanotify`, it has to be uninstalled to eliminate performance and stability side effects resulting from running two conflicting agents.
173174

174-
- To check if there's a non-Microsoft antimalware that is running FANotify, you can run `mdatp health`, then check the result:
175+
- To check if there's a non-Microsoft antimalware that is running `fanotify`, you can run `mdatp health`, then check the results:
175176

176177
:::image type="content" source="media/mdatp-health-result.png" alt-text="Image of mdatp health result":::
177178

@@ -199,7 +200,6 @@ This step of the setup process involves adding Defender for Endpoint to the excl
199200
When you add [exclusions to Microsoft Defender Antivirus scans](/windows/security/threat-protection/microsoft-defender-antivirus/configure-exclusions-microsoft-defender-antivirus), you should add path and process exclusions.
200201

201202
> [!NOTE]
202-
>
203203
> - Antivirus exclusions apply to the antivirus engine.
204204
> - Indicators allow/block apply to the antivirus engine.
205205

0 commit comments

Comments
 (0)