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/indicator-ip-domain.md
+27-31Lines changed: 27 additions & 31 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
2
title: Create indicators for IPs and URLs/domains
3
-
ms.reviewer: thdoucet
3
+
ms.reviewer: ericlaw
4
4
description: Create indicators for IPs and URLs/domains that define the detection, prevention, and exclusion of entities.
5
5
ms.service: defender-endpoint
6
6
ms.author: deniseb
@@ -34,17 +34,14 @@ ms.date: 03/04/2025
34
34
35
35
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.
36
36
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:
38
38
39
39
- 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
41
41
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.
43
43
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**".
48
45
49
46
### Supported operating systems
50
47
@@ -65,14 +62,15 @@ You can block malicious IPs/URLs through the settings page or by machine groups,
65
62
It's important to understand the following prerequisites before creating indicators for IPs, URLs, or domains.
66
63
67
64
### 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:
68
66
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.
-[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.
74
72
75
-
-[Cloud Protection network connectivity](/defender-endpoint/configure-network-connections-microsoft-defender-antivirus) is turned on.
- 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).
78
76
@@ -82,41 +80,39 @@ URL/IP allow and block requires that the Microsoft Defender for Endpoint compone
82
80
83
81
### Custom network indicators requirements
84
82
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).
86
84
87
85
For support of indicators on iOS, see [Microsoft Defender for Endpoint on iOS](ios-configure-features.md#configure-custom-indicators).
88
86
89
87
For support of indicators on Android, see [Microsoft Defender for Endpoint on Android](android-configure.md#configure-custom-indicators).
90
88
91
89
### Indicator list limitations
92
90
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.
94
92
95
93
### Non Microsoft Edge and Internet Explorer processes
96
94
97
95
For processes other than Microsoft Edge and Internet Explorer, web protection scenarios use Network Protection for inspection and enforcement:
98
96
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))
100
98
- 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
105
103
- 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.
107
104
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
110
106
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).
112
108
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.
114
110
115
111
Here's an example of how that works:
116
112
117
113
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.
118
114
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.
120
116
121
117
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`.
122
118
@@ -139,9 +135,9 @@ For more information, see [Govern apps discovered by Microsoft Defender for Endp
139
135
140
136
## Indicator IP URL and domain policy conflict handling order
141
137
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.
143
139
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:
145
141
146
142
1. Allow
147
143
@@ -153,11 +149,11 @@ In the case where multiple different action types are set on the same indicator
153
149
154
150
### Defender for Cloud Apps Indicators
155
151
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.
157
153
158
154
## Policy precedence
159
155
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`.
161
157
162
158
### Precedence for multiple active policies
163
159
@@ -182,12 +178,12 @@ The result is that categories 1-4 are all blocked. This scenario is illustrated
182
178
183
179
-**Indicator**: Specify the entity details and define the expiration of the indicator.
184
180
-**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.
186
182
187
183
5. Review the details in the **Summary** tab, then select **Save**.
188
184
189
185
> [!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.
0 commit comments