HttpHeaderInjection

特定の URL パターンに対する HTTP ヘッダー インジェクションの構成

サポートされているバージョン

  • Windows: ≥ 153
  • macOS: ≥ 153
  • Android: サポートされていません
  • iOS: サポートされていません

説明

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

このポリシーの一般的なユース ケースは、カスタム ヘッダー (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 パターンとヘッダーは無視されます。

サポートされている機能

  • 必須にすることができるか: はい
  • 推奨にすることができるか: いいえ
  • 動的なポリシーの更新: はい
  • プロファイルごと: はい
  • 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": ["example.com", ".example.org"]}]

レジストリの設定

  • パス (必須): SOFTWARE\Policies\Microsoft\Edge
  • パス (推奨): なし
  • 値の名前: HttpHeaderInjection
  • 値の型: REG_SZ

レジストリ値の例

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

拡張されたレジストリ値の例

[
  {
    "headers": [
      {
        "name": "X-Tenant-ID",
        "value": "123456"
      },
      {
        "name": "X-Custom-Header",
        "value": "CustomValue"
      }
    ],
    "patterns": [
      "example.com",
      ".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>example.com</string>
      <string>.example.org</string>
    </array>
  </dict>
</array>

関連項目

  • Last updated on