تسلسل الخوادم الوكيلة لواجهة برمجة التطبيقات معًا

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

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

باستخدام تسلسل الخادم الوكيل، يمكنك تحديد أن يكون أحدهما هو نقطة النهاية المستهدفة المحلية للأخرى. بدلاً من استخدام العنصر HTTPTargetConnection لإجراء استدعاء للرمز الثاني الخادم الوكيل، فأنت تستخدم العنصر LocalTargetConnection.

<LocalTargetConnection>
    <APIProxy>myproxy2</APIProxy>
    <ProxyEndpoint>default</ProxyEndpoint>
</LocalTargetConnection>

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

فيديو: يمكنك مشاهدة فيديو قصير لمعرفة المزيد من المعلومات حول تسلسل خادم وكيل واجهة برمجة التطبيقات.

آلية عمل تسلسل الخادم الوكيل

يستخدم تسلسل الخادم الوكيل اتصالاً محليًا لتقليل عبء الشبكة عند استدعاء خادم وكيل واحد من آخر. يعد هذا الاتصال المحلي أكثر كفاءة لأنه يتجاوز ميزات الشبكة مثل كأجهزة موازنة الحمل والموجهات ومعالجات الرسائل.

يوضح ما يلي الفرق بين ربط الخوادم الوكيلة باستخدام HTTPTargetConnection وLocalTargetConnection (تسلسل الخادم الوكيل):

يمكنك ربط الخوادم الوكيلة من خلال تحديد أن إحداهما نقطة نهاية محلية مستهدفة للأخرى. يمكنك إنشاء اتصال محلي بين الخوادم الوكيلة بطريقتين:

  • من خلال تحديد اسم الخادم الوكيل المستهدَف واسم ProxyEndpoint
  • من خلال تحديد مسار إلى نقطة نهاية الخادم الوكيل المستهدفة

يمكنك ربط الخوادم الوكيلة المستهدَفة ضمن إعدادات TargetEndpoint، باستخدام LocalTargetConnection، كما هو موضّح أدناه.

ربط الخوادم الوكيلة حسب اسم الخادم الوكيل

يمكنك تحديد الخادم الوكيل المستهدَف حسب الاسم. قد تجد أن هذا يكون أكثر فائدة عندما الاتصال من البداية وتطوير الخوادم الوكيلة معًا. إذا كنت لا تعرف (أو قد يتغير الاسم)، يمكنك الاتصال بمسار نقطة نهاية الخادم الوكيل المستهدف، الموضحة أدناه.

عند الاتصال بخادم وكيل مستهدف حسب الاسم، يمكنك تحديد اسم الخادم الوكيل واسم ProxyEndpoint

يحدّد المثال التالي خادمًا وكيلاً مستهدفًا اسمه data-manager، إلى جانب اسم ProxyEndpoint الذي تم الكشف عنه بواسطة data-manager. كمرجع للحصول على معلومات، يُرجى الاطّلاع على مرجع ضبط الخادم الوكيل لواجهة برمجة التطبيقات.

<TargetEndpoint name="datamanager">
    <PreFlow name="PreFlow">
        <!-- PreFlow policies -->
    </PreFlow>
    <PostFlow name="PostFlow">
        <!-- PostFlow policies -->
    </PostFlow>
    <LocalTargetConnection>
        <APIProxy>data-manager</APIProxy>
        <ProxyEndpoint>default</ProxyEndpoint>
    </LocalTargetConnection>
</TargetEndpoint>

ربط الخوادم الوكيلة حسب المسار

يمكنك تحديد الخادم الوكيل المستهدَف حسب مسار نقطة النهاية. قد ترغب في القيام بذلك بهذه الطريقة عندما لا تعرف اسم الخادم الوكيل أو متى قد يتغير الاسم.

فإذا كان الوكيل هو ببساطة مستهلك الخادم الوكيل المستهدف، على سبيل المثال عندما لا تكون مطورًا كلاهما - قد يكون المسار هو الطريقة الأكثر موثوقية للتواصل. على سبيل المثال، إذا كان الخادم الوكيل الذي الاتصال بها والتي يتم تطويرها وصيانتها من قبل فريق آخر، فقد ترغب في التواصل باستخدام مسار نقطة نهاية موثوق به.

يحدد المثال التالي الخادم الوكيل المستهدف في /v1/streetcarts/foodcarts/data-manager، حيث يُفترض أن يكون المضيف هو نفسه الوكيل الحالي. للحصول على معلومات مرجعية، يُرجى الاطّلاع على مرجع ضبط الخادم الوكيل لواجهة برمجة التطبيقات.

<TargetEndpoint name="datamanager">
    <PreFlow name="PreFlow">
        <!-- PreFlow policies -->
    </PreFlow>
    <PostFlow name="PostFlow">
        <!-- PostFlow policies -->
    </PostFlow>
    <LocalTargetConnection>
        <Path>/v1/streetcarts/foodcarts/data-manager</Path> 
    </LocalTargetConnection>
</TargetEndpoint>

ربط الخوادم الوكيلة بالإدارة وحدة التحكم

يمكنك إنشاء اتصالات تسلسل الخادم الوكيل باستخدام وحدة تحكم إدارة Edge.

  1. افتح الخادم الوكيل الذي سيستخدم الخادم الوكيل المستهدَف.
  2. في المستكشف، انقر على علامة الجمع بجانب نقاط النهاية المستهدفة.
  3. في مربّع الحوار نقطة نهاية هدف جديدة، أدخِل اسم نقطة النهاية الهدف.
  4. أسفل المربع اسم نقطة النهاية المستهدفة، حدِّد أحد الخيارات التالية:
    • سلسلة الخادم الوكيل للاختيار من قائمة بالخوادم الوكيلة المتوفّرة في المؤسسة محددة.
      1. في القائمة المنسدلة اسم الخادم الوكيل، اختَر الخادم الوكيل المستهدَف.
      2. في مربع نقطة نهاية الخادم الوكيل، أدخِل مسار نقطة نهاية الخادم الوكيل المستهدَف الذي تريد الاتصال بها.
    • سلسلة المسار لإدخال المسار الأساسي للخادم الوكيل المستهدَف، مثل /mypath/myproxy/myendpoint
  5. انقر على إضافة.

الخوادم الوكيلة المتسلسلة ومنتجات واجهات برمجة التطبيقات والأمان

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

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