مشاركة عبر

التحقق من رأس 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 ، يعتبر الفحص ناجحا إذا كانت أي من القيم متطابقة. لا

الاستخدام

مثال

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

المحتوى ذو الصلة

لمزيد من المعلومات حول العمل مع النُهج، راجع: