Kontrollera HTTP-huvud

  • Artikel

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

Användning

Exempel

<check-header name="Authorization" failed-check-httpcode="401" failed-check-error-message="Not authorized" ignore-case="false">
    <value>f6dc69a089844cf6b2019bae6d36fac8</value>
</check-header>

Relaterat innehåll

Mer information om hur du arbetar med principer finns i: