HTTP-fejléc ellenőrzése
A KÖVETKEZŐRE VONATKOZIK: Minden API Management-szint
check-header
A házirend használatával kényszerítheti, hogy a kérések megadott HTTP-fejlécmel rendelkezhessenek. Igény szerint ellenőrizheti, hogy a fejléc egy adott értékkel vagy egy engedélyezett értéktartomány egyikével rendelkezik-e. Ha az ellenőrzés sikertelen, a szabályzat leállítja a kérelmek feldolgozását, és visszaadja a szabályzat által megadott HTTP-állapotkódot és hibaüzenetet.
Feljegyzés
Állítsa be a szabályzat elemeit és gyermekelemeit a szabályzatutasításban megadott sorrendben. További információ az API Management-szabályzatok beállításáról és szerkesztéséről.
Szabályzatutasítás
<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>
Attribútumok
Attribútum | Leírás | Kötelező | Alapértelmezett |
---|---|---|---|
név | Az ellenőrizni kívánt HTTP-fejléc neve. A szabályzatkifejezések engedélyezettek. | Igen | n/a |
failed-check-httpcode | A HTTP-állapotkód visszaadása, ha a fejléc nem létezik, vagy érvénytelen értékkel rendelkezik. A szabályzatkifejezések engedélyezettek. | Igen | n/a |
failed-check-error-message | Hibaüzenet a HTTP-válasz törzsében való visszatéréshez, ha a fejléc nem létezik vagy érvénytelen értékkel rendelkezik. Ennek az üzenetnek megfelelően kell tartalmaznia a speciális karaktereket. A szabályzatkifejezések engedélyezettek. | Igen | n/a |
ignore-case | Logikai. Ha be van állítva, true a rendszer figyelmen kívül hagyja a kis- és nagybetűket, ha a fejléc értékét összehasonlítja az elfogadható értékekkel. A szabályzatkifejezések engedélyezettek. |
Igen | n/a |
Elemek
Elem | Leírás | Kötelező |
---|---|---|
Érték | Adjon hozzá egy vagy több elemet az engedélyezett HTTP-fejlécértékek megadásához. Ha több value elem van megadva, az ellenőrzés sikeresnek minősül, ha az értékek bármelyike egyezik. |
Nem |
Használat
- Szabályzatszakaszok: bejövő
- Szabályzat hatókörei: globális, termék, API, művelet
- Átjárók: klasszikus, v2, használat, saját üzemeltetésű, munkaterület
Példa
<check-header name="Authorization" failed-check-httpcode="401" failed-check-error-message="Not authorized" ignore-case="false">
<value>f6dc69a089844cf6b2019bae6d36fac8</value>
</check-header>
Kapcsolódó szabályzatok
Kapcsolódó tartalom
A szabályzatok használatával kapcsolatos további információkért lásd:
- Oktatóanyag: AZ API átalakítása és védelme
- Szabályzathivatkozás a szabályzatutasságok és azok beállításainak teljes listájához
- Házirend-kifejezések
- Házirendek beállítása vagy szerkesztése
- Szabályzatkonfigurációk újrafelhasználása
- Szabályzatrészletek adattára
- Azure API Management policy toolkit
- Szabályzatok létrehozása a Microsoft Copilot használatával az Azure-ban