پیکربندی میزبان‌های مجازی برای «ابر خصوصی»

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید. اطلاعات

در نصب در محل، کنترل کامل بر میزبان‌های مجازی دارید. می‌توانید میزبان‌های مجازی برای هر سازمانی، در هر محیطی، بااستفاده از TLS یا بدون آن ایجاد کنید.

این سند نحوه ایجاد میزبان مجازی ساده را توضیح می‌دهد. یعنی ایمیل‌هایی که از «امنیت لایه انتقال» پشتیبانی نمی‌کنند. برای نمونه‌های بیشتر، ازجمله نمونه‌هایی درباره ایجاد میزبان‌های مجازی که از «امنیت لایه انتقال» پشتیبانی می‌کنند، به پیکربندی دسترسی «امنیت لایه انتقال» به میانای برنامه‌سازی کاربردی برای «ابر خصوصی» مراجعه کنید.

بیشتر بدانید:

• درباره میزبانان مجازی
• پیکربندی میزبان‌های مجازی
• پیکربندی «امنیت لایه انتقال»
• فروشگاه‌های کلید و فروشگاه‌های مطمئن
• پیکربندی دسترسی «امنیت لایه انتقال» به میانای برنامه‌سازی کاربردی برای «ابر خصوصی»

درباره نام‌های مستعار میزبان

وقتی میزبان مجازی را ایجاد می‌کنید، باید نام مستعار میزبان مجازی را مشخص کنید. معمولاً این نام ساناد میزبان مجازی است.

«مسیریاب لبه» سرصفحه Host درخواست ورودی را با فهرست نام‌های مستعار میزبان دردسترس مقایسه می‌کند تا کارگزار نیابتی API را که درخواست را مدیریت می‌کند تعیین کند. هنگام درخواست ازطریق میزبان مجازی، یا نام دامنه‌ای را مشخص کنید که با نام مستعار میزبان میزبان مجازی مطابقت داشته باشد، یا نشانی IP «مسیریاب» و سرایند Host حاوی نام مستعار میزبان را مشخص کنید.

برای مثال، اگر میزبان مجازی‌ای با نام مستعار میزبان myapis.apigee.net در درگاه ۹۰۰۱ ایجاد کرده‌اید، درخواست cURL به API ازطریق آن میزبان مجازی می‌تواند از یکی از فرم‌های زیر استفاده کند:

• اگر ورودی ساناد برای 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

سپس می‌توانید درخواستی ارائه دهید که انگار ورودی ساناد دارید:

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

درباره درگاه‌های میزبان مجازی در Edge برای «ابر خصوصی» نسخه ۴.۱۶.۰۱ و بالاتر

هنگام ایجاد میزبان مجازی، درگاه «روتر» مورداستفاده میزبان مجازی را مشخص می‌کنید. برای مثال، درگاه ۹۰۰۱.

برای نسخه‌های Apigee for Private Cloud 4.16.01 و نسخه‌های جدیدتر، به‌طور پیش‌فرض، «مسیریاب» به‌عنوان کاربر «apigee» اجرا می‌شود که به درگاه‌های ممتاز، معمولاً درگاه‌های ۱۰۲۴ و پایین‌تر، دسترسی ندارد. اگر می‌خواهید میزبان مجازی ایجاد کنید که «مسیریاب» را به درگاه محافظت‌شده‌ای پیوند دهد، باید «مسیریاب» را پیکربندی کنید تا به‌عنوان کاربری که به آن درگاه‌ها دسترسی دارد اجرا شود. برای اطلاعات بیشتر، به راه‌اندازی میزبان مجازی مراجعه کنید.

ایجاد میزبان‌های مجازی

این بخش نحوه ایجاد میزبان‌های مجازی برای Apigee Edge for Private Cloud را شرح می‌دهد. توجه داشته باشید که برای ایجاد میزبان مجازی جدید، باید سرپرست سازمان باشید.

می‌توانید بااستفاده از API یا «واسط کاربر Edge»، میزبان‌های مجازی برای Apigee Edge for Private Cloud ایجاد کنید. این موارد در بخش‌های زیر توضیح داده شده‌اند.

ایجاد میزبان مجازی بااستفاده از مرورگر

این بخش نحوه ایجاد میزبان مجازی بااستفاده از مرورگر را توضیح می‌دهد (فقط واسط کاربر Edge).

برای ایجاد میزبان مجازی جدید در «واسط کاربر Edge»:

1. به سیستم «واسط کاربر مدیریت Edge» وارد شوید.
2. سرپرست > میزبان‌های مجازی را انتخاب کنید.

3. محیط را از فهرست کرکره‌ای انتخاب کنید.

   ‫Edge فهرستی از میزبان‌های مجازی برای آن محیط نمایش می‌دهد.

4. برای ایجاد میزبان مجازی جدید، + میزبان مجازی را انتخاب کنید.

   ‫Edge فرم ایجاد میزبان مجازی را نمایش می‌دهد.

   همچنین می‌توانید روی نام میزبان مجازی موجود کلیک کنید تا آن را ویرایش کنید.

5. میزبان مجازی جدیدتان را تعریف کنید. توجه داشته باشید که فیلد نشانی وب پایه باید شامل پروتکل باشد (یعنی مقدار فیلد را با «http://‎» یا «https://‎» پیشوندگذاری کنید.)

   به‌علاوه، توجه داشته باشید که:

   • هیچ محدودیتی برای تعداد میزبان‌های مجازی که می‌توانید ایجاد کنید وجود ندارد
   • «امنیت لایه انتقال» اختیاری است و می‌تواند نسخه ۱.۰، ۱.۱، یا ۱.۲ باشد
   • درگاه میزبان مجازی قابل پیکربندی است
6. برای ذخیره کردن میزبان مجازی جدید، روی دکمه ایجاد کلیک کنید.

ایجاد میزبان مجازی با API

برای ایجاد میزبان مجازی با API، یک شیء XML ایجاد کنید که میزبان مجازی را تعریف می‌کند. برای مثال، شیء XML زیر میزبان مجازی را تعریف می‌کند که از پروتکل HTTP استفاده می‌کند:

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

توجه داشته باشید که میزبان مجازی دارای ویژگی name است. از مقدار دارایی name برای پیکربندی پراکسی API برای استفاده از میزبان مجازی استفاده می‌کنید.

سپس می‌توانید با ارسال درخواست به موارد زیر، ازطریق این میزبان مجازی به پراکسی API دسترسی پیدا کنید:

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 هنگام ایجاد پراکسی API تعریف می‌شوند.

معمولاً، شما واسط‌های برنامه‌سازی کاربردی خود را با نشانی 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. میزبان مجازی را بااستفاده از میانای برنامه‌سازی کاربردی ایجاد میزبان مجازی ایجاد کنید، که در آن 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. اگر پراکسی‌های API موجود دارید، میزبان مجازی را به عنصر <HTTPConnection> در «نقطه پایان پراکسی» اضافه کنید. میزبان مجازی به‌طور خودکار به همه پراکسی‌های جدید API اضافه می‌شود. به پیکربندی پراکسی API برای استفاده از میزبان مجازی مراجعه کنید.

درحال اصلاح میزبان مجازی

برای اصلاح میزبان مجازی، مراحل زیر را انجام دهید:

1. بااستفاده از به‌روزرسانی میانای برنامه‌سازی کاربردی میزبان مجازی، میزبان مجازی را به‌روزرسانی کنید، که در آن <ms-IP> نشانی IP یا نام دامنه گره «سرور مدیریت» است. باید تعریف کامل میزبان مجازی را در بدنه درخواست مشخص کنید، نه فقط عناصری را که می‌خواهید تغییر دهید. در این مثال، شماره درگاه میزبان مجازی را از ۹۰۰۸ به ۹۰۰۹ تغییر می‌دهید:

   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. این کار را برای همه «رهیاب‌ها» تکرار کنید.