إعداد الخوادم الوكيلة لإعادة التوجيه

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

لاستخدام خادم وكيل HTTP لإعادة التوجيه بين Edge وTargetEndpoint، عليك ضبط إعدادات الخادم الوكيل الصادر في "معالِجات الرسائل" (MP). تضبط هذه السمات معالجات الرسائل لتوجيه طلبات الاستهداف من Edge إلى خادم وكيل إعادة توجيه HTTP.

لضبط معالج الرسائل لإعادة توجيه الخادم الوكيل:

  1. في معالج الرسائل، عدِّل الملف التالي:
    /opt/apigee/customer/application/message-processor.properties

    إذا لم يكن ملف message-processor.properties متوفّرًا، أنشِئه.

  2. عدِّل الملف لضبط السمات ذات الصلة بالخادم الوكيل الموضّحة في الجدول أدناه.
  3. تأكَّد من أنّ ملف الخصائص مملوك للمستخدم "apigee":
    chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
  4. احفظ التغييرات في ملف المواقع.
  5. أعِد تشغيل معالج الرسائل، كما هو موضّح في المثال التالي:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

يوضّح الجدول التالي السمات في ملف message-processor.properties التي تستخدمها لضبط معالج الرسائل لإعادة التوجيه إلى خادم خلفي:

الموقع الوصف
conf_http_HTTPClient.use.proxy

يسمح باستخدام الخادم الوكيل لإعادة التوجيه. القيمة التلقائية هي true، ما يعني أنّه يمكنك استخدام خادم وكيل لإعادة التوجيه في طبقة الخادم الوكيل لواجهة برمجة التطبيقات من خلال تضمين ملف XML ذي الصلة في إعدادات الحزمة.

إذا ضبطت هذه القيمة على false، لن تتمكّن من استخدام خادم وكيل لإعادة التوجيه.

conf_http_HTTPClient.use.tunneling

يستخدم Edge تلقائيًا الاتصال النفقي لجميع الزيارات. لإيقاف الاتصال النفقي تلقائيًا، اضبط هذه السمة على "خطأ".

use.proxy.host.header.with.target.uri

يتم ضبط المضيف والمنفذ المستهدفَين كعنوان Host. يتم تلقائيًا ضبط مضيف الخادم الوكيل والمنفذ كعناوين Host. يمكنك ضبط هذه السمة في "نقطة النهاية المستهدَفة" فقط. على سبيل المثال:

<HTTPTargetConnection>
    <Properties>
        <Property name="use.proxy.host.
         header.with.target.uri">true
        </Property>
    </Properties>
    <URL>https://mocktarget.apigee.net/
     my-target</URL>
</HTTPTargetConnection>
conf/http.properties+HTTPClient.proxy.type

تحدّد هذه السياسة نوع خادم وكيل HTTP على أنّه HTTP أو HTTPS. ويستخدم تلقائيًا "HTTP".

conf/http.properties+HTTPClient.proxy.host

يحدّد اسم المضيف أو عنوان IP الذي يعمل عليه خادم وكيل HTTP.

conf/http.properties+HTTPClient.proxy.port

تحدِّد هذه السياسة المنفذ الذي يعمل عليه خادم وكيل HTTP. في حال حذف هذه السمة، يتم استخدام المنفذ 80 لبروتوكول HTTP والمنفذ 443 لبروتوكول HTTPS تلقائيًا.

conf/http.properties+HTTPClient.proxy.user
conf/http.properties+HTTPClient.proxy.password

إذا كان وكيل HTTP يتطلّب مصادقة أساسية، استخدِم هذه السمات لتقديم تفاصيل التفويض.

على سبيل المثال:

conf_http_HTTPClient.use.proxy=true
conf_http_HTTPClient.use.tunneling=false
conf/http.properties+HTTPClient.proxy.type=HTTP
conf/http.properties+HTTPClient.proxy.host=my.host.com
conf/http.properties+HTTPClient.proxy.port=3128
conf/http.properties+HTTPClient.proxy.user=USERNAME
conf/http.properties+HTTPClient.proxy.password=PASSWORD

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

<Property name="use.proxy">false</Property>

لمزيد من المعلومات حول ضبط خصائص TargetEndpoint، بما في ذلك كيفية ضبط الاتصال بنقطة النهاية المستهدفة، يُرجى الاطّلاع على مرجع خصائص نقطة النهاية.

لإيقاف ميزة "الوكيل الأمامي" لجميع الأهداف تلقائيًا، اضبط السمة التالية في ملف message-processor.properties:

conf_http_HTTPClient.use.proxy=false

بعد ذلك، اضبط use.proxy على "true" لأي TargetEndpoint تريد أن يمرّ من خلال خادم وكيل HTTP لإعادة التوجيه:

<Property name="use.proxy">true</Property>

يستخدم Edge تلقائيًا الاتصال النفقي لزيارات الخادم الوكيل. لإيقاف ميزة "النفق" تلقائيًا، اضبط السمة التالية في ملف message-processor.properties:

conf_http_HTTPClient.use.tunneling=false

إذا أردت إيقاف الاتصال النفقي لهدف معيّن، اضبط السمة use.proxy.tunneling في TargetEndpoint. إذا كان الهدف يستخدم بروتوكول أمان طبقة النقل (TLS) أو طبقة المقابس الآمنة (SSL)، يتم تجاهل هذه السمة ويتم إرسال الرسالة دائمًا عبر نفق:

<Property name="use.proxy.tunneling">false</Property>

لكي يعمل Edge كخادم وكيل لإعادة التوجيه، أي يتلقّى الطلبات من خدمات الخلفية ويعيد توجيهها إلى الإنترنت خارج المؤسسة، عليك أولاً إعداد خادم وكيل لواجهة برمجة التطبيقات على Edge. يمكن لخدمة الخلفية بعد ذلك إرسال طلب إلى الخادم الوكيل لواجهة برمجة التطبيقات، والذي يمكنه بعد ذلك الاتصال بالخدمات الخارجية.