502 مدخل غير صالح - الاستجابة 405 بدون عنوان السماح

مراقبة واجهة برمجة التطبيقات

لتشخيص الخطأ باستخدام مراقبة واجهة برمجة التطبيقات:

1. سجِّل الدخول إلى واجهة مستخدم Edge كمستخدم لديه الدور المناسب.

2. انتقِل إلى المؤسسة التي تريد التحقيق في المشكلة فيها.

   
3. انتقل إلى صفحة تحليل > مراقبة واجهة برمجة التطبيقات > التحقيق.
4. اختَر الإطار الزمني المحدّد الذي لاحظت فيه الأخطاء.

5. ارسم رمز الخطأ مقابل الوقت.

6. اختَر خلية تحتوي على رمز الخطأ protocol.http.Response405WithoutAllowHeader كما هو موضّح أدناه:

   

7. يتم عرض المعلومات المتعلقة برمز الخطأ protocol.http.Response405WithoutAllowHeader كما هو موضّح أدناه:

   

8. انقر على عرض السجلات ووسِّع أحد الطلبات التي تعذّر تنفيذها للاطّلاع على مزيد من المعلومات.

   
9. من نافذة السجلّات، دوِّن التفاصيل التالية:
   • رمز الحالة: 502
   • مصدر الخطأ: target
   • رمز الخطأ: protocol.http.Response405WithoutAllowHeader.
10. إذا كان مصدر الخطأ هو target ورمز الخطأ هو protocol.http.Response405WithoutAllowHeader، يشير ذلك إلى أنّ خادم الخلفية قد استجاب برمز الحالة 405 Method Not Allowed بدون العنوان Allow.

أداة التتبُّع

لتشخيص الخطأ باستخدام أداة التتبُّع:

1. فعِّل جلسة التتبُّع وإمّا
   • انتظر حتى يحدث الخطأ 502 Bad Gateway، أو
   • إذا كان بإمكانك إعادة إظهار المشكلة، عليك إجراء طلب بيانات من واجهة برمجة التطبيقات لإعادة إظهار المشكلة - خطأ 502 Bad Gateway

2. تأكَّد من تفعيل Show all FlowInfos (إظهار جميع عمليات التدفق):

   
3. اختَر أحد الطلبات التي تعذّر تنفيذها وافحص بيانات التتبّع.
4. تنقَّل عبر المراحل المختلفة من عملية التتبُّع وحدِّد مكان حدوث الفشل.

5. ستجد الخطأ عادةً في عملية تدفق بعد مرحلة تم إرسال الطلب إلى الخادم الهدف كما هو موضّح أدناه:

   

6. دوِّن قيمة الخطأ في عملية التتبّع.

   يعرض تقرير تتبُّع النموذج أعلاه الخطأ على أنّه Received 405 Response without Allow Header. بما أنّ الخطأ رفعه من قِبل Apigee بعد إرسال الطلب إلى خادم الخلفية، فهو يشير إلى أنّ خادم الخلفية أرسل رمز حالة الاستجابة 405 بدون العنوان Allow.

7. انتقِل إلى مرحلة AX (بيانات "إحصاءات Google" المسجّلة) في التتبُّع وانقر عليها.

8. انتقِل للأسفل إلى قسم Error / Response Headers (عناوين الخطأ/الاستجابة) في لوحة Stage Details (تفاصيل المرحلة) وحدِّد قيم X-Apigee-error-code وX-Apigee- error-source كما هو موضّح أدناه:

   
9. ستظهر قيمتا X-Apigee-fault-code وX-Apigee-fault-code، على أنّه protocol.http.Response405WithoutAllowHeader وtargetعلى التوالي، ما يشير إلى أنّ الخلفية أرسلت رمز حالة الاستجابة 405 بدون عنوان Allow.

   عناوين الاستجابة	القيمة
   X-Apigee-fault-code	protocol.http.Response405WithoutAllowHeader
   X-Apigee-fault-source	target

NGINX

لتشخيص الخطأ باستخدام سجلات الوصول إلى NGINX:

1. إذا كنت من مستخدمي السحابة الإلكترونية الخاصة، يمكنك استخدام سجلات وصول NGINX لتحديد المعلومات الأساسية حول أخطاء 502 في HTTP.

2. تحقَّق من سجلات وصول NGINX:

   /opt/apigee/var/log/edge-router/nginx/ORG~ORG.PORT#_access_log
   

   المكان: يتم استبدال ORG وORG وPORT# بالقيم الفعلية.

3. ابحث عن أي أخطاء 502 تتضمّن رمز الخطأ protocol.http.Response405WithoutAllowHeader خلال مدة معيّنة (في حال حدثت المشكلة في السابق) أو لمعرفة ما إذا كانت هناك أي طلبات لا تزال يتعذّر تنفيذها من خلال 502.

4. إذا عثرت على أي أخطاء 502 تتضمّن الرمز X-Apigee-fault-code الذي يطابق القيمة protocol.http.Response405WithoutAllowHeader، حدِّد قيمة X-Apigee-fault-code

   نموذج خطأ 502 من سجل وصول NGINX:

   

   يحتوي إدخال النموذج أعلاه من سجل الوصول إلى NGINX على القيم التالية للسمة X-Apigee- error-code وX-Apigee-Error-source:

   عناوين الاستجابة	القيمة
   X-Apigee-fault-code	protocol.http.Response405WithoutAllowHeader
   X-Apigee-fault-source	target

خادم الخلفية

الخيار #1: إصلاح خادم الخلفية لإرسال رمز الحالة 405 مع العنوان "Allow" (السماح):

1. تأكَّد من أنّ الخادم الخلفي يتقيّد دائمًا بالمواصفات RFC 7231، الفقرة 6.5.5: 405 Method Not Allowed، وإرسال الرسائل باستخدام رمز الحالة 405 من خلال تضمين قائمة بالطرق المسموح بها كجزء من عنوان Allow كما هو موضّح أدناه:

   Allow: HTTP_METHODS
   

2. على سبيل المثال، إذا كان خادم الخلفية يسمح بالطرق GET وPOST وHEAD، يجب التأكّد من أنّ عنوان Allow يحتوي على تلك الطرق على النحو التالي:

   Allow: GET, POST, HEAD
   

التعامل مع الأخطاء

الخيار 2: استخدام "معالجة الأخطاء" لإرسال رمز الحالة 405 مع العنوان "Allow" (السماح) من الخادم الوكيل لواجهة برمجة التطبيقات:

إذا كان الخادم الخلفي يعرض رمز الحالة 405 بدون العنوان Allow، يمكنك استخدام معالجة الأخطاء للردّ باستخدام رمز الحالة 405 وعنوان Allow من الخادم الوكيل لواجهة برمجة التطبيقات على النحو التالي:

1. يمكنك إنشاء سياسة مثل سياسةAssignMessage أو ClaimFault وضبط رمز الحالة على 405 باستخدام عنوان Allow ورسالة مخصَّصة.

   نموذج سياسة AssignMessage لإرسال رسالة خطأ 405 مع استخدام العنوان "Allow" (السماح):

   <AssignMessage async="false" continueOnError="false" enabled="true" name="AM-405WithAllowHeader">
       <DisplayName>AM-405WithAllowHeader</DisplayName>
       <Set>
           <Payload contentType="application/json">{"Specified method is not allowed. Please use one of the methods mentioned in the Allow header."}</Payload>
           <StatusCode>405</StatusCode>
           <ReasonPhrase>Method Not Allowed</ReasonPhrase>
       </Set>
       <Add>
           <Headers>
               <Header name="Allow">GET, POST, HEAD</Header>
           </Headers>
       </Add>
       <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
       <AssignTo createNew="false" transport="http" type="request"/>
   </AssignMessage>
   

2. أنشِئ FaultRule في TargetEndpoint لتفعيل السياسة عند ظهور الخطأ 502 مع رمز الخطأ protocol.http.Response405WithoutAllowHeader.

   نموذج إعدادات ميزة TargetEndpoint الذي يعرض الخطأ المتعلّق بقاعدة الخطأ:

   <TargetEndpoint name="default">
   ...
       <FaultRules>
          <FaultRule name="405WithoutAllowHeader">
               <Step>
                   <Name>AM-405WithAllowHeader</Name>
               </Step>
               <Condition>(fault.name = "Response405WithoutAllowHeader")</Condition>
           </FaultRule>
       </FaultRules>
   

3. احفظ هذه التغييرات في نسخة جديدة من الخادم الوكيل لواجهة برمجة التطبيقات وانشر النسخة.
4. يمكنك إجراء طلبات بيانات من واجهة برمجة التطبيقات والتأكّد من أنّك تتلقّى رمز الحالة 405 باستخدام العنوان Allow.

إعداد الموقع

الخيار #3: ضبط السمة في "معالج الرسائل" لمنع Apigee Edge من عرض الخطأ 502

1. إذا كنت من مستخدمي السحابة الإلكترونية الخاصة، يمكنك تعديل الموقع HTTP.ignore.allow_header.for.405 إلى true لمنع Apigee Edge من عرض الخطأ 502، حتى إذا استجاب خادم الخلفية برمز الحالة 405 بدون العنوان Allow باستخدام دليل طريقة التنفيذ: ضبط عنوان التجاهل للسمة 405 في معالجات الرسائل.
2. إذا كنت من مستخدمي Public Cloud، يُرجى التواصل مع فريق دعم Apigee Edge.