التحقق من رأس HTTP
ينطبق على: جميع مستويات إدارة واجهة برمجة التطبيقات
استخدم نهج check-header لفرض أن الطلب يحتوي على عنوان HTTP محدد. يمكنك التحقق اختياريا لمعرفة ما إذا كان العنوان يحتوي على قيمة معينة أو إحدى نطاقات القيم المسموح بها. إذا فشل الفحص، فسينهي النهج معالجة الطلب ويُرجع التعليمة البرمجية لحالة HTTP ورسالة الخطأ المحددة من قبل النهج.
إشعار
تعيين عناصر النهج والعناصر التابعة بالترتيب الوارد في بيان النهج. تعلم كيفية إعداد نُهج APIM أو تعديلها.
نهج السياسة
<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>
سمات
| السمة | الوصف | مطلوبة | افتراضي |
|---|---|---|---|
| الاسم | اسم رأس HTTP المراد التحقق منه. يتم السماح بتعبيرات النهج. | نعم | غير متوفر |
| failed-check-httpcode | رمز حالة HTTP لإرجاعه إذا لم يكن العنوان موجودا أو يحتوي على قيمة غير صالحة. يتم السماح بتعبيرات النهج. | نعم | غير متوفر |
| failed-check-error-message | رسالة خطأ تعود في نص استجابة HTTP إذا كان العنوان غير موجود أو يحتوي على قيمة غير صالحة. يجب أن تتضمن هذه الرسالة أي أحرف خاصة تم تخطيها بشكل صحيح. يتم السماح بتعبيرات النهج. | نعم | غير متوفر |
| ignore-case | منطقي. إذا تم تعيينها إلى true، يتم تجاهل الحالة عند مقارنة قيمة العنوان بمجموعة القيم المقبولة. يتم السماح بتعبيرات النهج. |
نعم | غير متوفر |
عناصر
| العنصر | الوصف | مطلوب |
|---|---|---|
| قيمة | أضف عنصرا واحدا أو أكثر من هذه العناصر لتحديد قيم رأس HTTP المسموح بها. عند تحديد عناصر متعددة value ، يعتبر الفحص ناجحا إذا كانت أي من القيم متطابقة. |
لا |
الاستخدام
- أقسام النهج:الواردة.
- نطاقات النهج: العمومية، والمنتج، وواجهة برمجة التطبيقات، والتشغيل
- البوابات: الكلاسيكية، الإصدار 2، الاستهلاك، المستضافة ذاتيا
مثال
<check-header name="Authorization" failed-check-httpcode="401" failed-check-error-message="Not authorized" ignore-case="false">
<value>f6dc69a089844cf6b2019bae6d36fac8</value>
</check-header>
النهج ذات الصلة
المحتوى ذو الصلة
لمزيد من المعلومات حول العمل مع النُهج، راجع: