Sdílet prostřednictvím

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í
název Název hlavičky HTTP, která se má zkontrolovat. Výrazy zásad jsou povolené. Ano –
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é. Ano –
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é. Ano –
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é. Ano –

Elementy

Element (Prvek) Popis Požaduje se
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á. Ne

Využití

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

Další informace o práci se zásadami najdete v tématech: