HttpHeaderInjection

Configurare l'iniezione di intestazione HTTP per modelli URL specifici

Versioni supportate

• Finestre: ≥ 153
• macOS: ≥ 153
• Android: non supportato
• iOS: non supportato

Descrizione

Questo criterio consente di definire regole che inseriscono intestazioni HTTP personalizzate nelle richieste Web corrispondenti a modelli URL specifici. Le intestazioni inserite da questo criterio hanno la precedenza sulle intestazioni già presenti nella richiesta e sulle modifiche apportate dagli utenti o dalle estensioni.

Un caso d'uso comune per questo criterio è l'applicazione dei controlli di accesso del tenant inserendo intestazioni personalizzate, ad esempio X-Tenant-ID.

Il criterio accetta un elenco di regole. Ogni Regola contiene:

• patterns: un elenco di modelli di URL da abbinare. Per informazioni sul formato del modello URL, vedere https://go.microsoft.com/fwlink/?linkid=2095322.

• headers: un elenco di oggetti intestazione da inserire. Ogni oggetto contiene:

• name: nome dell'intestazione da inserire.

• valore: il valore dell'intestazione da inserire.

Se più regole corrispondono a una richiesta, vengono applicate le intestazioni di tutte le regole corrispondenti. Se più regole di corrispondenza specificano lo stesso nome di intestazione, viene applicata l'intestazione del modello di URL più specifico. Se più modelli corrispondenti sono ugualmente specifici, viene applicata l'intestazione della regola visualizzata per ultima nell'elenco.

I nomi delle intestazioni devono essere conformi alla RFC 2616 (https://www.rfc-editor.org/rfc/rfc2616). I valori di intestazione non devono contenere caratteri NUL, CR o LF. Le singole intestazioni non possono superare gli 8 KB. Le intestazioni e i modelli URL non validi vengono ignorati.

Questo criterio supporta un massimo di 500 modelli URL in tutte le regole. Ogni regola può contenere fino a 20 intestazioni. I modelli di URL e le intestazioni che superano questi limiti vengono ignorati.

Funzionalità supportate

• Può essere obbligatorio: sì
• Può essere consigliato: no
• Aggiornamento dei criteri dinamici: sì
• Per profilo: Sì
• Si applica a un profilo che ha eseguito l'accesso con un account Microsoft: no

Tipo di dati

• Dictionary

Informazioni e impostazioni di Windows

Informazioni sui Criteri di gruppo (ADMX)

• Nome univoco Criteri di gruppo: HttpHeaderInjection
• Nome Criteri di gruppo: Configura l'iniezione di intestazione HTTP per modelli URL specifici
• Percorso Criteri di gruppo (obbligatorio): Modelli amministrativi/Microsoft Edge/Impostazioni di rete
• Percorso Criteri di gruppo (consigliato): N/D
• Nome file ADMX Criteri di gruppo: MSEdge.admx

Valore di esempio

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

Impostazioni del Registro di sistema

• Percorso (obbligatorio): SOFTWARE\Criteri\Microsoft\Edge
• Percorso (consigliato): N/D
• Nome valore: HttpHeaderInjection
• Tipo valore: REG_SZ

Valore del Registro di sistema di esempio

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

Valore del Registro di sistema di esempio espanso

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

Informazioni e impostazioni Mac

• Nome chiave di preferenza: HttpHeaderInjection
• Valore di esempio

<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>

Vedere anche

• Microsoft Edge - Criteri