特定の URL パターンに対する HTTP ヘッダー挿入を構成する

このポリシーを使用すると、特定の URL パターンに一致する Web 要求にカスタム HTTP ヘッダーを挿入するルールを定義できます。このポリシーによって挿入されるヘッダーは、要求内に既に存在するヘッダーより、およびユーザーまたは拡張機能によって行なわれた変更内容より優先されます。

このポリシーの一般的なユース ケースは、カスタム ヘッダー (X-Tenant-ID など) を挿入してテナント アクセス制御を適用することです。

このポリシーは、ルールのリストを受け入れます。各ルールには次の内容が含まれます:

* patterns: 一致させる URL パターンのリスト。URL パターンの形式については、https://go.microsoft.com/fwlink/?linkid=2095322 を参照してください。

* headers: 挿入するヘッダー オブジェクトのリスト。各オブジェクトには次のものが含まれます。

* name: 挿入するヘッダーの名前。

* value: 挿入するヘッダーの値。

複数のルールが 1 つの要求に一致する場合は、一致するすべてのルールのヘッダーが適用されます。一致する複数のルールで同じヘッダー名が指定されている場合は、最も具体的な URL パターンのヘッダーが適用されます。一致する複数のパターンが同等に具体的である場合は、リストの最後に存在するルールのヘッダーが適用されます。

ヘッダーの名前は、RFC 2616 (https://www.rfc-editor.org/rfc/rfc2616) に準拠している必要があります。ヘッダー値には、NUL、CR、LF の各文字を含めることはできません。個々のヘッダーは 8 KB を超えることはできません。無効なヘッダーと URL パターンは無視されます。

このポリシーは、すべてのルールにわたって、最大 500 個の URL パターンをサポートします。各ルールには、最大 20 個のヘッダーを含めることができます。これらの制限を超える URL パターンとヘッダーは無視されます。

サンプル値:

[
{
"patterns": [
"example.com",
".example.org"
],
"headers": [
{
"name": "X-Tenant-ID",
"value": "123456"
},
{
"name": "X-Custom-Header",
"value": "CustomValue"
}
]
}
]