为特定 URL 模式配置 HTTP 标头注入
支持的版本
- Windows:≥ 153
- macOS:≥ 153
- Android:≥ 159
- iOS:不支持
描述
通过此策略,可以定义将自定义 HTTP 标头注入匹配的特定 URL 模式的 Web 请求的规则。 此策略注入的标头优先于请求中已存在的标头,并优先于用户或扩展所做的修改。
如果配置此策略,则匹配请求将使用规则中指定的标头。 如果未配置此策略或配置空列表,则此策略不会注入任何自定义标头。
此策略的一个常见用例是通过注入自定义标头来强制执行租户访问控制 (例如 X-Tenant-ID) 。
策略接受规则列表。 每个规则包含:
模式:要匹配的 URL 模式列表。 有关 URL 模式格式的信息,请参阅 https://go.microsoft.com/fwlink/?linkid=2095322。
headers:要注入的标头对象列表。 每个对象包含:
name:要注入的标头的名称。
value:要注入的标头的值。
如果多个规则与请求匹配,则应用来自所有匹配规则的标头。 如果多个匹配规则指定相同的标头名称,则应用来自最具体 URL 模式的标头。 如果多个匹配模式同样具体,则应用列表中最后出现的规则中的标头。
标头名称必须符合 RFC 2616 (https://www.rfc-editor.org/rfc/rfc2616) 。 标头值不得包含 NUL、CR 或 LF 字符。 单个标头不能超过 8 KB。 无效的标头和 URL 模式将被忽略。
此策略跨所有规则支持最多 500 个 URL 模式。 每个规则最多可包含 20 个标头。 超过这些限制的 URL 模式和标头将被忽略。
注意:如果 URL 模式与未加密的方案 (http://、ws:// 匹配,或者该方案被省略) ,则配置的标头可能会通过未加密的通道以纯文本形式传输,并可能暴露给网络观察者。 若要保护敏感标头值或标识标头值,请将 URL 模式限制为加密方案 (https:// 或 wss://) 。
支持的功能
- 可以强制:是
- 可以推荐:否
- 动态策略刷新:是
- 每个配置文件:是
- 适用于使用 Microsoft 帐户登录的配置文件:否
数据类型
- Dictionary
Windows 信息和设置
组策略 (ADMX) 信息
- GP 唯一名称:HttpHeaderInjection
- GP 名称:为特定 URL 模式配置 HTTP 标头注入
- GP 路径 (强制) :管理模板/Microsoft Edge/网络设置
- GP 路径(推荐):不适用
- GP ADMX 文件名:MSEdge.admx
示例值
[{"headers": [{"name": "X-Tenant-ID", "value": "123456"}, {"name": "X-Custom-Header", "value": "CustomValue"}], "patterns": ["https://example.com", "https://.example.org"]}]
注册表设置
- 路径(强制):SOFTWARE\Policies\Microsoft\Edge
- 路径(推荐):不适用
- 值名称: HttpHeaderInjection
- 值类型:REG_SZ
注册表值示例
[{"headers": [{"name": "X-Tenant-ID", "value": "123456"}, {"name": "X-Custom-Header", "value": "CustomValue"}], "patterns": ["https://example.com", "https://.example.org"]}]
扩展的示例注册表值
[
{
"headers": [
{
"name": "X-Tenant-ID",
"value": "123456"
},
{
"name": "X-Custom-Header",
"value": "CustomValue"
}
],
"patterns": [
"https://example.com",
"https://.example.org"
]
}
]
Mac 信息和设置
- 首选项键名称: HttpHeaderInjection
- 示例值:
<key>HttpHeaderInjection</key>
<array>
<dict>
<key>headers</key>
<array>
<dict>
<key>name</key>
<string>X-Tenant-ID</string>
<key>value</key>
<string>123456</string>
</dict>
<dict>
<key>name</key>
<string>X-Custom-Header</string>
<key>value</key>
<string>CustomValue</string>
</dict>
</array>
<key>patterns</key>
<array>
<string>https://example.com</string>
<string>https://.example.org</string>
</array>
</dict>
</array>
Android 信息和设置
- 首选项键名称: HttpHeaderInjection
- 示例值:
[{"headers": [{"name": "X-Tenant-ID", "value": "123456"}, {"name": "X-Custom-Header", "value": "CustomValue"}], "patterns": ["https://example.com", "https://.example.org"]}]