基于 URL 列表的策略的筛选器格式
本文介绍用于基于 Microsoft Edge URL 列表的策略的筛选器格式,例如 URLBlocklist、 URLAllowList 和 CertificateTransparencyEnforcementDisabledForUrls 策略。
筛选器格式
筛选器格式为:
[scheme://][.]host[:port][/path][@query]
筛选器格式中的字段为:
字段 | 说明 |
---|---|
方案(可选) | 它可以是 http://、https://、ftp://、edge:// 等。 |
主机(必需) | 它必须是有效的主机名,并且可以使用通配符 (“*”) 。 若要禁用子域匹配,请在 主机前添加可选的点 (.) 。 可以指定单个 IP 地址文本主机名,但 IP 地址文本主机名不支持通配符。 |
端口(可选) | 有效值范围为 1 到 65535。 |
路径(可选) | 你可以在路径中使用任何字符串。 |
查询(可选) | 查询是用 & 号分隔的键值或纯键令牌。 使用等号(“=”)分隔键值令牌。 若要指示前缀匹配,可以在 查询末尾使用星号 (“*”) 。 |
将筛选器格式与 URL 格式进行比较
筛选器格式类似于 URL 格式,但有以下几点不同:
- 如果格式中包含“user:pass”,则会忽略它。 例如,http://user:pass@ftp.contoso.com/pub/example.iso.
- 如果你添加片段标识符(“#”),此标识符及其后面跟的所有内容都会被忽略。
- 可以使用通配符 (“*”) 作为 主机 ,并在其前面加上点 (.) 。
- 可以使用正斜杠 (“/”) 或点 (.) 作为 主机的后缀。 在这种情况下,后缀会被忽略。
筛选器选择条件
为 URL 选择的筛选器是处理以下筛选器选择规则后找到的最具体的匹配项:
首先选择具有最长主机匹配项的筛选器。
在所选筛选器中,将丢弃具有不匹配的方案或端口的任何筛选器。
从其余筛选器中,选择具有最长匹配路径的筛选器。
在剩下的筛选器中,选择的是具有最长查询令牌集的筛选器。 在此步骤中,如果两个筛选器具有相同 的路径 长度和 查询 令牌数,则允许列表筛选器优先于阻止列表筛选器。
如果剩余筛选器无效,则从主机中删除最左侧的子域,并从第 1 步重新开始执行选择过程。 特殊星号(“*”)主机是最后搜索的,它匹配所有主机。
如果筛选器可用,它会阻止或允许 URL 请求。
注意
如果没有匹配的筛选器,则默认行为是允许 URL 请求。
筛选器选择条件示例
在此示例中,搜索匹配项时为 “https://sub.contoso.com/docs"筛选器选择将:
- 搜索 的
sub.contoso.com
筛选器。 如果找到筛选器,搜索将转到第 2 步。 如果未找到筛选器,则它会使用contoso.com
、com
、 和 “”再次尝试。 - 在所选筛选器中,任何在方案中没有“http”的项都会被删除。
- 在剩下的筛选器中,任何具有非“80”的确切端口号的筛选器都会被删除。
- 从其余筛选器中,删除路径前缀不是“/docs”的任何项。
- 从其余筛选器中,选择并应用路径前缀最长的筛选器。 如果未找到筛选器,则从第 1 步重新开始执行选择过程。 使用下一个子域重复此过程。
更多筛选器信息
如果筛选器包含点(“.”)主机前缀,则只筛选完全匹配的主机。 例如:
contoso.com
(无点) 匹配contoso.com
、www.contoso.com
和sub.www.contoso.com
.www.contoso.com
带有点前缀的 () 仅匹配www.contoso.com
你可以使用标准或自定义架构。 受支持的标准架构包括:
- about、blob、content、edge、cid、data、file、filesystem、ftp、gopher、http、https、javascript、mailto、ws 和 wss。
任何其他架构都被视为自定义架构,但只允许使用 schema: 和 schema://* 模式。 例如:
- “custom:*”或“custom://*”匹配“custom:app”
- “custom:app”或“custom://app”无效
架构和主机不区分大小写。 例如:
http://contoso.com
筛选器匹配HTTP://contoso.com
、http://contoso.COM
、 和http://contoso.com
路径和查询区分大小写。 例如:
http://contoso.com/path?query=A
筛选器不匹配http://contoso.com/Path?query=A
或http://contoso.com/path?Query=A
。 它与 匹配http://contoso.COM/path?query=A
。
内容许可证
注意
本页面的某些部分是根据 Chromium.org 创建和共享的作品所做的修改,并根据 Creative Commons Attribution 4.0 国际许可证中所述的条款进行使用。 可在此处找到原始 Chromium 页面。
本作品根据 Creative Commons Attribution 4.0 International License 获得许可。