استجابة HTTP 304 في جلسة التتبع

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

المشكلة

في Edge for the Private Cloud، عند تتبُّع واجهة برمجة تطبيقات في واجهة مستخدم Edge، تظهر لك استجابة HTTP 304 في عمود الحالة في نافذة التتبُّع:

رسائل الخطأ

لا تظهر أي رسائل خطأ، بل يعرض طلب وكيل واجهة برمجة التطبيقات استجابة ناجحة، مثل HTTP 200. ومع ذلك، تعرض نافذة التتبُّع في واجهة مستخدم Edge الردّ HTTP 304 ولا يتم جمع أي بيانات تتبُّع.

الأسباب المحتملة

في Edge for the Private Cloud، تحاول واجهة مستخدم Edge تتبُّع خادم وكيل لواجهة برمجة التطبيقات تم الوصول إليه باستخدام عنوان IP خاص.

تتيح أداة التتبُّع في واجهة مستخدم Edge إمكانية إرسال طلب بيانات من واجهة برمجة التطبيقات إلى أي عنوان URL. في سيناريو نشر يتم فيه استضافة واجهة مستخدم Edge بشكل مشترك مع خدمات داخلية أخرى، قد يسيء أحد المستخدمين استخدام أداة التتبُّع لتقديم طلبات إلى الخدمات من خلال عنوان IP خاص، مثل المضيف المحلي أو 127.0.0.1.

في بيئة التشغيل الفعلي، يمكنك عادةً ترك الإعداد التلقائي كما هو لمنع المستخدمين من تتبُّع عنوان IP خاص. على سبيل المثال، يتم نشر الإصدار المتاح للجميع من واجهة مستخدم Edge بهذه الطريقة.

ومع ذلك، بالنسبة إلى بيئة التطوير أو الاختبار الداخلية، يمكنك تجاهل هذا الإعداد التلقائي للسماح لمطوّري واجهة برمجة التطبيقات بتتبُّع أي عنوان IP. عادةً، تكون بيئة التطوير/الاختبار محمية بجدار حماية لا يسمح بالوصول العام.

ملاحظة: كأفضل ممارسة، يجب ترك الإعداد التلقائي كما هو لمنع الوصول إلى عناوين IP الخاصة، حتى في بيئة التطوير/الاختبار، إلا إذا واجهت موقفًا يستدعي تفعيله.

السبب: محاولة الوصول إلى خادم وكيل لواجهة برمجة التطبيقات من خلال عنوان IP خاص

تمنع واجهة مستخدم Edge في Edge Private Cloud تلقائيًا المستخدمين من تتبُّع طلبات البيانات من واجهة برمجة التطبيقات التي يتم إجراؤها من خلال عناوين IP الخاصة. تتضمّن قائمة عناوين IP الخاصة ما يلي:

  • عنوان الاسترجاع (127.0.0.1 أو المضيف المحلي)
  • العناوين الخاصة بالموقع (بالنسبة إلى IPv4 - 10.0.0.0/8 و172.16.0.0/12 و192.168.0.0/16)
  • أي عنوان محلي (أي عنوان يتم تحويله إلى المضيف المحلي)

على سبيل المثال، ينفّذ أمر curl التالي طلبًا إلى خادم وكيل لواجهة برمجة التطبيقات باستخدام عنوان IP هو 127.0.0.1، والذي يُعدّ عنوان IP خاصًا:

curl http://127.0.0.1:9001/myapiproxy

في نافذة التتبُّع لهذا الطلب، ستظهر لك استجابة HTTP 304 حتى إذا كان الأمر curl قد عرض نجاحًا.

الدقة

لتفعيل واجهة مستخدم Edge لتتبُّع عناوين IP الخاصة في Edge for Private Cloud، اضبط الرمز المميز التالي في ui.properties:

conf_apigee-base_apigee.feature.enabletraceforinternaladdresses="true"

لضبط هذه السمة، اتّبِع الخطوات التالية:

  1. افتح ملف ui.properties في محرِّر. إذا لم يكن الملف متاحًا، أنشِئه.
    vi /opt/apigee/customer/application/ui.properties
  2. عيِّن القيم التالية على "صحيح":
    conf_apigee-base_apigee.feature.enabletraceforinternaladdresses="true"
  3. احفظ التغييرات في ui.properties.
  4. تأكَّد من أنّ ملف الخصائص يمتلكه المستخدم "apigee":
    chown apigee:apigee /opt/apigee/customer/application/ui.properties
  5. أعِد تشغيل واجهة مستخدم Edge باتّباع الخطوات التالية:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

يمكن الآن لواجهة مستخدم Edge الوصول إلى عناوين IP الخاصة في أداة التتبُّع.

لإيقاف واجهة المستخدم عن تتبُّع الطلبات من خلال عناوين IP الخاصة في وقت لاحق، عدِّل ui.properties لضبط القيمة على false، ثم أعِد تشغيل واجهة مستخدم Edge.

لمزيد من المعلومات، يُرجى الاطّلاع على السماح لواجهة مستخدم Edge بالوصول إلى عناوين IP المحلية.