تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

ضبط إعدادات المضيفين الافتراضيين

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

ويمكن لعميل Cloud الذي يمتلك حسابًا مدفوعًا وجميع عملاء Edge for Private Cloud إنشاء مضيف افتراضي في المؤسسة. ويجب أن يكون المستخدم الذي ينشئ المضيف الافتراضي في دور مشرف المؤسسة أو في دور مخصص لديه أذونات لتعديل المضيف الافتراضي. وليس لدى المستخدمين في أدوار أخرى الإذن بإنشاء مضيفات افتراضية.

ملاحظة: يتطلب إنشاء مضيفات افتراضية لبرنامج Edge للسحابة الإلكترونية تفعيل بروتوكول أمان طبقة النقل (TLS). يجب أيضًا الحصول على شهادة موقَّعة من جهة موثوق بها، مثل Symantec أو VeriSign. إذا كان لديك حساب مدفوع على Edge على Cloud ولم تحصل على شهادة ومفتاح TLS حتى الآن، يمكنك إنشاء مضيف افتراضي يستخدم شهادة ومفتاح الفترة التجريبية المجانية من Apigee. لا يمكنك استخدام شهادة موقَّعة ذاتيًا أو الشهادات التفصيلية الموقَّعة من مرجع تصديق موقَّع ذاتيًا. للحصول على معلومات عن بروتوكول أمان طبقة النقل (TLS)، راجِع بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة.

مشاهدة مقدمة فيديو عن المضيفين الافتراضيين.

إنشاء مضيف افتراضي

استخدم الإجراء الأساسي التالي لإنشاء المضيف الظاهري. يستند الإجراء الفعلي الذي تستخدمه إلى ما إذا كنت عميل Cloud أو Private Cloud، وما إذا كنت تفعّل بروتوكول أمان طبقة النقل (TLS):

أنشئ إدخال نظام أسماء النطاقات وسجلّ CNAME لنطاقك المتاح للجميع.
ملاحظة: يمكن لعملاء Private Cloud إنشاء مضيف افتراضي من عنوان IP، بدون إدخال نظام أسماء النطاقات وسجلّ CNAME. راجع ضبط الأجهزة المضيفة الافتراضية للسحابة الإلكترونية الخاصة لمزيد من المعلومات.
في حال تفعيل بروتوكول أمان طبقة النقل (TLS) على المضيف الظاهري:

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

أنشِئ المضيف الافتراضي باستخدام واجهة برمجة التطبيقات Create a Virtual Host (إنشاء مضيف افتراضي). في حال تفعيل بروتوكول أمان طبقة النقل (TLS)، احرص على تحديد مرجع ملف تخزين المفاتيح الصحيح ومرجع ملف تخزين الثقة والعنوان البديل للمفتاح.
إذا كانت لديك أي خوادم وكيلة حالية لواجهة برمجة التطبيقات، أضِف المضيف الظاهري إلى ProxyEndpoint. تتم إضافة المضيف الظاهري تلقائيًا إلى جميع الخوادم الوكيلة الجديدة لواجهة برمجة التطبيقات. راجِع ضبط خادم وكيل لواجهة برمجة التطبيقات لاستخدام مضيف افتراضي.

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

بعد تحديث الخادم الوكيل لواجهة برمجة التطبيقات لاستخدام المضيف الظاهري وإنشاء إدخال نظام أسماء النطاقات وسجلّ CNAME للاسم المستعار للمضيف، يمكنك الوصول إلى الخادم الوكيل لواجهة برمجة التطبيقات كما هو موضّح أدناه:

https://api.myCompany.com/v1/project-base-path/resource-path

مثال:

https://api.myCompany.com/v1/weather/forecastrss?w=12797282

إنشاء مضيف افتراضي باستخدام واجهة برمجة التطبيقات أو واجهة المستخدم

يمكنك إنشاء مضيف افتراضي باستخدام واجهة برمجة تطبيقات Edge أو واجهة مستخدم Edge.

تستخدم معظم الأمثلة أدناه واجهة برمجة تطبيقات Edge. للوصول إلى واجهة المستخدم لإنشاء مضيفات افتراضية وتعديلها وحذفها في واجهة مستخدم Edge:

سجِّل الدخول إلى apigee.com/edge
يستخدم عملاء Edge في Private Cloud ميزة http://ms-ip:9000 (داخل المؤسسة)، حيث يشير ms-ip إلى عنوان IP أو اسم نظام أسماء النطاقات الخاص بعقدة خادم الإدارة.
حدد المشرف > المضيفون الافتراضيون في شريط التنقل الأيمن.
اختَر البيئة، مثل prod أو test.
يتم عرض المضيفين الافتراضيين المحدّدين للبيئة.
اختَر + المضيف الافتراضي لإنشاء مضيف افتراضي أو اختَر اسم المضيف الظاهري الحالي لتعديله.

إنشاء مضيف افتراضي لبروتوكول HTTP

يمكن لعملاء Edge الخاص بعملاء Private Cloud إنشاء مضيف افتراضي باستخدام HTTP.

لإنشاء مضيف افتراضي لا يتوافق مع بروتوكول أمان طبقة النقل (TLS)، أنشِئ كائن XML يحدّد المضيف الافتراضي. على سبيل المثال، يحدّد كائن XML التالي مضيفًا افتراضيًا يستخدم بروتوكول HTTP:

<VirtualHost name="myVHost">
   <HostAliases>
     <HostAlias>api.myCompany.com</HostAlias>
   </HostAliases>
   <Interfaces/>
   <Port>80</Port>
</VirtualHost>

في هذا التعريف:

حدِّد الاسم على أنّه myVHost. ويمكنك استخدام الاسم للإشارة إلى المضيف الافتراضي في خادم وكيل لواجهة برمجة التطبيقات أو في طلب بيانات من واجهة برمجة التطبيقات.
حدِّد الاسم المستعار للمضيف على أنّه api.myCompany.com. هذا هو النطاق المتاح للجميع الذي يُستخدم للوصول إلى واجهات برمجة التطبيقات كما هو محدّد في تعريف نظام أسماء النطاقات وسجلّ CNAME.
حدِّد رقم المنفذ على أنّه 80. في حال حذف المنفذ، يتم ضبط المنفذ تلقائيًا على 443.
تتوفّر خصائص إضافية يمكنك ضبطها في المضيف الظاهري. للحصول على مرجع لجميع المواقع، راجِع مرجع موقع المضيف الافتراضي.

إذا كانت لديك أي خوادم وكيلة حالية لواجهة برمجة التطبيقات، أضِف المضيف الافتراضي إلى العنصر <HTTPConnection> في "نقطة نهاية الخادم الوكيل". تتم إضافة المضيف الظاهري تلقائيًا إلى جميع الخوادم الوكيلة الجديدة لواجهة برمجة التطبيقات. راجِع ضبط خادم وكيل لواجهة برمجة التطبيقات لاستخدام مضيف افتراضي. إذا أنشأت خادمًا وكيلاً جديدًا لواجهة برمجة التطبيقات يجب ألا يكون من الممكن الوصول إليه من خلال مضيف افتراضي معيّن، عليك تعديل الخادم الوكيل لواجهة برمجة التطبيقات لإزالة هذا المضيف الافتراضي من ProxyEndpoint لديه.

يمكنك بعد ذلك الوصول إلى خادم وكيل لواجهة برمجة التطبيقات من خلال هذا المضيف الظاهري عن طريق تقديم طلب إلى:

http://api.myCompany.com/proxy-base-path/resource-path
https://api.myCompany.com/proxy-base-path/resource-path

يمكنك إنشاء المضيف الافتراضي باستخدام واجهة برمجة التطبيقات Create a Virtual Host (إنشاء مضيف افتراضي):

curl -X POST -H "Content-Type:application/xml" \
  http://ms-IP:8080/v1/o/org_name/environments/env_name/virtualhosts \
  -d '<VirtualHost name="myVHost">
        <HostAliases>
            <HostAlias>api.myCompany.com</HostAlias>
        </HostAliases>
        <Interfaces/>
        <Port>80</Port>
    </VirtualHost>' \
  -u sysAdminEmail:password

ملاحظة: في Edge لـ Private Cloud، يتم إجراء طلبات بيانات من واجهة برمجة التطبيقات إلى اسم النطاق ms-ip:8080 حيث ms-ip هو عنوان IP لخادم إدارة Edge. يمكن لعملاء Edge تقديم طلباتهم إلى النطاق api.enterprise.apigee.com.

إنشاء مضيف افتراضي لبروتوكول أمان طبقة النقل (TLS) الأحادي الاتجاه

ويحدِّد كائن XML التالي مضيفًا افتراضيًا لبروتوكول أمان طبقة النقل (TLS) الأحادي الاتجاه:

<VirtualHost name="myTLSVHost">
    <HostAliases>
        <HostAlias>api.myCompany.com</HostAlias>
    </HostAliases>
    <Port>443</Port>
    <SSLInfo>
        <Enabled>true</Enabled>
        <ClientAuthEnabled>false</ClientAuthEnabled>
        <KeyStore>ref://myTestKeystoreRef</KeyStore>
        <KeyAlias>myKeyAlias</KeyAlias>
    </SSLInfo>
</VirtualHost>

في هذا التعريف، يتم تفعيل بروتوكول أمان طبقة النقل (TLS) من خلال ضبط العنصر <Enable> على "صحيح" واستخدام العنصرَين <KeyStore> و<KeyAliase> لتحديد ملف تخزين المفاتيح والاسم المستعار للمفتاح الذي يستخدمه اتصال بروتوكول أمان طبقة النقل.

ملاحظة: بما أنّ Edge متوافق في الأصل مع طبقة المقابس الآمنة (SSL)، فإنّ العلامة التي تستخدمها لضبط بروتوكول أمان طبقة النقل (TLS) تُسمّى <SSLInfo>.

راجِع بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة للاطّلاع على المزيد من المعلومات عن استخدام بروتوكول أمان طبقة النقل (TLS).

تحديد كيفية تحديد اسم ملف تخزين المفاتيح واسم ملف الثقة في المضيف الافتراضي

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

    <SSLInfo>
        <Enabled>true</Enabled>
        <ClientAuthEnabled>false</ClientAuthEnabled>
        <KeyStore>ref://myTestKeystoreRef</KeyStore>
        <KeyAlias>myKeyAlias</KeyAlias>
    </SSLInfo>

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

يمكنك استخدام مرجع إلى ملف تخزين المفاتيح ومخزن مفاتيح الثقة فقط، ولا يمكنك استخدام مرجع إلى الاسم المستعار. عند تغيير المرجع إلى ملف تخزين، تأكّد من أنّ الاسم المستعار للشهادة هو الاسم نفسه المستخدَم في ملف تخزين المفاتيح القديم.

قيود استخدام الإشارات إلى ملفات تخزين المفاتيح والمخزن الموثوق

يجب مراعاة القيود التالية عند استخدام مراجع لملفات تخزين المفاتيح ومخازن الثقة:

لا يمكنك استخدام مراجع ملف تخزين المفاتيح ومتجر الثقة إلا في الأجهزة المضيفة الافتراضية إذا كنت توفّر إشارة اسم الخادم (SNI) وألغيت طبقة المقابس الآمنة على أجهزة توجيه Apigee.
إذا كان لديك جهاز موازنة حمولة أمام أجهزة توجيه Apigee وأغلقت بروتوكول أمان طبقة النقل (TLS) على جهاز موازنة التحميل، لن تتمكّن من استخدام مراجع ملف تخزين المفاتيح وملف Truststore في الأجهزة المضيفة الافتراضية.

إنشاء مضيف افتراضي لبروتوكول أمان طبقة النقل (TLS) ثنائي الاتجاه

لتفعيل بروتوكول أمان طبقة النقل (TLS) الثنائي، يجب ضبط العنصر <ClientAuthEnabled> على true، وتحديد متجر ثقة باستخدام مرجع مع العنصر <TrustStore>. يحتفظ Truststore بجهة إصدار شهادة العميل وسلسلة مرجع التصديق (CA) الخاصة بالشهادة، وهي مطلوبة. يجب أيضًا ضبط البرنامج بشكلٍ صحيح من أجل بروتوكول أمان طبقة النقل (TLS) الثنائي الاتجاه.

لإنشاء مضيف افتراضي لبروتوكول أمان طبقة النقل (TLS) ثنائي الاتجاه، أنشِئ كائن XML يحدد المضيف الافتراضي:

<VirtualHost name="myTLSVHost">
    <HostAliases>
        <HostAlias>api.myCompany.com</HostAlias>
    </HostAliases>
    <Port>443</Port>
    <SSLInfo>
        <Enabled>true</Enabled>
        <ClientAuthEnabled>true</ClientAuthEnabled>
        <KeyStore>ref://myTestKeystoreRef</KeyStore>
        <KeyAlias>myKeyAlias</KeyAlias>
        <TrustStore>ref://myTestTruststoreRef</TrustStore>
    </SSLInfo>
</VirtualHost>

في هذا التعريف:

فعِّل بروتوكول أمان طبقة النقل (TLS) الثنائي من خلال ضبط <ClientAuthEnabled> على "صحيح".
حدِّد المرجع إلى متجر Truststore باستخدام العنصر <TrustStore>. يحتفظ Truststore بجهة إصدار شهادة العميل وسلسلة مرجع التصديق (CA) الخاصة بالشهادة، وهي مطلوبة.

تعديل مضيف افتراضي

يمكن لعميل Cloud الذي لديه حساب مدفوع وجميع عملاء Edge for Private Cloud استخدام تحديث واجهة برمجة التطبيقات Virtual Host لتعديل المضيف الافتراضي. تتيح لك واجهة برمجة التطبيقات هذه إعداد جميع السمات للمضيف الافتراضي الموضح في مرجع موقع المضيف الافتراضي.

عدِّل المضيف الافتراضي باستخدام واجهة برمجة التطبيقات Update a Virtual Host (تحديث المضيف الافتراضي). وعند استخدام واجهة برمجة التطبيقات، عليك تحديد التعريف الكامل للمضيف الافتراضي في نص الطلب، وليس فقط العناصر التي تريد تغييرها.

في هذا المثال، يمكنك ضبط قيمة السمة proxy_read_timeout:

curl -X PUT -H "Content-Type:application/xml" \
    https://api.enterprise.apigee.com/v1/o/org_name/e/env_name/virtualhosts/vhost_name \
    -d '<VirtualHost  name="myTLSVHost">
         <HostAliases>
           <HostAlias>api.myCompany.com</HostAlias>
         </HostAliases>
         <Port>443</Port>
         <SSLInfo>
           <Enabled>true</Enabled>
           <ClientAuthEnabled>false</ClientAuthEnabled>
           <KeyStore>ref://myTestKeystoreRef</KeyStore>
           <KeyAlias>myKeyAlias</KeyAlias>
         </SSLInfo>
         <Properties>
           <Property name="proxy_read_timeout">50</Property>
         </Properties>
     </VirtualHost>' \
    -u orgAdminEmail:password

حذف المضيف الظاهري

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

يمكنك حذف المضيف الافتراضي باستخدام واجهة برمجة التطبيقات Delete a Virtual Host (حذف المضيف الافتراضي):

curl -X DELETE \
  https://api.enterprise.apigee.com/v1/o/org_name/e/env_name/virtualhosts/vhost_name \
  -u orgAdminEmail:password

عرض معلومات حول المضيف الظاهري

عرض معلومات حول المضيفات الظاهرية المحددة في بيئة، كما هو موضح أدناه.

Edge

لعرض معلومات حول المضيف الظاهري باستخدام واجهة مستخدم Edge:

سجِّل الدخول إلى apigee.com/edge.
يستخدم عملاء Edge في Private Cloud ميزة http://ms-ip:9000 (داخل المؤسسة)، حيث يشير ms-ip إلى عنوان IP أو اسم نظام أسماء النطاقات الخاص بعقدة خادم الإدارة.
حدد المشرف > المضيفون الافتراضيون في شريط التنقل الأيمن.
اختَر البيئة، مثل prod أو test.
ستظهر المضيفين الافتراضيين المحدّدين للبيئة. إذا تم إعداد المضيف الافتراضي لاستخدام ملف تخزين مفاتيح أو ملف موثوق به، انقر على إظهار للاطّلاع على المزيد من المعلومات.

في حال ضبط المضيف الافتراضي لاستخدام بروتوكول أمان طبقة النقل أو طبقة المقابس الآمنة، سيظهر رمز قفل بجانب اسم المضيف الظاهري. وهذا يعني أنه تم تحميل شهادة TLS/SSL والمفتاح وسلسلة الشهادات على Edge وربطها بالمضيف الافتراضي. للاطّلاع على معلومات حول الشهادات المتاحة:

اختَر المشرف > البيئة > ملفات تخزين مفاتيح بروتوكول أمان طبقة النقل (TLS) في شريط التنقّل الأيمن.
اختَر البيئة (عادةً prod أو test).
وسِّع ملفات تخزين المفاتيح لعرض الشهادة.

كلاسيكي Edge (السحابة الإلكترونية الخاصة)

لعرض معلومات حول المضيف الظاهري باستخدام واجهة مستخدم الإصدار الكلاسيكي من Edge:

سجِّل الدخول إلى http://ms-ip:9000، حيث يشير ms-ip إلى عنوان IP أو اسم نظام أسماء النطاقات لعقدة خادم الإدارة.
حدد المشرف > المضيفون الافتراضيون في شريط التنقل الأيمن.
اختَر البيئة، مثل prod أو test.
انقر على علامة التبويب المضيفون الافتراضيون.
ستظهر المضيفين الافتراضيين المحدّدين للبيئة. إذا تم إعداد المضيف الافتراضي لاستخدام ملف تخزين مفاتيح أو ملف موثوق به، انقر على إظهار للاطّلاع على المزيد من المعلومات.

اختَر المشرف > شهادات TLS في شريط التنقّل العلوي.
اختَر البيئة (عادةً prod أو test).
وسِّع ملفات تخزين المفاتيح لعرض الشهادة.

عرض مضيف افتراضي باستخدام Edge API

يمكنك أيضًا استخدام واجهات برمجة تطبيقات Edge لعرض معلومات حول المضيفين الظاهرين. على سبيل المثال، تعرض واجهة برمجة التطبيقات List Virtual Hosts قائمة بجميع المضيفات الافتراضية:

curl -X GET -H "accept:application/xml" \
    https://api.enterprise.apigee.com/v1/o/org_name/environments/env_name/virtualhosts \
    -u orgAdminEmail:pWord

حيث يكون orgAdminEmail:pWord هو اسم المستخدم وكلمة المرور لمشرف المؤسسة، وorg_name/env_name يحدّدان المؤسسة والبيئة اللتين تحتويان على المضيف الافتراضي. نموذج الإجابة:

[
 "default",
 "secure"
]

للاطّلاع على معلومات حول مضيف افتراضي معيّن، استخدِم واجهة برمجة تطبيقات Get Virtual Host:

curl -X GET -H "accept:application/xml" \
    https://api.enterprise.apigee.com/v1/o/org_name/environments/env_name/virtualhosts/vhost_name \
    -u orgAdminEmail:pWord

حيث يكون vhost_name هو اسم المضيف الافتراضي. على سبيل المثال، يمكنك تحديد vhost_name على أنّه "آمن" للاطّلاع على إعدادات المضيف الافتراضي الآمن التلقائي الذي أنشأته Apigee:

<VirtualHost name="secure">
    <HostAliases>
        <HostAlias>api.myCompany.com</HostAlias>
    </HostAliases>
    <Port>443</Port>
    <Properties/>
    <Interfaces/>
    <RetryOptions/>
    <SSLInfo>
        <ClientAuthEnabled>false</ClientAuthEnabled>
        <Enabled>true</Enabled>
        <KeyAlias>freetrial</KeyAlias>
        <KeyStore>ref://freetrial</KeyStore>
        <IgnoreValidationErrors>false</IgnoreValidationErrors>
    </SSLInfo>
</VirtualHost>

ملاحظة: في Edge لـ Private Cloud، يمكنك استبدال اسم النطاق api.enterprise.apigee.com بـ ms-ip:8080 حيث ms-ip هو عنوان IP لخادم إدارة Edge.

جارٍ إعداد خادم وكيل لواجهة برمجة التطبيقات لاستخدام مضيف افتراضي

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

https://host-alias/proxy-base-path/resource-path

المكان:

يكون host-alias عادةً اسم نظام أسماء النطاقات للمضيف الظاهري.
يتم تحديد proxy-base-path عند إنشاء خادم وكيل لواجهة برمجة التطبيقات، ويكون فريدًا لكل خادم وكيل لواجهة برمجة التطبيقات.
resource-path المسار إلى مورد يمكن الوصول إليه من خلال الخادم الوكيل لواجهة برمجة التطبيقات.

التحكم في المضيفات الافتراضية التي يستخدمها الخادم الوكيل لواجهة برمجة التطبيقات

في إعدادات XML للخادم الوكيل لواجهة برمجة التطبيقات، يمكنك استخدام العلامة virtualhost لتحديد اسم المضيف الافتراضي المرتبط بالخادم الوكيل لواجهة برمجة التطبيقات:

<HTTPProxyConnection>
  <BasePath>/v1/my/proxy/basepath</BasePath>
  <VirtualHost>secure</VirtualHost>
  <VirtualHost>default</VirtualHost>
</HTTPProxyConnection>

على سبيل المثال، تعني السمة <VirtualHost>secure</VirtualHost> أنّه يمكن للعميل الاتصال بالخادم الوكيل لواجهة برمجة التطبيقات باستخدام الاسم المستعار للمضيف الخاص بالمضيف الافتراضي "الآمن".

يمكنك عادةً تعديل المضيفات الافتراضية المرتبطة بالخادم الوكيل لواجهة برمجة التطبيقات في الحالات التالية:

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

لتعديل المضيفات الافتراضية المرتبطة بالخادم الوكيل لواجهة برمجة التطبيقات:

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

للوصول إلى محرِّر الخادم الوكيل لواجهة برمجة التطبيقات باستخدام واجهة مستخدم Edge:
1. سجِّل الدخول إلى apigee.com/edge.
  يستخدم عملاء Edge في Private Cloud ميزة http://ms-ip:9000 (داخل المؤسسة)، حيث يشير ms-ip إلى عنوان IP أو اسم نظام أسماء النطاقات الخاص بعقدة خادم الإدارة.
2. حدّد التطوير > الخوادم الوكيلة لواجهة برمجة التطبيقات في شريط التنقل الأيمن.
3. اختر الخادم الوكيل لواجهة برمجة التطبيقات الذي تريد تعديله في القائمة.
كلاسيكي Edge (السحابة الإلكترونية الخاصة)

ملاحظة: تتوفّر واجهة مستخدم الإصدار الكلاسيكي من Edge مع Edge لـ Private Cloud فقط.

للوصول إلى محرِّر الخادم الوكيل لواجهة برمجة التطبيقات باستخدام واجهة مستخدم الإصدار الكلاسيكي من Edge:
1. سجِّل الدخول إلى http://ms-ip:9000، حيث يشير ms-ip إلى عنوان IP أو اسم نظام أسماء النطاقات لعقدة خادم الإدارة.
2. حدد واجهات برمجة التطبيقات > الخوادم الوكيلة لواجهة برمجة التطبيقات في شريط التنقل العلوي.
3. اختر الخادم الوكيل لواجهة برمجة التطبيقات الذي تريد تعديله في القائمة.
انقر على علامة التبويب التطوير.
ضمن نقاط نهاية الخادم الوكيل، اختَر تلقائي.
في منطقة الرمز:
1. عليك إزالة أي عناصر <VirtualHost> للمضيفات الافتراضية غير المتوافقة مع الخادم الوكيل لواجهة برمجة التطبيقات.
2. أضِف عنصر <VirtualHost> جديدًا باسم المضيف الافتراضي الجديد. على سبيل المثال، إذا كان اسم المضيف الافتراضي الجديد باسم MyVirtualHost، أضِف العلامة التالية:
```
<HTTPProxyConnection>
  <BasePath>/v1/my/proxy/basepath</BasePath>
  <VirtualHost>default</VirtualHost>
  <VirtualHost>secure</VirtualHost>
  <VirtualHost>MyVirtualHost</VirtualHost>
</HTTPProxyConnection>
```
احفظ الخادم الوكيل لواجهة برمجة التطبيقات. في حال تفعيل الخادم الوكيل لواجهة برمجة التطبيقات، سيؤدي حفظه إلى إعادة نشره باستخدام الإعداد الجديد.

يتم الآن ضبط عنوان URL الأساسي المعروض من خلال واجهة مستخدم Edge لخادم وكيل لواجهة برمجة التطبيقات.

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

في معظم الحالات، يكون عنوان URL المعروض في واجهة مستخدم Edge هو عنوان URL الصحيح لإجراء الطلبات الخارجية إلى الخادم الوكيل. عنوان URL المعروض غير صحيح لبعض الإعدادات. على سبيل المثال، يمكن أن تتسبب أي من عمليات الضبط التالية في عدم توافق عنوان URL المعروض المعروض مع عنوان URL الفعلي المستخدَم في إجراء طلبات خارجية إلى الخادم الوكيل:

يحدث إنهاء طبقة المقابس الآمنة (SSL) في موازن تحميل
يحدث تعيين المنفذ بين جهاز موازنة الحمل وأجهزة توجيه Apigee.
جهاز لموازنة الحمل تم إعداده مع إعادة كتابة المسار

يتيح Edge سمة على المضيف الافتراضي المسماة <BaseUrl> والتي تتيح لك إلغاء عنوان URL الذي تعرضه واجهة مستخدم Edge. في ما يلي مثال يعرض كائن المضيف الافتراضي مع السمة <BaseUrl>. في هذا المثال، تظهر القيمة "http://myCo.com" في واجهة مستخدم Edge:

<VirtualHost name="myTLSVHost">
  <HostAliases>
    <HostAlias>api.myCompany.com</HostAlias>
  </HostAliases>
  <BaseUrl>http://myCo.com</BaseUrl>
  <Port>443</Port>
  <SSLInfo>
    <Enabled>true</Enabled>
    <ClientAuthEnabled>false</ClientAuthEnabled>
    <KeyStore>ref://myTestKeystoreRef</KeyStore>
    <KeyAlias>myKeyAlias</KeyAlias>
  </SSLInfo>
</VirtualHost>

يُرجى العِلم أنّ قيمة <BaseUrl> يجب أن تتضمّن البروتوكول (أي "http://" أو "https://").

إذا لم يتم ضبط <BaseUrl>، سيظهر عنوان URL التلقائي المعروض من خلال واجهة مستخدم Edge على النحو التالي: "api.myCompany.com"، في حين سيكون الاسم المستعار للمضيف الفعلي هو "http://myCo.com".