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

أنت تعرض مستندات Apigee Edge.
انتقل إلى مستندات Apigee X. معلومات

المشكلة

في 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 for the 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 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 المحلية: