Kontrola hlavičky HTTP
PLATÍ PRO: Všechny úrovně služby API Management
check-header
Pomocí zásad vynucujte, že požadavek má zadanou hlavičku HTTP. Volitelně můžete zkontrolovat, jestli záhlaví obsahuje konkrétní hodnotu nebo jednu z rozsahu povolených hodnot. Pokud se kontrola nezdaří, 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 služby 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 | Požaduje se | Výchozí |
---|---|---|---|
name | Název hlavičky HTTP, která se má zkontrolovat. Výrazy zásad jsou povolené. | Yes | – |
Chyba - check-httpcode | Stavový kód HTTP, který se má vrátit, pokud záhlaví neexistuje nebo má neplatnou hodnotu. Výrazy zásad jsou povolené. | Yes | – |
Neúspěšná kontrola chybové zprávy | Chybová zpráva pro vrácení v textu odpovědi HTTP, pokud záhlaví neexistuje nebo má neplatnou hodnotu. Tato zpráva musí obsahovat všechny speciální znaky, které jsou správně uchycené. Výrazy zásad jsou povolené. | Yes | – |
ignorovat velká a malá písmena | Logický. Pokud je nastavená hodnota true , velká a malá písmena se při porovnávání hodnoty záhlaví s sadou přijatelných hodnot. Výrazy zásad jsou povolené. |
Yes | – |
Elementy
Element (Prvek) | Popis | Povinní účastníci |
---|---|---|
hodnota | Přidejte jeden nebo více těchto prvků pro určení povolených hodnot hlaviček HTTP. Pokud je zadáno více value prvků, je kontrola považována za úspěch, pokud některá z hodnot odpovídá. |
No |
Využití
- Oddíly zásad: příchozí
- Obory zásad: globální, produkt, rozhraní API, operace
- Brány: Classic, v2, consumption, self-host, workspace
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
Související obsah
Další informace o práci se zásadami najdete v tématech:
- 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
- Úložiště fragmentů zásad
- Sada nástrojů zásad služby Azure API Management
- Vytváření zásad pomocí Microsoft Copilotu v Azure