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

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

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

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

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

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

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

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

يقارن جهاز توجيه Edge عنوان 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

الخيارات المتاحة عند إجراء ذلك لا يحتوي على إدخال DNS للمضيف الظاهري

أحد الخيارات عندما لا يتوفر لديك إدخال نظام أسماء النطاقات، هو تعيين الاسم المستعار للمضيف على عنوان 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.

بالنسبة إلى الإصدار 4.16.01 من Apigee for Private Cloud والإصدارات الأحدث، يتم تشغيل جهاز التوجيه تلقائيًا كـ المستخدم "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. أنشئ المضيف الظاهري باستخدام إنشاء 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. تحديث المضيف الظاهري باستخدام تحديث واجهة برمجة تطبيقات مضيف افتراضي حيث يكون <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) أو إيقاف بروتوكول أمان طبقة النقل (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. كرِّر هذه الخطوات مع جميع أجهزة التوجيه.