Skip to content

Commit 42c287f

Browse files
authored
Merge pull request #1209 from itsmukta/docs-editor/android-configure-1724492878
Update android-configure.md
2 parents 40a98a3 + 5ebf60a commit 42c287f

File tree

1 file changed

+48
-46
lines changed

1 file changed

+48
-46
lines changed

defender-endpoint/android-configure.md

Lines changed: 48 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ ms.collection:
1515
ms.topic: conceptual
1616
ms.subservice: android
1717
search.appverid: met150
18-
ms.date: 04/30/2024
18+
ms.date: 08/26/2024
1919
---
2020

2121
# Configure Defender for Endpoint on Android features
@@ -59,62 +59,54 @@ It includes several admin controls to offer flexibility, such as the ability to
5959

6060
Network protection in Microsoft Defender for endpoint is disabled by default. Admins can use the following steps to **configure Network protection in Android devices.**
6161

62-
1. In the Microsoft Intune admin center, navigate to Apps > App configuration policies. Create a new App configuration policy.
62+
In the Microsoft Intune admin center, navigate to Apps > App configuration policies. Create a new App configuration policy.
6363

64-
> [!div class="mx-imgBorder"]
6564
1. Provide a name and description to uniquely identify the policy. Select **'Android Enterprise'** as the platform and **'Personally-owned work profile only'** as the profile type and **'Microsoft Defender'** as the Targeted app.
6665

67-
> [!div class="mx-imgBorder"]
68-
> ![Screenshot of policy details.](media/appconfigdetails.png)
69-
70-
1. In Settings page, select **'Use configuration designer'** and add **'Enable Network Protection in Microsoft Defender'** as the key and value as **'1'** to enable Network Protection. (Network protection is disabled by default)
66+
2. In Settings page, select **'Use configuration designer'** and add **'Enable Network Protection in Microsoft Defender'** as the key and value as **'0'** to disable Network Protection. (Network protection is enabled by default)
7167

72-
> [!div class="mx-imgBorder"]
73-
> ![Screenshot of how to select enable network protection policy](media/selectnp.png)
74-
75-
> [!div class="mx-imgBorder"]
76-
> ![Screenshot of add configuration policy.](media/npvalue.png)
77-
78-
1. If your organization uses root CAs that are private, you must establish explicit trust between Intune (MDM solution) and user devices. Establishing trust helps prevent Defender from flagging root CAs as rogue certificates.
68+
3. If your organization uses root CAs that are private, you must establish explicit trust between Intune (MDM solution) and user devices. Establishing trust helps prevent Defender from flagging root CAs as rogue certificates.
7969

8070
To establish trust for the root CAs, use **'Trusted CA certificate list for Network Protection'** as the key. In the value, add the **'comma separated list of certificate thumbprints (SHA 1)'**.
8171

8272
**Example of Thumbprint format to add**: `50 30 06 09 1d 97 d4 f5 ae 39 f7 cb e7 92 7d 7d 65 2d 34 31, 503006091d97d4f5ae39f7cbe7927d7d652d3431`
8373

8474
> [!IMPORTANT]
85-
> Certificate SHA-1 Thumbprint characters should be with either white space separated, or non separated.
86-
>
87-
> This format is invalid: `50:30:06:09:1d:97:d4:f5:ae:39:f7:cb:e7:92:7d:7d:65:2d:34:31`
75+
> Certificate SHA-1 Thumbprint characters should be with either white space separated, or non separated.
76+
>
77+
> This format is invalid: `50:30:06:09:1d:97:d4:f5:ae:39:f7:cb:e7:92:7d:7d:65:2d:34:31`
8878
8979
Any other separation characters are invalid.
9080

91-
1. For other configurations related to Network protection, add the following keys and appropriate corresponding value.
92-
93-
| Configuration Key| Description|
94-
|---|---|
95-
|Trusted CA certificate list for Network Protection|Security admins manage this setting to establish trust for root CA and self-signed certificates.|
96-
|Enable Network protection in Microsoft Defender|1 - Enable, 0- Disable (default). This setting is used by the IT admin to enable or disable the network protection capabilities in the Defender app.|
97-
|Enable Network Protection Privacy|1 - Enable (default), 0 - Disable. Security admins manage this setting to enable or disable privacy in network protection.|
98-
|Enable Users to Trust Networks and Certificates|1 - Enable, 0 - Disable (default). Security admins manage this setting to enable or disable the end user's in-app experience to trust and untrust unsecure and suspicious networks and malicious certificates.|
99-
|Automatic Remediation of Network Protection Alerts|1 - Enable (default), 0 - Disable. Security admins manage this setting to enable or disable the remediation alerts that are sent when a user performs remediation activities, such as switching to a safer Wi-Fi access point or deleting suspicious certificates detected by Defender.|
100-
|Manage Network Protection detection for Open Networks|0 - Disable (default), 1 - Audit Mode, 2 - Enable. Security admins manage this setting to disable, audit, or enable open network detection, respectively. In 'Audit' mode, alerts are sent only to the ATP portal with no end user experience. For user experience, set the config to 'Enable' mode.|
101-
|Manage Network protection Detection for Certificates|0 - Disable, 1 - Audit mode (default), 2 - Enable. When network protection is enabled, Audit mode for certificate detection is enabled by default. In Audit mode, notification alerts are sent to SOC admins, but no end-user notifications are displayed to the user when Defender detects a bad certificate. Admins can, however, disable this detection with 0 as the value and enable full feature functionality by setting 2 as the value. When the feature is enabled with the value of 2, end-user notifications are sent to the user when Defender detects a bad certificate, and alerts are also sent to the SOC Admin.|
102-
103-
6. Add the required groups to which the policy will have to be applied. Review and create the policy.
104-
105-
| Configuration Key| Description|
106-
|---|---|
107-
|Enable Network protection in Microsoft Defender|1: Enable <br/> 0: Disable (default) <br/><br/> This setting is used by the IT admin to enable or disable the network protection capabilities in the Defender app.|
108-
|Enable Network Protection Privacy|1: Enable (default) <br/> 0: Disable <br/><br/> Security admins manage this setting to enable or disable privacy in network protection.|
109-
|Enable Users to Trust Networks and Certificates|1 <br/> Enable <br/> 0:Disable (default) <br/><br/> This setting is used by IT admins to enable or disable the end user in-app experience to trust and untrust the unsecure and suspicious networks and malicious certificates.|
110-
|Automatic Remediation of Network Protection Alerts|1: Enable (default) <br/> 0: Disable <br/><br/> This setting is used by IT admins to enable or disable the remediation alerts that are sent when a user does remediation activities. For example, the user switches to a safer Wi-Fi access point or deletes suspicious certificates that were detected by Defender.|
111-
|Manage Network Protection detection for Open Networks|0: Disable (default) <br/> 1: Audit Mode <br/><br/> Security admins manage this setting to enable or disable open network detection.|
112-
|Manage Network protection Detection for Certificates|0: Disable <br/> 1: Audit mode (default) <br/> 2: Enable <br/><br/> When network protection is enabled, Audit mode for certificate detection is enabled by default. In audit mode, notification alerts are sent to SOC admins, but no end user notifications are shown when Defender detects a bad certificate. Admins can disable this detection with the value 0 or enable full feature functionality by setting the value 2. When the value is 2, end user notifications are sent to users and alerts are sent to SOC admins when Defender detects a bad certificate.|
113-
114-
1. Add the required groups to which the policy has to be applied. Review and create the policy.
81+
4. For other configurations related to Network protection, add the following keys and appropriate corresponding value.
82+
83+
| Configuration Key| Description|
84+
|---|---|
85+
|Trusted CA certificate list for Network Protection|Security admins manage this setting to establish trust for root CA and self-signed certificates.|
86+
|Enable Network protection in Microsoft Defender|1 - Enable (default), 0- Disable. This setting is used by the IT admin to enable or disable the network protection capabilities in the Defender app.|
87+
|Enable Network Protection Privacy|1 - Enable (default), 0 - Disable. Security admins manage this setting to enable or disable privacy in network protection.|
88+
|Enable Users to Trust Networks and Certificates|1 - Enable, 0 - Disable (default). Security admins manage this setting to enable or disable the end user's in-app experience to trust and untrust unsecure and suspicious networks and malicious certificates.|
89+
|Automatic Remediation of Network Protection Alerts|1 - Enable (default), 0 - Disable. Security admins manage this setting to enable or disable the remediation alerts that are sent when a user performs remediation activities, such as switching to a safer Wi-Fi access point or deleting suspicious certificates detected by Defender.|
90+
|Manage Network Protection detection for Open Networks|2- Enable (default), 1- Audit mode, 0 - Disable. Security admins manage this setting to enable, audit, or disable open network detection, respectively. In 'Audit' mode, alerts are sent only to the ATP portal with no end user experience. For end user experience, the config should be set to 'Enable' mode.|
91+
|Manage Network protection Detection for Certificates|2- Enable, 1- Audit mode, 0 - Disable (default). In Audit mode, notification alerts are sent to SOC admins, but no end-user notifications are displayed to the user when Defender detects a bad certificate. Admins can, however, enable full feature functionality by setting 2 as the value. When the feature is enabled with the value of 2, end-user notifications are sent to the user when Defender detects a bad certificate, and alerts are also sent to the SOC Admin. |
92+
93+
5. Add the required groups to which the policy will have to be applied. Review and create the policy.
94+
95+
| Configuration Key| Description|
96+
|---|---|
97+
|Enable Network protection in Microsoft Defender|1: Enable (default)<br/> 0: Disable<br/><br/> This setting is used by the IT admin to enable or disable the network protection capabilities in the Defender app.|
98+
|Enable Network Protection Privacy|1: Enable (default) <br/> 0: Disable <br/><br/> Security admins manage this setting to enable or disable privacy in network protection.|
99+
|Enable Users to Trust Networks and Certificates|1: Enable <br/>0: Disable (default) <br/><br/> This setting is used by IT admins to enable or disable the end user in-app experience to trust and untrust the unsecure and suspicious networks and malicious certificates.|
100+
|Automatic Remediation of Network Protection Alerts|1: Enable (default) <br/> 0: Disable <br/><br/> This setting is used by IT admins to enable or disable the remediation alerts that are sent when a user does remediation activities. For example, the user switches to a safer Wi-Fi access point or deletes suspicious certificates that were detected by Defender.|
101+
|Manage Network Protection detection for Open Networks| 2: Enable (default)<br/> 1: Audit Mode <br/> 0: Disable <br/> Security admins manage this setting to enable or disable open network detection.|
102+
|Manage Network protection Detection for Certificates|2: Enable <br/> 1: Audit mode<br/> 0: Disable (default)<br/><br/>In audit mode, notification alerts are sent to SOC admins, but no end user notifications are shown when Defender detects a bad certificate. Admins can enable full feature functionality by setting the value 2. When the value is 2, end user notifications are sent to users and alerts are sent to SOC admins when Defender detects a bad certificate.|
103+
104+
6. Add the required groups to which the policy has to be applied. Review and create the policy.
115105

116106
> [!NOTE]
117-
> Users need to enable location permission (which is an optional permission); this enables Defender for Endpoint to scan their networks and alert them when there are WIFI-related threats. If the location permission is denied by the user, Defender for Endpoint will only be able to provide limited protection against network threats and will only protect the users from rogue certificates.
107+
> - The other config keys of Network Protection will only work if the parent key '**Enable Network Protection in Microsoft Defender'** is enabled.
108+
> - Users need to enable location permission (which is an optional permission) and need to grant “Allow All the Time” permission to ensure protection against Wi-Fi threat, even when the app is not actively in use. If the location permission is denied by the user, Defender for Endpoint will only be able to provide limited protection against network threats and will only protect the users from rogue certificates.
109+
118110
## Privacy Controls
119111

120112
Following privacy controls are available for configuring the data that is sent by Defender for Endpoint from Android devices:
@@ -124,7 +116,7 @@ Following privacy controls are available for configuring the data that is sent b
124116
|Malware report |Admins can set up privacy control for malware report. If privacy is enabled, then Defender for Endpoint won't send the malware app name and other app details as part of the malware alert report. |
125117
|Phish report |Admins can set up privacy control for phishing reports. If privacy is enabled, then Defender for Endpoint won't send the domain name and details of the unsafe website as part of the phishing alert report. |
126118
|Vulnerability assessment of apps |By default only information about apps installed in the work profile is sent for vulnerability assessment. Admins can disable privacy to include personal apps|
127-
|Network Protection (preview)| Admins can enable or disable privacy in network protection. If enabled, then Defender won't send network details.|
119+
|Network Protection | Admins can enable or disable privacy in network protection. If enabled, then Defender won't send network details.|
128120

129121
### Configure privacy alert report
130122

@@ -140,7 +132,7 @@ Admin Privacy Controls (MDM) Use the following steps to enable privacy.
140132

141133
4. On the Settings page, select **Use configuration designer** and then select **Add**.
142134

143-
5. Select the required privacy setting -
135+
5. Select the required privacy setting
144136
- Hide URLs in report
145137
- Hide URLs in report for personal profile
146138
- Hide app details in report
@@ -206,8 +198,10 @@ Defender for Endpoint supports vulnerability assessment of apps in the work prof
206198
2. Give the policy a name; **Platform \> Android Enterprise**; select the profile type.
207199
3. Select **Microsoft Defender for Endpoint** as the target app.
208200
4. In Settings page, select **Use configuration designer** and add **DefenderTVMPrivacyMode** as the key and value type as **Integer**
201+
209202
- To disable vulnerability of apps in the work profile, enter value as `1` and assign this policy to users. By default, this value is set to `0`.
210203
- For users with key set as `0`, Defender for Endpoint sends the list of apps from the work profile to the backend service for vulnerability assessment.
204+
211205
5. Select **Next** and assign this profile to targeted devices/users.
212206

213207
Turning the above privacy controls on or off won't impact the device compliance check or conditional access.
@@ -246,7 +240,9 @@ Use the following steps to turn on privacy for targeted users in the work profil
246240
2. Give the policy a name, **Platform > Android Enterprise**, select the profile type.
247241
3. Select **Microsoft Defender for Endpoint** as the target app.
248242
4. In Settings page, select **Use configuration designer** and add **DefenderExcludeURLInReport** as the key and value type as **Integer**.
249-
- Enter **1 to enable privacy**. The default value is 0.
243+
244+
Enter **1 to enable privacy**. The default value is 0.
245+
250246
5. Select **Next** and assign this profile to targeted devices/users.
251247

252248
Turning the above privacy controls on or off won't impact the device compliance check or conditional access.
@@ -285,7 +281,9 @@ Use the following steps to turn on privacy for targeted users in the work profil
285281
2. Give the policy a name, **Platform > Android Enterprise**, select the profile type.
286282
3. Select **Microsoft Defender for Endpoint** as the target app.
287283
4. In Settings page, select **Use configuration designer** and add **DefenderExcludeAppInReport** as the key and value type as **Integer**
288-
- Enter **1 to enable privacy**. The default value is 0.
284+
285+
Enter **1 to enable privacy**. The default value is 0.
286+
289287
5. Select **Next** and assign this profile to targeted devices/users.
290288

291289
Using this privacy control won't impact the device compliance check or conditional access. For example, devices with a malicious app will always have a risk level of "Medium".
@@ -299,8 +297,10 @@ Use the following steps to configure Disable sign-out:
299297
2. Give the policy a name, select **Platform > Android Enterprise**, and select the profile type.
300298
3. Select **Microsoft Defender for Endpoint** as the target app.
301299
4. In the Settings page, select **Use configuration designer** and add **Disable Sign Out** as the key and **Integer** as the value type.
300+
302301
- By default, Disable Sign Out = 1 for Android Enterprise personally owned work profiles, fully managed, company owned personally enabled profiles and 0 for device administrator mode.
303302
- Admins need to make Disable Sign Out = 0 to enable the sign-out button in the app. Users will be able to see the sign-out button once the policy is pushed.
303+
304304
5. Select **Next** and assign this profile to targeted devices and users.
305305

306306
> [!IMPORTANT]
@@ -316,6 +316,7 @@ Use the following steps to configure the Device tags:
316316
2. Give the policy a name, select **Platform > Android Enterprise**, and select the profile type.
317317
3. Select **Microsoft Defender for Endpoint** as the target app.
318318
4. In Settings page, select Use configuration designer and add **DefenderDeviceTag** as the key and value type as **String**.
319+
319320
- Admin can assign a new tag by adding the key **DefenderDeviceTag** and setting a value for device tag.
320321
- Admin can edit an existing tag by modifying the value of the key **DefenderDeviceTag**.
321322
- Admin can delete an existing tag by removing the key **DefenderDeviceTag**.
@@ -325,6 +326,7 @@ Use the following steps to configure the Device tags:
325326

326327
> [!NOTE]
327328
> The Defender app needs to be opened for tags to be synced with Intune and passed to Security Portal. It may take up to 18 hours for tags to reflect in the portal.
329+
328330
## Related articles
329331

330332
- [Overview of Microsoft Defender for Endpoint on Android](microsoft-defender-endpoint-android.md)

0 commit comments

Comments
 (0)