HTTP-Header-Einfügung für bestimmte URL-Muster konfigurieren

Diese Richtlinie ermöglicht das Definieren von Regeln, mit denen benutzerdefinierte HTTP-Header in Webanfragen eingefügt werden, die bestimmten URL-Mustern entsprechen. Header, die von dieser Richtlinie eingefügt werden, haben Vorrang vor Headern, die bereits in der Anforderung vorhanden sind, und vor Änderungen, die von Benutzern oder Erweiterungen vorgenommen wurden.

Ein typischer Anwendungsfall für diese Richtlinie ist das Erzwingen von Mandantenzugriffskontrollen durch das Einfügen benutzerdefinierter Header (zum Beispiel X-Tenant-ID).

Die Richtlinie akzeptiert eine Liste von Regeln. Jede Regel enthält:

* patterns: Eine Liste von URL-Mustern, die abgeglichen werden sollen. Weitere Informationen zum URL-Musterformat finden Sie unter https://go.microsoft.com/fwlink/?linkid=2095322.

* headers: Eine Liste von Headerobjekten, die eingefügt werden sollen. Jedes Objekt enthält:

* name: Den Namen des einzufügenden Headers.

* value: Den Wert des einzufügenden Headers.

Wenn mehrere Regeln mit einer Anforderung übereinstimmen, werden Header aus allen übereinstimmenden Regeln angewendet. Wenn mehrere übereinstimmende Regeln denselben Headernamen angeben, wird der Header aus dem spezifischsten URL-Muster angewendet. Wenn mehrere übereinstimmende Muster gleich spezifisch sind, wird der Header aus der Regel angewendet, die in der Liste zuletzt steht.

Headernamen müssen RFC 2616 entsprechen (https://www.rfc-editor.org/rfc/rfc2616). Headerwerte dürfen keine NUL-, CR- oder LF-Zeichen enthalten. Einzelne Header dürfen 8 KB nicht überschreiten. Ungültige Header und URL-Muster werden ignoriert.

Diese Richtlinie unterstützt maximal 500 URL-Muster über alle Regeln hinweg. Jede Regel kann bis zu 20 Header enthalten. URL-Muster und Header, die diese Grenzwerte überschreiten, werden ignoriert.

Beispielwert:

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