Skip to content

Commit 6a0ca91

Browse files
authored
Improve indicator-ip-domain.md clarity and add updates
Explicitly specify that ECH and QUIC must be disabled.
1 parent 8a8f79c commit 6a0ca91

File tree

1 file changed

+27
-31
lines changed

1 file changed

+27
-31
lines changed

defender-endpoint/indicator-ip-domain.md

Lines changed: 27 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Create indicators for IPs and URLs/domains
3-
ms.reviewer: thdoucet
3+
ms.reviewer: ericlaw
44
description: Create indicators for IPs and URLs/domains that define the detection, prevention, and exclusion of entities.
55
ms.service: defender-endpoint
66
ms.author: deniseb
@@ -34,17 +34,14 @@ ms.date: 03/04/2025
3434

3535
By creating indicators for IPs and URLs or domains, you can now allow or block IPs, URLs, or domains based on your own threat intelligence. You can also warn users if they open a risky app. The prompt doesn't stop them from using the app; users can bypass the warning and continue to use the app if needed.
3636

37-
To block malicious IPs/URLs (as determined by Microsoft), Defender for Endpoint can use:
37+
To block malicious IPs/URLs, Defender for Endpoint can use:
3838

3939
- Windows Defender SmartScreen for Microsoft browsers
40-
- Network protection for non-Microsoft browsers, or calls made outside of a browser
40+
- Network protection for non-Microsoft browsers and non-browser processes
4141

42-
The threat-intelligence data set to block malicious IPs/URLs is managed by Microsoft.
42+
The default threat-intelligence data set to block malicious IPs/URLs is managed by Microsoft.
4343

44-
You can block malicious IPs/URLs through the settings page or by machine groups, if you deem certain groups to be more or less at risk than others.
45-
46-
> [!NOTE]
47-
> Classless Inter-Domain Routing (CIDR) notation for IP addresses is not supported.
44+
You can block additional malicious IPs/URLs by configuring "**Custom network indicators**".
4845

4946
### Supported operating systems
5047

@@ -65,14 +62,15 @@ You can block malicious IPs/URLs through the settings page or by machine groups,
6562
It's important to understand the following prerequisites before creating indicators for IPs, URLs, or domains.
6663

6764
### Microsoft Defender Antivirus version requirements
65+
Integration into Microsoft browsers is controlled by the browser's SmartScreen setting. For other browsers and applications, your organization must have:
6866

69-
- Your organization uses [Microsoft Defender Antivirus](/defender-endpoint/microsoft-defender-antivirus-windows). Microsoft Defender Antivirus must be in active mode for non-Microsoft browsers. With Microsoft browsers, like Microsoft Edge, Microsoft Defender Antivirus can be in active or passive mode.
67+
- [Microsoft Defender Antivirus](/defender-endpoint/microsoft-defender-antivirus-windows) configured in active mode.
7068

71-
- [Behavior Monitoring](/defender-endpoint/behavior-monitor) is enabled.
69+
- [Behavior Monitoring](/defender-endpoint/behavior-monitor) enabled.
7270

73-
- [Cloud-based protection](/windows/security/threat-protection/microsoft-defender-antivirus/deploy-manage-report-microsoft-defender-antivirus) is turned on.
71+
- [Cloud-based protection](/windows/security/threat-protection/microsoft-defender-antivirus/deploy-manage-report-microsoft-defender-antivirus) turned on.
7472

75-
- [Cloud Protection network connectivity](/defender-endpoint/configure-network-connections-microsoft-defender-antivirus) is turned on.
73+
- [Cloud Protection network connectivity](/defender-endpoint/configure-network-connections-microsoft-defender-antivirus).
7674

7775
- The anti-malware client version must be `4.18.1906.x` or later. See [Monthly platform and engine versions](/defender-endpoint/microsoft-defender-antivirus-updates).
7876

@@ -82,41 +80,39 @@ URL/IP allow and block requires that the Microsoft Defender for Endpoint compone
8280

8381
### Custom network indicators requirements
8482

85-
To start blocking IP addresses and/or URLs, turn on "**Custom network indicators"** feature in the [Microsoft Defender portal](https://security.microsoft.com), go to **Settings** > **Endpoints** > **General** > **Advanced features**. For more information, see [Advanced features](advanced-features.md).
83+
To start blocking IP addresses and/or URLs, turn on the "**Custom network indicators**" feature in the [Microsoft Defender portal](https://security.microsoft.com). The feature is found in **Settings** > **Endpoints** > **General** > **Advanced features**. For more information, see [Advanced features](advanced-features.md).
8684

8785
For support of indicators on iOS, see [Microsoft Defender for Endpoint on iOS](ios-configure-features.md#configure-custom-indicators).
8886

8987
For support of indicators on Android, see [Microsoft Defender for Endpoint on Android](android-configure.md#configure-custom-indicators).
9088

9189
### Indicator list limitations
9290

93-
Only external IPs can be added to the indicator list. Indicators can't be created for internal IPs. For web protection scenarios, we recommend using the built-in capabilities in Microsoft Edge. Microsoft Edge uses [Network Protection](network-protection.md) to inspect network traffic and allows blocks for TCP, HTTP, and HTTPS (TLS).
91+
Only external IPs can be added to the indicator list; indicators cannot be created for internal IPs.
9492

9593
### Non Microsoft Edge and Internet Explorer processes
9694

9795
For processes other than Microsoft Edge and Internet Explorer, web protection scenarios use Network Protection for inspection and enforcement:
9896

99-
- IP is supported for all three protocols (TCP, HTTP, and HTTPS (TLS))
97+
- IP addresses are supported for all three protocols (TCP, HTTP, and HTTPS (TLS))
10098
- Only single IP addresses are supported (no CIDR blocks or IP ranges) in custom indicators
101-
- Encrypted URLs (full path) can only be blocked on first party browsers (Internet Explorer or Microsoft Edge)
102-
- Encrypted URLs (FQDN only) can be blocked in non-Microsoft browsers (that is, other than Internet Explorer or Microsoft Edge)
103-
- URLs loaded via HTTP connection coalescing, such as content loaded by modern CDNs, can only be blocked on first party browsers (Internet Explorer, Microsoft Edge), unless the CDN URL itself is added to the indicator list.
104-
- Full URL path blocks can be applied for unencrypted URLs
99+
- HTTP URLs (including a full URL path) can be blocked for any browser or process
100+
- HTTPS fully-qualified domain names (FQDN) can be blocked in non-Microsoft browsers (indicators specifying a full URL path can only be blocked in Microsoft Edge)
101+
- Blocking FQDNs in non-Microsoft browsers requires that QUIC and Encrypted Client Hello be disabled in those browsers
102+
- FQDNs loaded via HTTP2 connection coalescing can only be blocked in Microsoft Edge
105103
- If there are conflicting URL indicator policies, the longer path is applied. For example, the URL indicator policy `https://support.microsoft.com/office` takes precedence over the URL indicator policy `https://support.microsoft.com`.
106-
- If URL indicator policy conflicts occur, the longer path might not be applied due to redirection. In such cases, register a non-redirected URL.
107104

108-
> [!NOTE]
109-
> Custom Indicators of Compromise and Web Content Filtering features are currently not supported in Application Guard sessions of Microsoft Edge. These containerized browser sessions can only enforce web threat blocks via the built-in SmartScreen protection. They can't enforce any enterprise web protection policies.
105+
## Network protection implementation
110106

111-
## Network protection and the TCP three-way handshake
107+
In non-Microsoft Edge processes, Network Protection determines the fully qualified domain name for each HTTPS connection by examining the content of the TLS handshake that occurs after a TCP/IP handshake. This requires that the HTTPS connection use TCP/IP (not UDP/QUIC) and that the ClientHello message not be encrypted. To disable QUIC and Encrypted Client Hello in Google Chrome, see [QuicAllowed](https://chromeenterprise.google/policies/#QuicAllowed) and [EncryptedClientHelloEnabled](https://chromeenterprise.google/policies/#EncryptedClientHelloEnabled). For Mozilla Firefox, see [Disable EncryptedClientHello](https://mozilla.github.io/policy-templates/#disableencryptedclienthello) and [network.http.http3.enable](https://support.mozilla.org/ml/questions/1408003#answer-1571474).
112108

113-
With network protection, the determination of whether to allow or block access to a site is made after the completion of the [three-way handshake via TCP/IP](/troubleshoot/windows-server/networking/three-way-handshake-via-tcpip). Thus, when a site is blocked by network protection, you might see an action type of `ConnectionSuccess` under `NetworkConnectionEvents` in the Microsoft Defender portal, even though the site was blocked. `NetworkConnectionEvents` are reported from the TCP layer, and not from network protection. After the three-way handshake has completed, access to the site is allowed or blocked by network protection.
109+
The determination of whether to allow or block access to a site is made after the completion of the [three-way handshake via TCP/IP](/troubleshoot/windows-server/networking/three-way-handshake-via-tcpip) and any TLS handshake. Thus, when a site is blocked by network protection, you might see an action type of `ConnectionSuccess` under `NetworkConnectionEvents` in the Microsoft Defender portal, even though the site was blocked. `NetworkConnectionEvents` are reported from the TCP layer, and not from network protection. After the three-way handshake has completed, access to the site is allowed or blocked by network protection.
114110

115111
Here's an example of how that works:
116112

117113
1. Suppose that a user attempts to access a website on their device. The site happens to be hosted on a dangerous domain, and it should be blocked by network protection.
118114

119-
2. The three-way handshake via TCP/IP commences. Before it completes, a `NetworkConnectionEvents` action is logged, and its `ActionType` is listed as `ConnectionSuccess`. However, as soon as the three-way handshake process completes, network protection blocks access to the site. All of this happens quickly. A similar process occurs with [Microsoft Defender SmartScreen](/windows/security/threat-protection/microsoft-defender-smartscreen/microsoft-defender-smartscreen-overview); it's when the three-way handshake completes that a determination is made, and access to a site is either blocked or allowed.
115+
2. The TCP/IP handshake commences. Before it completes, a `NetworkConnectionEvents` action is logged, and its `ActionType` is listed as `ConnectionSuccess`. However, as soon as the TCP/IP handshake process completes, network protection blocks access to the site. All of this happens quickly. A similar process occurs with [Microsoft Defender SmartScreen](/windows/security/threat-protection/microsoft-defender-smartscreen/microsoft-defender-smartscreen-overview); it's after the handshake completes that a determination is made, and access to a site is either blocked or allowed.
120116

121117
3. In the Microsoft Defender portal, an alert is listed in the [alerts queue](alerts-queue.md). Details of that alert include both `NetworkConnectionEvents` and `AlertEvents`. You can see that the site was blocked, even though you also have a `NetworkConnectionEvents` item with the ActionType of `ConnectionSuccess`.
122118

@@ -139,9 +135,9 @@ For more information, see [Govern apps discovered by Microsoft Defender for Endp
139135

140136
## Indicator IP URL and domain policy conflict handling order
141137

142-
Policy conflict handling for domains/URLs/IP addresses differ from policy conflict handling for certs.
138+
Policy conflict handling for domains/URLs/IP addresses differ from policy conflict handling for certificates.
143139

144-
In the case where multiple different action types are set on the same indicator (for example, **block**, **warn**, and **allow**, action types set for Microsoft.com), the order those action types would take effect is:
140+
In the case where multiple different action types are set on the same indicator (for example, three indicators for Microsoft.com with the action types **block**, **warn**, and **allow**), the order those action types would take effect is:
145141

146142
1. Allow
147143

@@ -153,11 +149,11 @@ In the case where multiple different action types are set on the same indicator
153149

154150
### Defender for Cloud Apps Indicators
155151

156-
If your organization has enabled integration between Defender for Endpoint and Defender for Cloud Apps, block indicators are created in Defender for Endpoint for all unsanctioned cloud applications. If an application is put in monitor mode, warn indicators (bypassable block) are created for the URLs associated with the application. Allow indicators can't be created for sanctioned applications at this time. Indicators created by Defender for Cloud Apps follow the same policy conflict handling described in the previous section.
152+
If your organization has enabled integration between Defender for Endpoint and Defender for Cloud Apps, block indicators are created in Defender for Endpoint for all unsanctioned cloud applications. If an application is put in monitor mode, warn indicators (bypassable block) are created for the URLs associated with the application. Allow indicators are not automatically created for sanctioned applications. Indicators created by Defender for Cloud Apps follow the same policy conflict handling described in the previous section.
157153

158154
## Policy precedence
159155

160-
Microsoft Defender for Endpoint policy has precedence over Microsoft Defender Antivirus policy. In situations when Defender for Endpoint is set to `Allow`, but Microsoft Defender Antivirus is set to `Block`, the policy defaults to `Allow`.
156+
Microsoft Defender for Endpoint policy has precedence over Microsoft Defender Antivirus policy. In situations when Defender for Endpoint is set to `Allow`, but Microsoft Defender Antivirus is set to `Block`, the result is `Allow`.
161157

162158
### Precedence for multiple active policies
163159

@@ -182,12 +178,12 @@ The result is that categories 1-4 are all blocked. This scenario is illustrated
182178

183179
- **Indicator**: Specify the entity details and define the expiration of the indicator.
184180
- **Action**: Specify the action to be taken and provide a description.
185-
- **Scope**: Define the scope of the machine group.
181+
- **Scope**: Specify the machine group(s) which should enforce the indicator.
186182

187183
5. Review the details in the **Summary** tab, then select **Save**.
188184

189185
> [!IMPORTANT]
190-
> It can take up to 48 hours after a policy is created for a URL or IP address to be blocked on a device.
186+
> It can take up to 48 hours after a policy is created for a URL or IP address to be blocked on a device. In most cases, blocks will take effect in under two hours.
191187
192188
## Related articles
193189

0 commit comments

Comments
 (0)