ضبط إعدادات المضيفين الافتراضيين لخدمة السحابة الإلكترونية الخاصة

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

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

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

مزيد من المعلومات:

• لمحة عن الأجهزة المضيفة الافتراضية
• ضبط المضيفين الظاهريين
• ضبط طبقة النقل الآمنة (TLS)
• مخازن المفاتيح ومخازن الثقة
• ضبط بروتوكول أمان طبقة النقل (TLS) للوصول إلى واجهة برمجة تطبيقات "سحابة خاصة"

لمحة عن الأسماء المستعارة للمضيف

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

يقارن جهاز Edge Router رأس Host للطلب الوافد مع قائمة الأسماء البديلة للمضيفين المتاحة كجزء من تحديد خادم وكيل واجهة برمجة التطبيقات الذي يعالج الطلب. عند تقديم طلب من خلال مضيف افتراضي، حدِّد اسم نطاق يتطابق مع الاسم المستعار للمضيف للمضيف الافتراضي، أو حدِّد عنوان IP لجهاز التوجيه وعنوان Host الذي يحتوي على الاسم المستعار للمضيف.

على سبيل المثال، إذا أنشأت مضيفًا افتراضيًا باستخدام اسم مضيف بديل وهو myapis.apigee.net على المنفذ 9001، يمكن أن يستخدم طلب cURL إلى واجهة برمجة تطبيقات من خلال ذلك المضيف الظاهري أحد النماذج التالية:

• إذا كان لديك إدخال نظام أسماء النطاقات myapis.apigee.net:

  curl http://myapis.apigee.net:9001/proxy-base-path/resource-path

• إذا لم يكن لديك إدخال نظام أسماء النطاقات myapis.apigee.net:

  curl http://routerIP:9001/proxy-base-path/resource-path -H 'host:myapis.apigee.net'

  في هذا النموذج، يمكنك تحديد عنوان IP للموجه وضبط الاسم المعرِّف للمضيف في الرأس Host.

  curl http://routerIP:9001/proxy-base-path/resource-path

الخيارات في حال عدم توفُّر إدخال نظام أسماء نطاقات للمضيف الافتراضي

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

192.168.1.31:9001

عند إنشاء أمر curl في النموذج أدناه:

curl http://routerIP:9001/proxy-base-path/resource-path

هذا الخيار مُفضل لأنه يعمل بشكل جيد مع واجهة مستخدم Edge.

إذا كان لديك عدة أجهزة توجيه، أضِف عنوانًا بديلاً للمضيف لكل جهاز توجيه، مع تحديد عنوان IP لكل جهاز توجيه ومنفذ المضيف الافتراضي.

بدلاً من ذلك، يمكنك ضبط الاسم المعرِّف للمضيف على قيمة، مثل temp.hostalias.com. بعد ذلك، عليك تمرير العنوان Host في كل طلب:

curl -v http://routerIP:9001/proxy-base-path/resource-path -H 'Host: temp.hostalias.com'

أو أضف اسم المضيف المستعار إلى ملف /etc/hosts لديك. على سبيل المثال، أضِف هذا السطر إلى /etc/hosts:

192.168.1.31 temp.hostalias.com

بعد ذلك يمكنك تقديم طلب كما لو كان لديك إدخال DNS:

curl -v http://myapis.apigee.net:9001/proxy-base-path/resource-path

لمحة عن منافذ المضيف الافتراضي على Edge في الإصدار Private Cloud 4.16.01 والإصدارات الأحدث

عند إنشاء مضيف افتراضي، يمكنك تحديد منفذ جهاز التوجيه الذي يستخدمه المضيف الظاهري. على سبيل المثال، المنفذ 9001.

بالنسبة إلى إصدارات Apigee for Private Cloud 4.16.01 والإصدارات الأحدث، يتم تشغيل "جهاز التوجيه" تلقائيًا باستخدام حساب المستخدم "apigee" الذي لا يمكنه الوصول إلى المنافذ المميّزة، عادةً المنافذ 1024 والإصدارات الأقدم. إذا أردت إنشاء مضيف افتراضي يربط جهاز التوجيه بمنفذ محمي، يجب ضبط جهاز التوجيه ليعمل كمستخدم لديه إذن الوصول إلى هذه المنافذ. راجع إعداد مضيف افتراضي للتعرّف على مزيد من المعلومات.

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

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

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

إنشاء مضيف افتراضي باستخدام متصفّح

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

لإنشاء مضيف افتراضي جديد في واجهة مستخدم Edge:

1. سجِّل الدخول إلى واجهة مستخدم إدارة Edge.
2. اختَر المشرف > المضيفون الظاهريون.

3. اختَر البيئة من القائمة المنسدلة.

   يعرض Edge قائمة بالمضيفين الظاهريين لهذه البيئة.

4. لإنشاء مضيف افتراضي جديد، اختَر + مضيف افتراضي.

   تعرض Edge نموذج إنشاء مضيف افتراضي.

   يمكنك أيضًا النقر على اسم مضيف ظاهري حالي لتعديله.

5. حدِّد المضيف الافتراضي الجديد. يُرجى العِلم أنّ حقل عنوان URL الأساسي يجب أن يتضمّن بروتوكول (أي إضافة "http://" أو "https://" إلى قيمة الحقل).

   إضافةً إلى ذلك، يُرجى ملاحظة ما يلي:

   • ما مِن حدّ أقصى لعدد المضيفين الظاهريين الذين يمكنك إنشاؤهم.
   • طبقة النقل الآمنة (TLS) اختيارية، ويمكن أن تكون من الإصدار 1.0 أو 1.1 أو 1.2.
   • منفذ المضيف الظاهري قابل للضبط
6. انقر على الزر إنشاء لحفظ المضيف الظاهري الجديد.

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

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

<VirtualHost name="myVHost">
   <HostAliases>
     <HostAlias>DNS_name_or_IP:port</HostAlias>
   </HostAliases>
   <Interfaces/>
   <Port>9005</Port>
</VirtualHost>

يُرجى ملاحظة أنّ المضيف الافتراضي يحتوي على سمة name. يمكنك استخدام قيمة السمة name لضبط خادم وكيل لواجهة برمجة التطبيقات لاستخدام المضيف الافتراضي.

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

http://routerIP:port/proxy-base-path/resource-path
https://routerIP:port/proxy-base-path/resource-path

المكان:

• http أو https: إذا تم ضبط المضيف الافتراضي ليعمل على تفعيل بروتوكول أمان طبقة النقل (TLS)، استخدِم بروتوكول HTTPS. وإذا كان المضيف الظاهري لا يتيح استخدام بروتوكول أمان طبقة النقل (TLS)، يمكنك استخدام HTTP.
• routerIP:port هو عنوان IP ورقم المنفذ الخاصَين بالمضيف الافتراضي.
• يتم تحديد proxy-base-path وresource-path عند إنشاء الخادم الوكيل لواجهة برمجة التطبيقات.

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

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

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

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

لإنشاء مضيف افتراضي يستخدم بروتوكول HTTP، اتّبِع الخطوات التالية:

1. أنشئ المضيف الافتراضي باستخدام واجهة برمجة التطبيقات Create a Virtual Host، حيث يكون ms-IP هو عنوان IP أو اسم النطاق الخاص بعقدة "خادم الإدارة":
   

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

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

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

لتعديل مضيف افتراضي، اتّبِع الخطوات التالية:

1. عدِّل المضيف الظاهري باستخدام واجهة برمجة التطبيقات Update a Virtual Host، حيث يكون <ms-IP> هو عنوان IP أو اسم نطاق عقدة "خادم الإدارة". عليك تحديد التعريف الكامل للمضيف الظاهري في نص الطلب، وليس فقط العناصر التي تريد تغييرها. في هذا المثال، يتم تغيير رقم منفذ المضيف الافتراضي من 9008 إلى 9009:

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

2. في الإصدارَين 4.16.01 و4.16.05 من Edge for Private Cloud فقط، في حال تعديل مضيف افتراضي حالي وتفعيل بروتوكول أمان طبقة النقل (TLS) أو إيقافه بدون تغيير رقم المَنفذ، عليك اتّباع الخطوات التالية:

   1. أوقِف جهاز التوجيه باتّباع الخطوات التالية:

      /opt/apigee/apigee-service/bin/apigee-service edge-router stop

   2. حذف أي ملفات في /opt/nginx/conf.d:

      rm -f /opt/nginx/conf.d/*

   3. بدء جهاز التوجيه:

      /opt/apigee/apigee-service/bin/apigee-service edge-router start

   4. كرِّر هذه الخطوات لجميع أجهزة التوجيه.