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/mde-plugin-wsl.md
+27-26Lines changed: 27 additions & 26 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -60,7 +60,7 @@ Components installed:
60
60
61
61
## Installation steps
62
62
63
-
If you Windows Subsystem for Linux isn't installed yet, follow these steps:
63
+
If your Windows Subsystem for Linux isn't installed yet, follow these steps:
64
64
65
65
1. Open Terminal or Command Prompt. (In Windows, go to **Start** > **Command Prompt**. Or, right-click the start button and then select **Terminal**.)
66
66
@@ -85,6 +85,7 @@ If you Windows Subsystem for Linux isn't installed yet, follow these steps:
85
85
86
86
> [!NOTE]
87
87
> If `WslService` is running, it stops during the installation process. You do not need to onboard the subsystem separately; instead, the plug-in automatically onboards to the tenant the Windows host is onboarded to.
88
+
88
89
## Installation validation checklist
89
90
90
91
1. After update or installation, wait for at least five minutes for the plug-in to fully initialize and write log output.
@@ -95,7 +96,7 @@ If you Windows Subsystem for Linux isn't installed yet, follow these steps:
95
96
96
97
4. Run the command `.\healthcheck.exe`.
97
98
98
-
5. Review the details of Defender and WSL and make sure they match or exceed the following:
99
+
5. Review the details of Defender and WSL and make sure they match or exceed the following requirements:
99
100
100
101
-**Defender Plug-in Version**: `0.23.1102.4`
101
102
-**WSL Version**: `2.0.7.0` or later
@@ -114,15 +115,15 @@ If you want to use the host [network and network proxy setting](https://support.
114
115
115
116
## Plug-in Proxy selection
116
117
117
-
If your host machine contains multiple proxy settings, the plug-in will select the proxy configurations with the following hierarchy
118
+
If your host machine contains multiple proxy settings, the plug-in selects the proxy configurations with the following hierarchy:
118
119
119
-
1. Defender for Endpoint static proxy setting (`TelemetryProxyServer`)
120
+
1. Defender for Endpoint static proxy setting (`TelemetryProxyServer`).
120
121
121
-
2. Winhttp proxy (configured through netsh command)
122
+
2.`Winhttp` proxy (configured through `netsh` command).
122
123
123
-
3. Network & Internet proxy settings
124
+
3. Network & Internet proxy settings.
124
125
125
-
**Example:** If your host machine has both Winhttp proxy as well as Network & Internet proxy, plug-in will select `Winhttp proxy` as the proxy configuration for plug-in.
126
+
Example: If your host machine has both *Winhttp proxy* and *Network & Internet proxy*, the plug-in selects `Winhttp proxy` as the proxy configuration.
126
127
127
128
> [!NOTE]
128
129
> The `DefenderProxyServer` registry key is no longer supported. Follow the above mentioned steps to configure proxy in plug-in.
@@ -135,23 +136,24 @@ The following procedure describes how to confirm that Defender in Endpoint in WS
135
136
136
137
2. Create a registry key with the following details:
137
138
138
-
-**Name:**`ConnectivityTest`
139
-
-**Type:**`REG_DWORD`
140
-
-**Value:**`Number of seconds plug-in must wait before running test. (Recommended: 60 seconds)`
3. Once the registry is set, restart wsl using the following steps:
144
145
145
-
1. Open Command Prompt and run `wsl --shutdown`.
146
+
1. Open Command Prompt and run the command, `wsl --shutdown`.
146
147
147
148
2. Run the command `wsl`.
148
149
149
150
4. Wait for 5 minutes and then run `healthcheck.exe` (located at `C:\Program Files\Microsoft Defender for Endpoint plug-in for WSL\tools` for the results of the connectivity test).
150
151
151
-
If successful, the connectivity test shows success.
152
+
If successful, you can see that the connectivity test was successful.
152
153
153
154
> [!NOTE]
154
155
> To set a proxy for use in WSL containers (the distributions running on the subsystem), see [Advanced settings configuration in WSL](/windows/wsl/wsl-config).
156
+
155
157
## Verifying functionality and SOC analyst experience
156
158
157
159
After installing the plug-in, the subsystem and all its running containers are onboarded to the [Microsoft Defender portal](https://security.microsoft.com).
@@ -186,6 +188,7 @@ To test the plug-in after installation, follow these steps:
186
188
187
189
> [!NOTE]
188
190
> It takes about 5 minutes for the events to appear on the Microsoft Defender portal
191
+
189
192
Treat the machine as if it were a regular Linux host in your environment to perform testing against. In particular, we would like to get your feedback on the ability to surface potentially malicious behavior using the new plug-in.
190
193
191
194
### Advanced hunting
@@ -245,9 +248,9 @@ DeviceProcessEvents
245
248
4. If you don't see any devices in the Microsoft Defender portal, or you don't see any events in the timeline, check these things:
246
249
247
250
- If you aren't seeing a machine object, make sure sufficient time has passed for onboarding to complete (typically up to 10 minutes).
248
-
251
+
249
252
- Make sure to use the right filters, and that you have the appropriate permissions assigned to view all device objects. (For example, is your account/group is restricted to a specific group?)
250
-
253
+
251
254
- Use the health check tool to provide an overview of overall plug-in health. Open Terminal, and run the `healthcheck.exe` tool from `C:\Program Files\Microsoft Defender for Endpoint plug-in for WSL\tools`.
252
255
253
256
:::image type="content" source="media/mdeplugin-wsl/wsl-health-check-support.png" alt-text="Screenshot showing status in PowerShell." lightbox="media/mdeplugin-wsl/wsl-health-check-support.png":::
@@ -268,28 +271,26 @@ DeviceProcessEvents
268
271
269
272
:::image type="content" source="media/mdeplugin-wsl/wsl-health-check-overview.png" alt-text="Screenshot showing status in PowerShell output." lightbox="media/mdeplugin-wsl/wsl-health-check-overview.png":::
270
273
271
-
6. Microsoft Defender Endpoint for WSL supports Linux distributions running on WSL 2. If they are associated with WSL 1, you may face issues. Therefore, it is advised to disable WSL 1. To do so with the Intune policy, perform the following steps :
274
+
6. Microsoft Defender Endpoint for WSL supports Linux distributions running on WSL 2. If they're associated with WSL 1, you might encounter issues. Therefore, it is advised to disable WSL 1. To do so with the Intune policy, perform the following steps :
272
275
273
276
1. Navigate to your Microsoft Intune admin center portal.
274
277
275
-
2. Go to Devices -> Configuration Profiles -> Create -> New Policy.
276
-
277
-
3. Select Windows 10 and later -> Settings catalog.
278
-
279
-
4. Create a name for the new profile and search for “Windows Subsystem for Linux” to see and add the full list of available settings.
278
+
2. Go to **Devices** > **Configuration Profiles** > **Create** > **New Policy**.
280
279
281
-
5. Set the Allow WSL1 setting to Disabled.
280
+
3. Select **Windows 10 and later** > **Settings catalog**.
282
281
283
-
This will ensure only WSL 2 distributions can be used.
282
+
4. Create a name for the new profile, and search for **Windows Subsystem for Linux** to see and add the full list of available settings.
283
+
284
+
5. Set the **Allow WSL1** setting to **Disabled**, to ensure that only WSL 2 distributions can be used.
284
285
285
286
Alternately, if you want to keep using WSL 1, or not use the Intune Policy, you can selectively associate your installed distributions to run on WSL 2, by running the command in PowerShell:
286
-
287
+
287
288
```powershell
288
289
wsl --set-version <YourDistroName> 2
289
290
```
290
291
291
292
To have WSL 2 as your default WSL version for new distributions to be installed in the system, run the following command in PowerShell:
0 commit comments