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

يتم الآن عرض مستندات 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 محليًا. يمكن للرمز الخاص بك التحقق من أنّه محلي قبل السماح بمتابعة المعالجة. اطّلِع على سياسة التحكّم في الوصول للتعرُّف على طريقة واحدة لإجراء ذلك.