HttpHeaderInjection

특정 URL 패턴에 대한 HTTP 헤더 삽입 구성

지원되는 버전

  • Windows: ≥ 153
  • macOS: ≥ 153
  • Android: 지원되지 않음
  • iOS: 지원되지 않음

설명

이 정책을 사용하면 특정 URL 패턴과 일치하는 웹 요청에 사용자 지정 HTTP 헤더를 삽입하는 규칙을 정의할 수 있습니다. 이 정책에서 삽입한 헤더는 요청에 이미 있는 헤더와 사용자 또는 확장이 수정한 내용보다 우선합니다.

이 정책의 일반적인 사용 사례는 사용자 지정 헤더(예: 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)을 준수해야 합니다. 헤더 값에는 NUL, CR 또는 LF 문자가 포함되어서는 안 됩니다. 개별 헤더는 8KB를 초과할 수 없습니다. 잘못된 헤더 및 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\정책\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