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

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

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

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

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

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

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

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

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

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

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

• Pre-proxy Flow Hook للمنطق الذي يجب فرضه قبل تنفيذ نقطة نهاية الخادم الوكيل.

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

• Pre-target Flow Hook للمنطق الذي يجب فرضه قبل استدعاء هدف.

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

• Post-target Flow Hook للمنطق الذي يجب فرضه بعد تنفيذ الرد المستهدف.

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

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

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

ربط مسار مشترك بخطاف مسار

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

1. يمكنك الوصول إلى صفحة "خطافات Flow"، كما هو موضّح أدناه.

   Edge

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

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

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

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

   Classic Edge (Private Cloud)

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

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

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

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

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

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