إرفاق مسار مشترَك باستخدام عنصر جذب التدفق

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

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

بما أنّ الرمز المرتبط بخطاف المسار يقع خارج سياق المنطق الأساسي لوكيل واجهة برمجة التطبيقات، يختلف بعض سلوكه عن سلوك وكلاء واجهة برمجة التطبيقات. تذكّر ما يلي:

• يجب أن يكون لديك إذن بإرفاق مسار مشترَك بخطاف مسار. يجب أن تكون مشرفًا في المؤسسة.
• يمكنك إرفاق مسار مشاركة واحد فقط بكلّ ربط مسار.
• يمكنك إرفاق العملية المشترَكة نفسها بعناصر ربط متعددة للعمليات.
• إذا أدّى المسار المشترَك المرتبط بخطاف مسار إلى حدوث خطأ أو حدثت أخطاء أثناء تنفيذ المسار المشترَك، سيتم رفض الرسالة وإعادة إرسال الخطأ إلى المُتصل.
• إذا تم رفض رسالة أثناء تنفيذ ربط مسار، سيتم تسجيل التفاصيل في ملف اتّباع الأداء في سياق الخادم الوكيل الذي تمّ استدعاؤه. يمكن أن تؤدي العملية المشترَكة أيضًا إلى حدوث خطأ باستخدام رمز مخصّص ورسالة خطأ.

يوضّح الفيديو التالي كيفية ربط مسار مستخدِم مشترَك بخطاف مسار مستخدِم، ثم تتبُّعه، في واجهة مستخدِم Edge الكلاسيكية.

يوضِّح الفيديو التالي كيفية ربط مسار مشترَك بخطاف مسار، ثم تتبُّعه، في واجهة مستخدم تجربة Edge الجديدة.

إنّ عملية مشترَكة مرفقة بخادم وكيل من خلال ربط عملية يشكّل مكانًا رائعًا للّوجم الذي يفرض متطلبات سياسة واسعة النطاق. على سبيل المثال، تخيل أنّ لديك فريقًا واحدًا يدير مجموعة واحدة من متطلبات الأمان لفِرق متعدّدة تمثّل مجالات عمل مختلفة (LOB). يمكن لكل فريق LOB تطوير واجهات برمجة التطبيقات وفقًا لمتطلباته الخاصة، وبدون الحاجة إلى مراعاة متطلبات الأمان الأوسع نطاقًا. يمكن لفريق الأمان تنفيذ متطلبات أمان هذه في عملية مشترَكة، ثم إرفاق العملية ببيئة Apigee Edge باستخدام ربط العملية. بما أنّ المسار المشترَك ليس جزءًا من رمز الخادم الوكيل، يمكن لفريق الأمان مراجعته حسب الحاجة بدون التدخل في رمز الأنشطة التجارية.

يتم تنفيذ المسارات المشتركة المرفقة من خلال "خطافات المسارات" في هذا الموضع لكل وكيل لواجهة برمجة التطبيقات تم نشره في بيئة "خطاف الوكيل". لهذا السبب، لا تتوفّر إمكانية استخدام "مخطّطات الربط" إلا للمشرفين في مؤسسة Apigee Edge.

لمزيد من المعلومات عن مسارات الإحالات الناجحة المشتركة، يُرجى الاطّلاع على مسارات الإحالات الناجحة المشترَكة القابلة لإعادة الاستخدام.

يمكنك إرفاق مسار مشترَك بخطاف مسار باستخدام وحدة تحكّم إدارة Apigee Edge. يمكنك إرفاق مسار مشاركة واحد كحدّ أقصى بخطاف مسار في كلّ من المواضع التالية:

• خطاف سير العمل قبل الخادم الوكيل للّوجم التي يجب فرضها قبل تنفيذ نقطة نهاية الخادم الوكيل

  على سبيل المثال، يمكنك استخدام منطق لفرض الأمان على جميع واجهات برمجة التطبيقات في بيئة معيّنة.

• خطاف مسار ما قبل الاستهداف للّوجم الذي يجب فرضه قبل استدعاء هدف

  على سبيل المثال، يمكنك تنفيذ التسجيل قبل وصول الطلب إلى الخلفية. يمكنك أيضًا فرض التوسّط من خلال إزالة حقول معيّنة من الطلب.

• خطاف مسار ما بعد الاستهداف للمنطق الذي يجب فرضه بعد تنفيذ الردّ المستهدف

  سيتم فرض هذا الإجراء مباشرةً بعد تلقّي الردّ من الخلفية. يمكنك استخدامه لتسجيل استجابة الخلفية أو إجراء بعض التوسّط عن طريق إزالة الحقول الحسّاسة من استجابة الخلفية.

• Post-proxy Flow Hook للّوجم الذي يجب فرضه بعد نقطة نهاية الخادم الوكيل قبل إرسال الردّ إلى العميل مباشرةً

  وقد يشمل ذلك بعض منطق التنفيذ لبروتوكول CORS أو تسجيل الاستجابة أو تنفيذ بعض عمليات الدمج أو التنسيق.

إرفاق مسار مشترَك بخطاف مسار

لإرفاق مسار مشترَك بخطاف مسار، يجب أن تكون مشرفًا في المؤسسة التي تحتوي على المسار المشترَك.

1. انتقِل إلى صفحة "نقاط الربط في مسار الإحالة الناجحة"، كما هو موضّح أدناه.

   Edge

   للوصول إلى صفحة "عناصر الربط في مسار الإحالة الناجحة" باستخدام واجهة مستخدم Edge:

   1. سجِّل الدخول إلى apigee.com/edge.
   2. اختَر المؤسسة التي تحتوي على عملية الإعداد المشترَكة. اطّلِع على التبديل بين المؤسسات.

      سيكون المسار المشترَك متاحًا لأيّ خوادم وكيل لواجهات برمجة التطبيقات ومسارات مشترَكة تم نشرها في بيئة من هذه المؤسسة. ولن يكون متاحًا من خارج هذه المؤسسة.

   3. اختَر المشرف > البيئات > عناصر الربط في المسارات في شريط التنقّل الأيمن.

   Classic Edge (سحابة خاصة)

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

   1. سجِّل الدخول إلى http://ms-ip:9000، حيث يكون ms-ip هو عنوان IP أو اسم نظام أسماء النطاقات الخاص بعقدة "خادم الإدارة".
   2. اختَر المؤسسة التي تحتوي على عملية الإعداد المشترَكة. اطّلِع على التبديل بين المؤسسات.

      سيكون المسار المشترَك متاحًا لأيّ خوادم وكيل لواجهات برمجة التطبيقات ومسارات مشترَكة تم نشرها في بيئة من هذه المؤسسة. ولن يكون متاحًا من خارج هذه المؤسسة.

   3. اختَر واجهات برمجة التطبيقات > إعدادات البيئة > أدوات ربط الخطوات في شريط التنقّل العلوي.
2. في قائمة نقاط ربط المسار، حدِّد نقطة ربط المسار التي تريد إرفاق المسار المشترَك بها بناءً على المكان الذي تريد تنفيذ المسار المشترَك فيه.

   موقع خطاف التدفق	الوصف
   خطاف مسار ما قبل الخادم الوكيل	قبل تنفيذ نقطة نهاية الوكيل
   عنصر الربط في مسار الإحالة الناجحة قبل اكتمال الاستهداف	قبل تنفيذ نقطة نهاية مستهدَفة
   عنصر الربط في مسار الإحالة الناجحة بعد اكتمال استهداف الجمهور	بعد تنفيذ الردّ المستهدَف
   Post-proxy Flow Hook	بعد نقطة نهاية الخادم الوكيل وقبل إرسال الاستجابة مباشرةً إلى العميل

3. ضع مؤشر الماوس فوق ربط المسار في القائمة لعرض عمود الإجراءات.
4. انقر على .
5. في مربّع حوار "المسار المشترَك"، اختَر المسار المشترَك الذي تريد إرفاقه في القائمة المنسدلة المسار المشترَك.
6. انقر على موافق.
7. اربط مسارات الإحالة الناجحة المشتركة بعناصر ربط مسارات الإحالة الناجحة الأخرى حسب الحاجة.