基于 URL 列表的策略的筛选器格式

本文介绍用于基于 Microsoft Edge URL 列表的策略的筛选器格式,例如 URLBlocklistURLAllowListCertificateTransparencyEnforcementDisabledForUrls 策略。

筛选器格式

筛选器格式为:

    [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. 首先选择具有最长主机匹配项的筛选器。

  2. 在所选筛选器中,将丢弃具有不匹配的方案或端口的任何筛选器。

  3. 从其余筛选器中,选择具有最长匹配路径的筛选器。

  4. 在剩下的筛选器中,选择的是具有最长查询令牌集的筛选器。 在此步骤中,如果两个筛选器具有相同 的路径 长度和 查询 令牌数,则允许列表筛选器优先于阻止列表筛选器。

  5. 如果剩余筛选器无效,则从主机中删除最左侧的子域,并从第 1 步重新开始执行选择过程。 特殊星号(“*”)主机是最后搜索的,它匹配所有主机。

  6. 如果筛选器可用,它会阻止或允许 URL 请求。

    注意

    如果没有匹配的筛选器,则默认行为是允许 URL 请求。

筛选器选择条件示例

在此示例中,搜索匹配项时为 “https://sub.contoso.com/docs"筛选器选择将:

  1. 搜索 的 sub.contoso.com筛选器。 如果找到筛选器,搜索将转到第 2 步。 如果未找到筛选器,则它会使用 contoso.comcom、 和 “”再次尝试。
  2. 在所选筛选器中,任何在方案中没有“http”的项都会被删除。
  3. 在剩下的筛选器中,任何具有非“80”的确切端口号的筛选器都会被删除。
  4. 从其余筛选器中,删除路径前缀不是“/docs”的任何项。
  5. 从其余筛选器中,选择并应用路径前缀最长的筛选器。 如果未找到筛选器,则从第 1 步重新开始执行选择过程。 使用下一个子域重复此过程。

更多筛选器信息

如果筛选器包含点(“.”)主机前缀,则只筛选完全匹配的主机。 例如:

  • contoso.com (无点) 匹配 contoso.comwww.contoso.comsub.www.contoso.com
  • .www.contoso.com 带有点前缀的 () 仅匹配 www.contoso.com

你可以使用标准或自定义架构。 受支持的标准架构包括:

  • aboutblobcontentedgeciddatafilefilesystemftpgopherhttphttpsjavascriptmailtowswss

任何其他架构都被视为自定义架构,但只允许使用 schema:schema://* 模式。 例如:

  • “custom:*”或“custom://*”匹配“custom:app”
  • “custom:app”或“custom://app”无效

架构主机不区分大小写。 例如:

  • http://contoso.com 筛选器匹配 HTTP://contoso.comhttp://contoso.COM、 和 http://contoso.com

路径查询区分大小写。 例如:

  • http://contoso.com/path?query=A 筛选器不匹配 http://contoso.com/Path?query=Ahttp://contoso.com/path?Query=A。 它与 匹配 http://contoso.COM/path?query=A

内容许可证

注意

本页面的某些部分是根据 Chromium.org 创建和共享的作品所做的修改,并根据 Creative Commons Attribution 4.0 国际许可证中所述的条款进行使用。 可在此处找到原始 Chromium 页面

Creative Commons 许可证
本作品根据 Creative Commons Attribution 4.0 International License 获得许可。

另请参阅