Periksa header HTTP
BERLAKU UNTUK: Semua tingkatAN API Management
Gunakan kebijakan check-header untuk memastikan bahwa permintaan memiliki tajuk HTTP yang ditentukan. Anda dapat secara opsional memeriksa untuk melihat apakah header memiliki nilai tertentu atau salah satu rentang nilai yang diizinkan. Jika pemeriksaan gagal, kebijakan menghentikan pemrosesan permintaan dan mengembalikan kode status HTTP dan pesan kesalahan yang ditentukan oleh kebijakan.
Catatan
Tetapkan elemen kebijakan dan elemen turunan dalam urutan yang disediakan dalam pernyataan kebijakan. Pelajari lebih lanjut cara mengatur atau mengedit kebijakan API Management.
Pernyataan kebijakan
<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>
Atribut
| Atribut | Deskripsi | Wajib diisi | Default |
|---|---|---|---|
| nama | Nama header HTTP yang akan diperiksa. Ekspresi kebijakan diizinkan. | Ya | T/A |
| gagal-check-kode http | Kode status HTTP untuk dikembalikan jika header tidak ada atau memiliki nilai yang tidak valid. Ekspresi kebijakan diizinkan. | Ya | T/A |
| gagal-periksa-pesan-kesalahan | Pesan kesalahan untuk ditampilkan di badan tanggapan HTTP jika header tidak ada atau memiliki nilai yang tidak valid. Pesan ini harus memiliki karakter khusus yang lolos dengan benar. Ekspresi kebijakan diizinkan. | Ya | T/A |
| abaikan-huruf besar/kecil | Boolean. Jika diatur ke true, kasus diabaikan ketika nilai header dibandingkan dengan kumpulan nilai yang dapat diterima. Ekspresi kebijakan diizinkan. |
Ya | T/A |
Elemen
| Elemen | Deskripsi | Wajib diisi |
|---|---|---|
| value | Tambahkan satu atau beberapa elemen ini untuk menentukan nilai header HTTP yang diizinkan. Ketika beberapa value elemen ditentukan, pemeriksaan dianggap berhasil jika salah satu nilai cocok. |
No |
Penggunaan
- Bagian kebijakan: masuk
- Cakupan kebijakan: global, produk, API, operasi
- Gateway: klasik, v2, konsumsi, dihost sendiri, ruang kerja
Contoh
<check-header name="Authorization" failed-check-httpcode="401" failed-check-error-message="Not authorized" ignore-case="false">
<value>f6dc69a089844cf6b2019bae6d36fac8</value>
</check-header>
Kebijakan terkait
Konten terkait
Untuk informasi selengkapnya tentang bekerja dengan kebijakan, lihat:
- Tutorial: Mengubah dan melindungi API Anda
- Referensi Kebijakan untuk daftar lengkap pernyataan kebijakan dan pengaturannya
- Ekspresi kebijakan
- Mengatur atau mengedit kebijakan
- Menggunakan kembali konfigurasi kebijakan
- Repositori cuplikan kebijakan
- Toolkit kebijakan Azure API Management
- Kebijakan penulis menggunakan Microsoft Copilot di Azure