يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات
Apigee X. المعلومات
يمكنك أن تطلب من التدفقات المشتركة تنفيذ عملية قبل معالجة طلبات نموذجية أو معالجة ما بعد معالجة الاستجابة عبر مجموعة من واجهات برمجة التطبيقات. باستخدام عنصر الجذب للتدفق، يمكنك إرفاق تدفق مشترك بحيث يتم تنفيذه في المكان نفسه لجميع الخوادم الوكيلة لواجهة برمجة التطبيقات التي تم نشرها في بيئة معيّنة. يمنحك ذلك تسلسلاً منطقيًا تم تنفيذه ونشره بشكل منفصل وليس جزءًا من رمز تنفيذ الخادم الوكيل.
يختلف بعض سلوكه عن الخوادم الوكيلة لواجهة برمجة التطبيقات لأنّ الرمز البرمجي المرفق بعنصر جذب التدفق يكون خارج سياق المنطق الأساسي للخادم الوكيل لواجهة برمجة التطبيقات. تذكّر ما يلي:
- يجب أن يكون لديك إذن بإرفاق مسار مشترَك بأداة الجذب. يجب أن تكون مشرفًا لمؤسسة.
- ويمكنك إرفاق مسار مشترَك واحد فقط بكل عنصر جذب.
- يمكنك إرفاق المسار المشترَك نفسه بمعرّفات تدفق متعددة.
- إذا أدى التدفق المشترَك المرفق بعنصر الجذب في التدفق إلى حدوث خطأ أو إذا حدثت أخطاء أثناء تنفيذ التدفق المشترَك، سيتم رفض الرسالة وإعادة إرسال الخطأ إلى المتصل.
- في حال رفض رسالة أثناء تنفيذ عنصر جذب التدفق، سيتم تسجيل التفاصيل في "إحصاءات Google" ضمن سياق الخادم الوكيل الذي يُسمى ذلك. يمكن أن يؤدي التدفق المشترَك أيضًا إلى حدوث خطأ في حال استخدام رمز مخصّص ورسالة خطأ.
يوضّح الفيديو التالي كيفية ربط تدفّق مشترَك بعنصر جذب التدفق، ثم تتبُّعه في واجهة مستخدم الإصدار الكلاسيكي من Edge.
يوضّح الفيديو التالي كيفية ربط تدفّق مشترَك بعنصر جذب التدفق، ثم تتبُّعه في واجهة مستخدم تجربة New Edge.
إنّ التدفق المشترَك المرفق بخادم وكيل من خلال عنصر جذب للتدفق يوفّر مكانًا رائعًا للمنطق الذي يفرض متطلبات سياسة واسعة النطاق. على سبيل المثال، لنفترض أنّ لديك فريقًا واحدًا يدير مجموعة واحدة من متطلبات الأمان لفِرق متعددة تمثّل أنواعًا مختلفة من الأنشطة التجارية. يستطيع كل فريق من فِرق نوع النشاط التجاري تطوير واجهات برمجة تطبيقات وفقًا للمتطلبات الخاصة به، وبدون الحاجة إلى مراعاة متطلبات الأمان الأوسع نطاقًا. يمكن لفريق الأمان تنفيذ متطلبات الأمان هذه في مسار مشترَك، ثم إرفاق التدفق ببيئة Apigee Edge باستخدام عنصر جذب للتدفق. بما أنّ المسار المشترَك ليس جزءًا من رمز الخادم الوكيل، يمكن لفريق الأمان مراجعته حسب الحاجة بدون التدخل في رمز نوع النشاط التجاري.
يتم تنفيذ التدفقات المشتركة المرفقة عبر هوات التدفق في هذا الموضع لكل خادم وكيل لواجهة برمجة تطبيقات تم نشره في بيئة شريط أدوات الخادم الوكيل. لهذا السبب، لا يمكن استخدام ميزة إدراجات التدفق إلا للمشرفين في مؤسسة Apigee Edge.
لمزيد من المعلومات عن المسارات المشتركة، يُرجى الاطّلاع على التدفقات المشتركة القابلة لإعادة الاستخدام.
يمكنك إرفاق تدفق مشترك بعنصر جذب التدفق باستخدام وحدة تحكُّم الإدارة Apigee Edge. يمكنك إرفاق مسار مشترَك واحد على الأكثر بعنصر جذب التدفق في كلّ من المواضع التالية:
-
عنصر تعليق تدفق ما قبل الخادم الوكيل للمنطق الذي يجب فرضه قبل تنفيذ نقطة نهاية الخادم الوكيل.
على سبيل المثال، قد يكون لديك منطق لفرض الأمان في جميع واجهات برمجة التطبيقات في بيئة معيّنة.
-
عنصر جذب قبل الاستهداف للمنطق الذي يجب فرضه قبل طلب الهدف.
على سبيل المثال، يمكنك تنفيذ تسجيل قبل وصول الطلب إلى الخلفية. يمكنك أيضًا فرض التوسّط من خلال إزالة حقول معيّنة من الطلب.
-
عنصر الجذب في مسار ما بعد الاستهداف للمنطق الذي يجب فرضه بعد تنفيذ الاستجابة المستهدَفة.
سيتم فرض هذا مباشرة بعد عودة الاستجابة من الخلفية. ويمكنك استخدامه لتسجيل استجابة الخلفية أو إجراء بعض التوسّط من خلال إزالة الحقول الحسّاسة من استجابة الخلفية.
-
ربط تدفق ما بعد الخادم الوكيل للمنطق الذي يجب فرضه بعد نقطة نهاية الخادم الوكيل
وقبل إرسال الاستجابة إلى العميل مباشرةً
وقد يتضمن ذلك بعض إجراءات تنفيذ سياسة مشاركة الموارد المتعدّدة المصادر (CORS) أو تسجيل الردود أو تنفيذ بعض عمليات الدمج أو التنسيق.
إرفاق مسار مشترك بعنصر الجذب
لإرفاق مسار مشترَك بعنصر الجذب، يجب أن تكون مشرفًا في المؤسسة التي تحتوي على المسار المشترَك.
- ادخل إلى صفحة "خطّافات التدفق"، كما هو موضّح أدناه.
Edge
للوصول إلى صفحة Flow Hooks باستخدام واجهة مستخدم Edge:
- سجِّل الدخول إلى apigee.com/edge.
- اختَر المؤسسة التي تحتوي على التدفق المشترك. يُرجى الاطّلاع على التبديل بين مؤسّساتك.
سيكون المسار المشترَك متاحًا لأي خوادم وكيلة لواجهة برمجة التطبيقات وعمليات تدفق مشتركة تم نشرها في بيئة من هذه المؤسسة. ولن يكون هذا التطبيق متاحًا من خارج هذه المؤسسة.
- حدّد المشرف > البيئات > عناصر جذب التدفق في شريط التنقل الأيمن.
كلاسيكي Edge (السحابة الإلكترونية الخاصة)
للوصول إلى صفحة Flow Hooks باستخدام واجهة مستخدم الإصدار الكلاسيكي من Edge:
- سجِّل الدخول إلى
http://ms-ip:9000، حيث يشير ms-ip إلى عنوان IP أو اسم نظام أسماء النطاقات لعقدة خادم الإدارة. - اختَر المؤسسة التي تحتوي على التدفق المشترك. يُرجى الاطّلاع على التبديل بين مؤسّساتك.
سيكون المسار المشترَك متاحًا لأي خوادم وكيلة لواجهة برمجة التطبيقات وعمليات تدفق مشتركة تم نشرها في بيئة من هذه المؤسسة. ولن يكون هذا التطبيق متاحًا من خارج هذه المؤسسة.
- حدّد واجهات برمجة التطبيقات > تهيئة البيئة > خطافات التدفق في شريط التنقل العلوي.
- في قائمة معرّفات التدفق، حدِّد عنصر جذب التدفق الذي تريد إرفاق التدفق المشترَك به استنادًا إلى المكان الذي تريد تنفيذ التدفق المشترَك فيه.
موقع خطاف التدفق الوصف خطاف معلّق قبل الخادم الوكيل قبل تنفيذ نقطة نهاية الخادم الوكيل خطاف لتدفق الاستهداف المسبق قبل تنفيذ نقطة نهاية مستهدفة خطاف لتدفق ما بعد الاستهداف بعد تنفيذ الاستجابة المستهدفة خطاف تدفق ما بعد الخادم الوكيل بعد نقطة نهاية الخادم الوكيل وقبل إرسال الاستجابة مباشرةً إلى البرنامج - ضَع المؤشر على عنصر الجذب في القائمة لعرض عمود الإجراءات.
- انقر على
- في مربع الحوار "التدفق المشترك"، حدد التدفق المشترك الذي تريد إرفاقه في القائمة المنسدلة التدفق المشترك.
- انقر على OK (حسنًا).
- أرفِق التدفقات المشترَكة بمعرّفات التدفق الأخرى حسب الحاجة.