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
+28-32Lines changed: 28 additions & 32 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
@@ -15,7 +15,7 @@ ms.collection:
15
15
ms.topic: conceptual
16
16
ms.subservice:
17
17
search.appverid: met150
18
-
ms.date: 03/04/2025
18
+
ms.date: 04/08/2025
19
19
---
20
20
21
21
# Create indicators for IPs and URLs/domains
@@ -31,17 +31,14 @@ ms.date: 03/04/2025
31
31
32
32
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.
33
33
34
-
To block malicious IPs/URLs (as determined by Microsoft), Defender for Endpoint can use:
34
+
To block malicious IPs/URLs, Defender for Endpoint can use:
35
35
36
36
- Windows Defender SmartScreen for Microsoft browsers
37
-
- Network protection for non-Microsoft browsers, or calls made outside of a browser
37
+
- Network protection for non-Microsoft browsers and non-browser processes
38
38
39
-
The threat-intelligence data set to block malicious IPs/URLs is managed by Microsoft.
39
+
The default threat-intelligence data set to block malicious IPs/URLs is managed by Microsoft.
40
40
41
-
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.
42
-
43
-
> [!NOTE]
44
-
> Classless Inter-Domain Routing (CIDR) notation for IP addresses is not supported.
41
+
You can block additional malicious IPs/URLs by configuring "**Custom network indicators**".
45
42
46
43
### Supported operating systems
47
44
@@ -62,14 +59,15 @@ You can block malicious IPs/URLs through the settings page or by machine groups,
62
59
It's important to understand the following prerequisites before creating indicators for IPs, URLs, or domains.
63
60
64
61
### Microsoft Defender Antivirus version requirements
62
+
Integration into Microsoft browsers is controlled by the browser's SmartScreen setting. For other browsers and applications, your organization must have:
65
63
66
-
-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.
64
+
-[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.
68
+
-[Cloud-based protection](/windows/security/threat-protection/microsoft-defender-antivirus/deploy-manage-report-microsoft-defender-antivirus) turned on.
71
69
72
-
-[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).
75
73
@@ -79,41 +77,39 @@ URL/IP allow and block requires that the Microsoft Defender for Endpoint compone
79
77
80
78
### Custom network indicators requirements
81
79
82
-
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).
80
+
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).
83
81
84
82
For support of indicators on iOS, see [Microsoft Defender for Endpoint on iOS](ios-configure-features.md#configure-custom-indicators).
85
83
86
84
For support of indicators on Android, see [Microsoft Defender for Endpoint on Android](android-configure.md#configure-custom-indicators).
87
85
88
86
### Indicator list limitations
89
87
90
-
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).
88
+
Only external IPs can be added to the indicator list; indicators cannot be created for internal IPs.
91
89
92
90
### Non Microsoft Edge and Internet Explorer processes
93
91
94
92
For processes other than Microsoft Edge and Internet Explorer, web protection scenarios use Network Protection for inspection and enforcement:
95
93
96
-
- IP is supported for all three protocols (TCP, HTTP, and HTTPS (TLS))
94
+
- IP addresses are supported for all three protocols (TCP, HTTP, and HTTPS (TLS))
97
95
- Only single IP addresses are supported (no CIDR blocks or IP ranges) in custom indicators
98
-
-Encrypted URLs (full path) can only be blocked on first party browsers (Internet Explorer or Microsoft Edge)
99
-
-Encrypted URLs (FQDN only) can be blocked in non-Microsoft browsers (that is, other than Internet Explorer or Microsoft Edge)
100
-
-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.
101
-
-Full URL path blocks can be applied for unencrypted URLs
96
+
-HTTP URLs (including a full URL path) can be blocked for any browser or process
97
+
-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)
98
+
-Blocking FQDNs in non-Microsoft browsers requires that QUIC and Encrypted Client Hello be disabled in those browsers
99
+
-FQDNs loaded via HTTP2 connection coalescing can only be blocked in Microsoft Edge
102
100
- 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`.
103
-
- If URL indicator policy conflicts occur, the longer path might not be applied due to redirection. In such cases, register a non-redirected URL.
104
101
105
-
> [!NOTE]
106
-
> 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.
102
+
## Network protection implementation
107
103
108
-
## Network protection and the TCP three-way handshake
104
+
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).
109
105
110
-
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.
106
+
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.
111
107
112
108
Here's an example of how that works:
113
109
114
110
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.
115
111
116
-
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.
112
+
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.
117
113
118
114
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`.
119
115
@@ -136,9 +132,9 @@ For more information, see [Govern apps discovered by Microsoft Defender for Endp
136
132
137
133
## Indicator IP URL and domain policy conflict handling order
138
134
139
-
Policy conflict handling for domains/URLs/IP addresses differ from policy conflict handling for certs.
135
+
Policy conflict handling for domains/URLs/IP addresses differ from policy conflict handling for certificates.
140
136
141
-
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:
137
+
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:
142
138
143
139
1. Allow
144
140
@@ -150,11 +146,11 @@ In the case where multiple different action types are set on the same indicator
150
146
151
147
### Defender for Cloud Apps Indicators
152
148
153
-
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.
149
+
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.
154
150
155
151
## Policy precedence
156
152
157
-
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`.
153
+
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`.
158
154
159
155
### Precedence for multiple active policies
160
156
@@ -179,12 +175,12 @@ The result is that categories 1-4 are all blocked. This scenario is illustrated
179
175
180
176
-**Indicator**: Specify the entity details and define the expiration of the indicator.
181
177
-**Action**: Specify the action to be taken and provide a description.
182
-
-**Scope**: Define the scope of the machine group.
178
+
-**Scope**: Specify the machine group(s) which should enforce the indicator.
183
179
184
180
5. Review the details in the **Summary** tab, then select **Save**.
185
181
186
182
> [!IMPORTANT]
187
-
> It can take up to 48 hours after a policy is created for a URL or IP address to be blocked on a device.
183
+
> 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