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

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

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

يمكنك مشاهدة مقدمة فيديو حول خدمات الاستضافة الافتراضية.

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

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

  1. أنشئ إدخال نظام أسماء نطاقات وسجل CNAME لنطاقك الذي يُعرض بشكل علني.
  2. في حال تفعيل بروتوكول أمان طبقة النقل (TLS) على المضيف الظاهري:
    1. يمكنك إنشاء ملف تخزين مفاتيح وإعداده باستخدام الإجراء الموضح هنا: محفظات المفاتيح والمستودعات الموثوقة:
    2. حمّل شهادتك ومفتاحك إلى ملف تخزين المفاتيح. تأكد من أن اسم النطاق الذي تحدده cert مع اسم المضيف المستعار الذي تريد استخدامه للمضيف الظاهري.
    3. أنشئ مرجعًا لملف تخزين المفاتيح باستخدام واجهة مستخدم أو واجهة برمجة تطبيقات Edge. المرجع تُحدِّد اسم ملف تخزين المفاتيح ونوع المرجع كـ KeyStore. عرض العمل مع المراجع لـ المزيد حول إنشاء المراجع وتعديلها.
    4. فإذا كنت تنفذ بروتوكول أمان طبقة النقل باتجاهين، فأنشئ مخزنًا موثوقًا به، وحمّل الشهادة، وأنشئ مرجعًا للمخزن الموثوق. إنشاء Truststore باستخدام الإجراء الموضّح هنا: محفظات المفاتيح والمستودعات الموثوقة.
  3. أنشئ المضيف الظاهري باستخدام إنشاء Virtual Host API. عند تمكين بروتوكول أمان طبقة النقل (TLS)، تأكد من تحديد مرجع ملف تخزين المفاتيح الصحيح، ومرجع تخزين الثقة والاسم المستعار للمفتاح.
  4. إذا كان لديك أي خوادم وكيلة حالية لواجهة برمجة التطبيقات، أضِف المضيف الافتراضي إلى 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:

  1. سجِّل الدخول إلى apigee.com/edge

    يستخدم عملاء Edge for Private Cloud http://ms-ip:9000 (داخل الشركة)، حيث ms-ip هو عنوان IP أو اسم نظام أسماء النطاقات لعقدة خادم الإدارة.

  2. اختَر المشرف > المضيفات الافتراضية في شريط التنقّل الأيمن.
  3. اختَر البيئة، مثل prod أو test.
    النسخة الافتراضية يتم عرض المضيفات المحددة للبيئة.
  4. حدد + مضيف افتراضي لإنشاء مضيف افتراضي أو حدد اسم مضيف المضيف الظاهري الحالي لتعديله.

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

يمكن لعملاء Edge for 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>. في نقطة نهاية الخادم الوكيل. تتم إضافة المضيف الظاهري تلقائيًا إلى جميع الخوادم الوكيلة الجديدة لواجهة برمجة التطبيقات. راجِع إعداد خادم وكيل لواجهة برمجة التطبيقات لاستخدام مضيف افتراضي. إذا أنشأت خادمًا وكيلاً جديدًا لواجهة برمجة التطبيقات يجب ألا يكون متاحًا عبر مضيف ظاهري معين، يجب عليك تعديل الخادم الوكيل لواجهة برمجة التطبيقات لإزالة ذلك المضيف الافتراضي من نقطة نهاية الخادم الوكيل.

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

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

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

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
.

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

يمكنك الاطّلاع على TLS/SSL لمزيد من المعلومات معلومات حول استخدام بروتوكول أمان طبقة النقل.

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

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

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

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

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

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

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

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

إنشاء مضيف افتراضي لبروتوكول أمان طبقة النقل (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) الخاصة بالشهادة، وهو أمر مطلوب.

يمكنك الاطّلاع على TLS/SSL لمعرفة المزيد معلومات حول استخدام بروتوكول أمان طبقة النقل.

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

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

تحديث المضيف الظاهري باستخدام تحديث واجهة برمجة تطبيقات المضيف الافتراضي عند استخدام واجهة برمجة التطبيقات، يجب عليك تحديد التعريف الكامل المضيف الافتراضي في نص الطلب، وليس فقط في العناصر التي تريد تغييرها.

في هذا المثال، يمكنك ضبط قيمة السمة 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

حذف مضيف افتراضي

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

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

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

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

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

Edge

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

  1. سجِّل الدخول إلى apigee.com/edge.

    يستخدم عملاء Edge for Private Cloud http://ms-ip:9000 (داخل الشركة)، حيث ms-ip هو عنوان IP أو اسم نظام أسماء النطاقات لعقدة خادم الإدارة.

  2. اختَر المشرف >. المضيفات الافتراضية في شريط التنقل الأيمن.
  3. اختَر البيئة، مثل prod أو test.

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

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

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

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

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

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

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

    تعرض علامة التبويب &quot;المضيفات الافتراضية&quot; معلومات عن الاسم والمنفذ
                 والاسم المستعار والمزيد.

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

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

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

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

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"
]

للاطلاع على معلومات حول مضيف ظاهري معين، استخدم الحصول على واجهة برمجة تطبيقات 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 تلقائيًا على استخدام جميع التطبيقات الافتراضية المتاحة المضيفين في المؤسسة. يستخدم الطلب المُرسَل إلى خادم وكيل لواجهة برمجة التطبيقات من خلال مضيف افتراضي النموذج التالي:

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> يمكن للعميل استدعاء الخادم الوكيل لواجهة برمجة التطبيقات باستخدام الاسم المستعار للمضيف "الآمن" المضيف الظاهري.

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

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

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

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

    Edge

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

    1. سجِّل الدخول إلى apigee.com/edge.

      يستخدم عملاء Edge for Private Cloud http://ms-ip:9000 (داخل الشركة)، حيث ms-ip هو عنوان IP أو اسم نظام أسماء النطاقات لعقدة خادم الإدارة.

    2. اختَر التطوير > الخوادم الوكيلة لواجهة برمجة التطبيقات في شريط التنقل الأيمن.
    3. اختَر الخادم الوكيل لواجهة برمجة التطبيقات الذي تريد تعديله في القائمة.

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

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

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

إعداد عنوان 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".