Kontrollera HTTP-huvud
GÄLLER FÖR: Alla API Management-nivåer
Använd principen check-header för att framtvinga att en begäran har ett angivet HTTP-huvud. Du kan också kontrollera om rubriken har ett visst värde eller ett av ett intervall med tillåtna värden. Om kontrollen misslyckas avslutar principen bearbetningen av begäran och returnerar HTTP-statuskoden och felmeddelandet som anges av principen.
Kommentar
Ange principens element och underordnade element i den ordning som anges i principbeskrivningen. Läs mer om hur du anger eller redigerar API Management-principer.
Principuttryck
<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>
Attribut
| Attribut | beskrivning | Obligatoriskt | Standardvärde |
|---|---|---|---|
| name | Namnet på HTTP-huvudet som ska kontrolleras. Principuttryck tillåts. | Ja | Ej tillämpligt |
| failed-check-httpcode | HTTP-statuskod som ska returneras om rubriken inte finns eller har ett ogiltigt värde. Principuttryck tillåts. | Ja | Ej tillämpligt |
| failed-check-error-message | Felmeddelande om att returnera i HTTP-svarstexten om rubriken inte finns eller har ett ogiltigt värde. Det här meddelandet måste ha undantagna specialtecken. Principuttryck tillåts. | Ja | Ej tillämpligt |
| ignore-case | Boolesk. Om värdet är inställt på trueignoreras skiftläget när huvudvärdet jämförs med uppsättningen med acceptabla värden. Principuttryck tillåts. |
Ja | Ej tillämpligt |
Element
| Element | Description | Obligatoriskt |
|---|---|---|
| värde | Lägg till ett eller flera av dessa element för att ange tillåtna HTTP-huvudvärden. När flera value element anges betraktas kontrollen som en lyckad kontroll om något av värdena är en matchning. |
Nej |
Förbrukning
- Principavsnitt: inkommande
- Principomfattningar: global, produkt, API, åtgärd
- Gatewayer: klassisk, v2, förbrukning, lokalt installerad, arbetsyta
Exempel
<check-header name="Authorization" failed-check-httpcode="401" failed-check-error-message="Not authorized" ignore-case="false">
<value>f6dc69a089844cf6b2019bae6d36fac8</value>
</check-header>
Relaterade principer
Relaterat innehåll
Mer information om hur du arbetar med principer finns i:
- Självstudie: Transformera och skydda ditt API
- Principreferens för en fullständig lista över principinstruktioner och deras inställningar
- Principuttryck
- Ange eller redigera principer
- Återanvända principkonfigurationer
- Lagringsplats för principfragment
- Skapa principer med Microsoft Copilot i Azure