Skip to content

Commit ec80797

Browse files
authored
Merge pull request #3309 from MicrosoftDocs/mde-fixes
MDE on Linux fixes
2 parents 9fb8e72 + 1e698b0 commit ec80797

7 files changed

+81
-70
lines changed

defender-endpoint/linux-preferences.md

Lines changed: 11 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
---
2-
title: Set preferences for Microsoft Defender for Endpoint on Linux
2+
title: Configure security settings in Microsoft Defender for Endpoint on Linux
33
ms.reviewer: gopkr, ardeshmukh
44
description: Describes how to configure Microsoft Defender for Endpoint on Linux in enterprises.
55
ms.service: defender-endpoint
66
ms.author: deniseb
77
author: denisebmsft
88
ms.localizationpriority: medium
9-
ms.date: 03/12/2025
9+
ms.date: 03/28/2025
1010
manager: deniseb
1111
audience: ITPro
1212
ms.collection:
@@ -18,7 +18,7 @@ ms.subservice: linux
1818
search.appverid: met150
1919
---
2020

21-
# Configure security settings and policies for Microsoft Defender for Endpoint on Linux
21+
# Configure security settings in Microsoft Defender for Endpoint on Linux
2222

2323
[!INCLUDE [Microsoft Defender XDR rebranding](../includes/microsoft-defender.md)]
2424

@@ -29,9 +29,9 @@ search.appverid: met150
2929

3030
> Want to experience Defender for Endpoint? [Sign up for a free trial.](https://go.microsoft.com/fwlink/p/?linkid=2225630)
3131
32-
## Overview of settings and policies to configure
32+
## Configure your security settings
3333

34-
Microsoft Defender for Endpoint on Linux includes antivirus, anti-malware protection, endpoint detection, and response capabilities. This article summarizes important settings to configure, with links to additional resources.
34+
Microsoft Defender for Endpoint on Linux includes antivirus, anti-malware protection, endpoint detection, and response capabilities. This article summarizes important security settings to configure and includes links to additional resources.
3535

3636
| Settings | Description|
3737
|--|--|
@@ -44,22 +44,22 @@ Microsoft Defender for Endpoint on Linux includes antivirus, anti-malware protec
4444
| 7. Deploy updates. | Microsoft regularly publishes software updates to improve performance, security, and to deliver new features. <br/><br/>See [Deploy updates for Microsoft Defender for Endpoint on Linux](linux-updates.md). |
4545
| 8. Configure network protection (preview) | Network protection helps prevent employees from using any application to access dangerous domains that might host phishing scams, exploits, and other malicious content on the Internet. <br/><br/>See [Network protection for Linux](network-protection-linux.md). |
4646

47-
## Options for configuring security policies and settings
47+
## Options for configuring security settings
4848

49-
To configure your security policies and settings for Defender for Endpoint on Linux, you have two main options:
49+
To configure your security settings in Defender for Endpoint on Linux, you have two main options:
5050

5151
- Use the Microsoft Defender portal (Defender for Endpoint Security Settings Management); or
5252
- Use a configuration profile
5353

54-
If you prefer to use command line to configure your security settings, you can use that to configure certain settings, gather diagnostics, run scans, and more. See [Resources](linux-resources.md#configure-from-the-command-line).
54+
If you prefer to use command line, you can use that to configure certain settings, gather diagnostics, run scans, and more. See [Linux resources: Configure using command line](linux-resources.md#configure-from-the-command-line).
5555

5656
### Defender for Endpoint Security Settings Management
5757

58-
You can configure Defender for Endpoint on Linux in the Microsoft Defender portal ([https://security.microsoft.com](https://security.microsoft.com)) through functionality known as Security Settings Management. For more information, including how to create, edit, and verify your security policies, see [Use Microsoft Defender for Endpoint Security Settings Management to manage Microsoft Defender Antivirus](mde-security-settings-management.md).
58+
You can configure Defender for Endpoint on Linux in the Microsoft Defender portal ([https://security.microsoft.com](https://security.microsoft.com)) through functionality known as Defender for Endpoint Security Settings Management. For more information, including how to create, edit, and verify security policies, see [Use Microsoft Defender for Endpoint Security Settings Management to manage Microsoft Defender Antivirus](mde-security-settings-management.md).
5959

6060
### Configuration profile
6161

62-
You can configure Defender for Endpoint on Linux through a configuration profile that uses a `.json` file. After you have set up your profile, you can deploy it by using your management tool of choice. Preferences managed by the enterprise take precedence over the ones set locally on the device. In other words, users in your enterprise aren't able to change preferences that are set through this configuration profile. If exclusions were added through the managed configuration profile, they can only be removed through the managed configuration profile. The command line works for exclusions that were added locally.
62+
You can configure settings in Defender for Endpoint on Linux through a configuration profile that uses a `.json` file. After you have set up your profile, you can deploy it by using your management tool of choice. Preferences managed by the enterprise take precedence over the ones set locally on the device. In other words, users in your enterprise aren't able to change preferences that are set through this configuration profile. If exclusions were added through the managed configuration profile, they can only be removed through the managed configuration profile. The command line works for exclusions that were added locally.
6363

6464
This article describes the structure of this profile (including a recommended profile that you can use to get started) and instructions on how to deploy the profile.
6565

@@ -456,6 +456,7 @@ By default, NFS and Fuse are unmonitored from RTP, Quick, and Full scans. Howeve
456456
}
457457
}
458458
```
459+
459460
To remove both NFS and Fuse from unmonitored list of filesystems, use the following snippet:
460461

461462
```JSON

defender-endpoint/linux-support-connectivity.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ ms.collection:
1515
ms.topic: conceptual
1616
ms.subservice: linux
1717
search.appverid: met150
18-
ms.date: 03/12/2025
18+
ms.date: 03/28/2025
1919
---
2020

2121
# Troubleshoot cloud connectivity issues for Microsoft Defender for Endpoint on Linux
@@ -56,7 +56,7 @@ Testing connection with https://uk-v20.events.data.microsoft.com/ping ... [OK]
5656
Testing connection with https://v20.events.data.microsoft.com/ping ... [OK]
5757
```
5858

59-
If the connectivity test fails, check if the device has Internet access and if [network connections](mde-linux-prerequisites.md#network-connections) are blocked by a proxy or firewall.
59+
If the connectivity test fails, check if the device has Internet access. Also check to see if network connections are blocked by a proxy or firewall. For more information, see [Verify that devices can connect to Defender for Endpoint cloud services](mde-linux-prerequisites.md#verify-that-devices-can-connect-to-defender-for-endpoint-cloud-services).
6060

6161
Failures with curl error 35 or 60, indicate certificate pinning rejection. Check to see if the connection is under SSL or HTTPS inspection. If so, add Microsoft Defender for Endpoint to the allowlist.
6262

@@ -96,7 +96,6 @@ To set the proxy for mdatp, use the following command:
9696
mdatp config proxy set --value http://address:port
9797
```
9898

99-
10099
Upon success, attempt another connectivity test from the command line:
101100

102101
```bash

defender-endpoint/mde-linux-deployment-on-sap.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ ms.collection:
1515
ms.topic: conceptual
1616
ms.subservice: linux
1717
search.appverid: met150
18-
ms.date: 02/04/2025
18+
ms.date: 03/28/2025
1919
ms.custom:
2020
- partner-contribution
2121
---
@@ -65,7 +65,7 @@ Here are some important point about SAP applications on Linux Server:
6565

6666
- Microsoft Defender for Endpoint [Build: 101.24082.0004 | Release version: 30.124082.0004.0](/defender-endpoint/linux-whatsnew#oct-2024-build-101240820004--release-version-3012408200040) or later must be deployed.
6767
- Microsoft Defender for Endpoint on Linux supports [Linux releases](/defender-endpoint/mde-linux-prerequisites) used by SAP applications.
68-
- Microsoft Defender for Endpoint on Linux requires connectivity to specific Internet endpoints from VMs to update antivirus definitions. For more information, see [Network connections](mde-linux-prerequisites.md#network-connections).
68+
- Microsoft Defender for Endpoint on Linux requires connectivity to specific Internet endpoints from VMs to update antivirus definitions. For more information, see [Verify that devices can connect to Defender for Endpoint cloud services](mde-linux-prerequisites.md#verify-that-devices-can-connect-to-defender-for-endpoint-cloud-services).
6969
- Microsoft Defender for Endpoint on Linux requires some `crontab` (or other task scheduler) entries to schedule scans, log rotation, and Microsoft Defender for Endpoint updates. Enterprise security teams normally manage these entries. For more information, see [How to schedule an update for Microsoft Defender for Endpoint on Linux](linux-update-mde-linux.md).
7070

7171
As of December 2024, Defender for Endpoint on Linux can safely be configured with real-time protection enabled.

defender-endpoint/mde-linux-prerequisites.md

Lines changed: 29 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ ms.collection:
1515
ms.topic: conceptual
1616
ms.subservice: linux
1717
search.appverid: met150
18-
ms.date: 03/14/2025
18+
ms.date: 03/31/2025
1919
---
2020

2121
# Prerequisites for Microsoft Defender for Endpoint on Linux
@@ -53,9 +53,10 @@ For detailed licensing information, see [Product Terms: Microsoft Defender for E
5353
5454
## Software requirements
5555

56-
- Linux server endpoints should be able to access the [Microsoft Defender portal](https://security.microsoft.com). If necessary, [configure static proxy discovery](linux-static-proxy-configuration.md).
56+
- Linux server endpoints should be able to access the `*.endpoint.security.microsoft.com`. If necessary, [configure static proxy discovery](linux-static-proxy-configuration.md).
5757
- Linux server endpoints should have systemd (system manager) installed.
5858
- Administrative privileges on the Linux server endpoint are required for installation.
59+
- An appropriate role assigned in Defender for Endpoint. See [Role-based access control](/defender-endpoint/prepare-deployment#role-based-access-control).
5960

6061
> [!NOTE]
6162
> Linux distributions using system manager support both SystemV and Upstart.
@@ -94,8 +95,14 @@ The following Linux server distributions and x64 (AMD64/EM64T) versions are supp
9495

9596
- Ubuntu 20.04 Arm64
9697
- Ubuntu 22.04 Arm64
98+
- Ubuntu 24.04 ARM64
9799
- Amazon Linux 2 Arm64
98100
- Amazon Linux 2023 Arm64
101+
- RHEL 8.x ARM64
102+
- RHEL 9.x ARM64
103+
- Oracle Linux 8.x ARM64
104+
- Oracle Linux 9.x ARM64
105+
- SUSE Linux Enterprise Server 15 (SP5, SP6) ARM64
99106

100107
Support for [Microsoft Defender for Endpoint on Linux for Arm64-based devices](/defender-endpoint/mde-linux-arm) is now in preview.
101108

@@ -136,13 +143,12 @@ Support for [Microsoft Defender for Endpoint on Linux for Arm64-based devices](/
136143
> NFS v3 mount points to be scanned thoroughly and are required to set the `no_root_squash` export option on these mount points.
137144
> Without this option, scanning NFS v3 can potentially fail due to lack of permissions.
138145
139-
## Network connections
146+
## Verify that devices can connect to Defender for Endpoint cloud services
140147

141-
- Verify that your devices can connect to Microsoft Defender for Endpoint cloud services.
142148
- Prepare your environment, as described in Step 1 of the following article [Configure your network environment to ensure connectivity with Defender for Endpoint service](/defender-endpoint/configure-environment)
143149
- Connect Defender for Endpoint on Linux through a proxy server by using the following discovery methods:
144150
1. Transparent proxy
145-
2. Manual static proxy configuration
151+
2. [Manual static proxy configuration](/defender-endpoint/linux-static-proxy-configuration#installation-time-configuration)
146152
- Permit anonymous traffic in the previously listed URLs, if a proxy or firewall blocks traffic.
147153

148154
> [!NOTE]
@@ -159,10 +165,23 @@ For troubleshooting steps, see [Troubleshoot cloud connectivity issues for Micro
159165

160166
## External package dependency
161167

162-
For information on external package dependencies, see the following articles:
168+
If the Microsoft Defender for Endpoint installation fails due to missing dependencies errors, you can manually download the prerequisite dependencies. The following external package dependencies exist for the mdatp package:
163169

164-
- [Microsoft Defender for Endpoint on Linux](/defender-endpoint/microsoft-defender-endpoint-linux)
165-
- [Configure security settings and policies for Microsoft Defender for Endpoint on Linux](/defender-endpoint/linux-preferences)
170+
- The mdatp RPM package requires `glibc >= 2.17`, `policycoreutils`, `selinux-policy-targeted`, and `mde-netfilter`.
171+
- For RHEL6 the mdatp RPM package requires `policycoreutils`, `libselinux`, and `mde-netfilter`.
172+
- For DEBIAN the mdatp package requires `libc6 >= 2.23`, `uuid-runtime`, and `mde-netfilter`.
173+
174+
> [!NOTE]
175+
> Beginning with version `101.24082.0004`, Defender for Endpoint on Linux no longer supports the `Auditd` event provider. We're transitioning completely to the more efficient eBPF technology.
176+
> If eBPF isn't supported on your machines, or if there are specific requirements to remain on Auditd, and your machines are using Defender for Endpoint on Linux version `101.24072.0001` or older, the following additional dependency on the auditd package exists for mdatp:
177+
> - The mdatp RPM package requires `audit`, `semanage`.
178+
> - For DEBIAN, the mdatp package requires `auditd`.
179+
> - For Mariner, the mdatp package requires `audit`.
180+
181+
The `mde-netfilter` package also has the following package dependencies:
182+
183+
- For DEBIAN, the mde-netfilter package requires `libnetfilter-queue1` and `libglib2.0-0`
184+
- For RPM, the mde-netfilter package requires `libmnl`, `libnfnetlink`, `libnetfilter_queue`, and `glib2`
166185

167186
## Installation instructions
168187

@@ -179,30 +198,15 @@ There are several methods and tools that you can use to deploy Microsoft Defende
179198
- [Guidance for Defender for Endpoint on Linux Server with SAP](/defender-endpoint/mde-linux-deployment-on-sap)
180199

181200
> [!IMPORTANT]
182-
> Installing Microsoft Defender for Endpoint in any location other than the default install path isn't supported. On Linux, Microsoft Defender for Endpoint creates an mdatp user with random UID and GID values. If you want to control these values, create an mdatp user before installation using the /usr/sbin/nologin shell option. Here's an example: `mdatp:x:UID:GID::/home/mdatp:/usr/sbin/nologin`.
183-
184-
### Troubleshoot installation issues
185-
186-
If you experience any installation issues, for self-troubleshooting, follow these steps:
187-
188-
1. For information on how to find the log that's generated automatically when an installation error occurs, see [Log installation issues](linux-resources.md#log-installation-issues).
189-
190-
2. For information about common installation issues, see [Installation issues](/defender-endpoint/linux-support-install).
191-
192-
3. If health of the device is `false`, see [Defender for Endpoint agent health issues](/defender-endpoint/health-status).
193-
194-
4. For product performance issues, see [Troubleshoot performance issues](/defender-endpoint/linux-support-perf).
195-
196-
5. For proxy and connectivity issues, see [Troubleshoot cloud connectivity issues](/defender-endpoint/linux-support-connectivity).
201+
> Installing Microsoft Defender for Endpoint in any location other than the default install path isn't supported. On Linux, Microsoft Defender for Endpoint creates an mdatp user with random UID and GID values. If you want to control these values, create an mdatp user before installation using the `/usr/sbin/nologin` shell option. Here's an example: `mdatp:x:UID:GID::/home/mdatp:/usr/sbin/nologin`.
197202
198-
To get support from Microsoft, open a support ticket, and provide the log files created by using the [client analyzer](/defender-endpoint/overview-client-analyzer).
203+
If you experience any installation issues, self-troubleshooting resources are available. See the links in the [See also](#see-also) section.
199204

200205
## Next steps
201206

202207
- [Deploy Defender for Endpoint on Linux](/defender-endpoint/linux-installer-script)
203208
- [Configure Defender for Endpoint on Linux](/defender-endpoint/linux-preferences)
204209
- [Deploy updates for Defender for Endpoint on Linux](/defender-endpoint/linux-updates)
205-
- [Run the client analyzer on Linux](run-analyzer-linux.md)
206210

207211
## See also
208212

0 commit comments

Comments
 (0)