HttpHeaderInjection

Настройка внедрения заголовка HTTP для определенных шаблонов URL-адресов

Поддерживаемые версии

  • Windows: ≥ 153
  • macOS: ≥ 153
  • Android: не поддерживается
  • iOS: не поддерживается

Описание

Эта политика позволяет определять правила, которые внедряют пользовательские заголовки HTTP в веб-запросы, соответствующие определенным шаблонам URL-адресов. Заголовки, внедренные этой политикой, имеют приоритет над заголовками, уже присутствующими в запросе, и над изменениями, внесенными пользователями или расширениями.

Распространенный вариант использования этой политики — принудительное управление доступом клиентов путем внедрения пользовательских заголовков (например, X-Tenant-ID).

Политика принимает список правил. Каждое правило содержит:

  • patterns: список шаблонов URL для соответствия. Дополнительные сведения о формате шаблона URL-адреса см. в статье https://go.microsoft.com/fwlink/?linkid=2095322.

  • headers: список объектов заголовка для внедрения. Каждый объект содержит:

  • name: имя заголовка, который нужно внедрить.

  • value: значение заголовка, который нужно внедрить.

Если запросу соответствуют несколько правил, применяются заголовки всех совпадающих правил. Если несколько правил соответствия указывают одно имя заголовка, применяется заголовок из наиболее определенного шаблона URL. Если несколько совпадающих шаблонов одинаково специфичны, применяется заголовок из правила, который отображается последним в списке.

Имена заголовков должны соответствовать RFC 2616 (https://www.rfc-editor.org/rfc/rfc2616). Значения заголовков не должны содержать нулевые символы, CR и LF. Размер отдельных заголовков не может превышать 8 КБ. Недопустимые заголовки и шаблоны URL-адресов игнорируются.

Эта политика поддерживает максимум 500 шаблонов URL во всех правилах. Каждое правило может содержать до 20 заголовков. Шаблоны URL-адресов и заголовки, превышающие эти ограничения, игнорируются.

Поддерживаемые функции

  • Может быть обязательным: Да
  • Может быть рекомендовано: Нет
  • Обновление динамической политики: Да
  • Для каждого профиля: Да
  • Применяется к профилю, в который выполнен вход с помощью учетной записи Майкрософт: Нет

Тип данных

  • Dictionary

Сведения и параметры Windows

Сведения о групповой политике (ADMX)

  • Уникальное имя GP: HttpHeaderInjection
  • Имя GP: Настройка внедрения заголовка HTTP для определенных шаблонов URL
  • Путь к групповой политике (обязательно): Административные шаблоны/Microsoft Edge/Параметры сети
  • Путь GP (рекомендуется): N/A
  • Имя файла 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
  • Путь (рекомендуется): N/A
  • Имя значения: 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