Kontrola hlavičky HTTP
Pomocí zásady vynucujte check-header
, že požadavek má zadanou hlavičku HTTP. Volitelně můžete zkontrolovat, jestli záhlaví obsahuje určitou hodnotu nebo oblast povolených hodnot. Pokud kontrola selže, zásada ukončí zpracování požadavků a vrátí stavový kód HTTP a chybovou zprávu určenou zásadou.
Poznámka
Nastavte prvky zásad a podřízené prvky v pořadí uvedeném v prohlášení o zásadách. Přečtěte si další informace o tom, jak nastavit nebo upravit zásady API Management.
Prohlášení o zásadách
<check-header name="header name" failed-check-httpcode="code" failed-check-error-message="message" ignore-case="true | false">
<value>Value1</value>
<value>Value2</value>
</check-header>
Atributy
Atribut | Popis | Povinné | Výchozí |
---|---|---|---|
name | Název hlavičky HTTP, která se má zkontrolovat. | Yes | – |
failed-check-httpcode | Stavový kód HTTP, který se má vrátit, pokud hlavička neexistuje nebo má neplatnou hodnotu. | Yes | – |
failed-check-error-message | Chybová zpráva, která se má vrátit v textu odpovědi HTTP, pokud hlavička neexistuje nebo má neplatnou hodnotu. Tato zpráva musí obsahovat všechny speciální znaky, které jsou správně u řídicích znaků. | Yes | – |
ignore-case | Boolean. Pokud je nastavená na true , velká a malá písmena se při porovnání hodnoty záhlaví se sadou přijatelných hodnot ignorují. |
Yes | – |
Elementy
Element | Popis | Povinné |
---|---|---|
hodnota | Přidejte jeden nebo více těchto prvků a určete povolené hodnoty hlaviček HTTP. Pokud je zadáno více value prvků, je kontrola považována za úspěšnou, pokud se některá z hodnot shoduje. |
No |
Využití
- Oddíly zásad: příchozí, odchozí
- Rozsahy zásad: globální, produkt, rozhraní API, operace
- Brány: vyhrazené, spotřeba, vlastní hostování
Příklad
<check-header name="Authorization" failed-check-httpcode="401" failed-check-error-message="Not authorized" ignore-case="false">
<value>f6dc69a089844cf6b2019bae6d36fac8</value>
</check-header>
Související zásady
Další kroky
Další informace o práci se zásadami najdete tady:
- Kurz: Transformace a ochrana rozhraní API
- Referenční informace o zásadách pro úplný seznam prohlášení o zásadách a jejich nastavení
- Výrazy zásad
- Nastavení nebo úprava zásad
- Opakované použití konfigurací zásad
- Ukázky zásad