درحال مشاهده اسناد Apigee Edge هستید.
به
اسناد Apigee X بروید. اطلاعات
نمایندگی میزبان مجازی
شیء XML که برای تعریف میزبان مجازی استفاده میکنید براساس نسخه Edge شما است: Cloud یا Private Cloud.
اگر مشتری «ابر خصوصی» هستید، باید مطمئن شوید که از XML صحیح برای نسخه Edge خود استفاده میکنید.
Cloud و Private Cloud ۴.۱۷.۰۱ و نسخههای جدیدتر
<VirtualHost name="vhostName">
<Port>portNumber</Port>
<BaseUrl>http://myCo.com</BaseUrl>
<OCSPStapling>offOn</OCSPStapling>
<HostAliases>
<HostAlias>hostAlias</HostAlias>
</HostAliases>
<Interfaces>
<!-- Private Cloud only -->
<Interface>interfaceName</Interface>
</Interfaces>
<RetryOptions>
<RetryOption>option</RetryOption>
</RetryOptions>
<ListenOptions>
<ListenOption>option</ListenOption>
</ListenOptions>
<SSLInfo>
<Enabled>trueFalse</Enabled>
<ClientAuthEnabled>trueFalse</ClientAuthEnabled>
<KeyStore>ref://keystoreRef</KeyStore>
<KeyAlias>keyAlias</KeyAlias>
<TrustStore>ref://truststoreRef</TrustStore>
<IgnoreValidationErrors>trueFalse</IgnoreValidationErrors>
</SSLInfo>
<!-- UseBuiltInFreeTrialCert is for Edge Cloud only -->
<UseBuiltInFreeTrialCert>trueFalse</UseBuiltInFreeTrialCert>
<PropagateTLSInformation>
<!-- PropagateTLSInformation is Alpha in the Cloud only -->
<ConnectionProperties>trueFalse</ConnectionProperties>
<ClientProperties>trueFalse</ClientProperties>
</PropagateTLSInformation>
<Properties>
<Property name="proxy_read_timeout">timeout</Property>
<Property name="keepalive_timeout">timeout</Property>
<Property name="proxy_request_buffering">onOff</Property>
<Property name="proxy_buffering">onOff</Property>
<!-- ssl_protocols is Private Cloud only -->
<Property name="ssl_protocols">protocolList</Property>
<Property name="ssl_ciphers">cipherList</Property>
</Properties>
</VirtualHost>Private Cloud نسخه 4.16.01 تا 4.16.09
<VirtualHost name="vhostName">
<Port>portNumber</Port>
<HostAliases>
<HostAlias>hostAlias</HostAlias>
</HostAliases>
<Interfaces>
<Interface>interfaceName</Interface>
</Interfaces>
<SSLInfo>
<Enabled>trueFalse</Enabled>
<ClientAuthEnabled>trueFalse</ClientAuthEnabled>
<KeyStore>ref://keystoreRef</KeyStore>
<KeyAlias>keyAlias</KeyAlias>
<TrustStore>ref://truststoreRef</TrustStore>
<IgnoreValidationErrors>trueFalse</IgnoreValidationErrors>
</SSLInfo>
</VirtualHost>Private Cloud نسخه ۴.۱۵.۰۷ و قدیمیتر
<VirtualHost name="vhostName">
<Port>portNumber</Port>
<HostAliases>
<HostAlias>hostAlias</HostAlias>
</HostAliases>
<Interfaces>
<Interface>interfaceName</Interface>
</Interfaces>
<SSLInfo>
<Enabled>trueFalse</Enabled>
<ClientAuthEnabled>trueFalse</ClientAuthEnabled>
<KeyStore>keystore</KeyStore>
<KeyAlias>keyAlias</KeyAlias>
<TrustStore>truststore</TrustStore>
<IgnoreValidationErrors>trueFalse</IgnoreValidationErrors>
<Ciphers>
<Cipher>cipher</Cipher>
<Cipher>cipher</Cipher>
</Ciphers>
<Protocols>
<Protocol>protocol</Protocol>
<Protocol>protocol</Protocol>
</Protocols>
</SSLInfo>
</VirtualHost>ویژگیهای پیکربندی میزبان مجازی
جدول زیر فهرستی از داراییهایی را که برای پیکربندی میزبان مجازی استفاده میکنید ارائه میدهد:
| مشخصات | شرح | پیشفرض | الزامی | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| VirtualHost |
نام میزبان مجازی را مشخص میکند. از این نام برای ارجاع دادن به میزبان مجازی هنگام پیکربندی پراکسی API استفاده میکنید. نویسههایی که میتوانید در مشخصه نام استفاده کنید به این موارد محدود میشود: A-Z0-9._\-$%. |
خالی | بله | ||||||||||||
| درگاه |
شماره درگاه استفادهشده توسط میزبان مجازی را مشخص میکند. مطمئن شوید که درگاه در «مسیریاب لبه» باز باشد. اگر در عنصر برای Cloud: هنگام ایجاد میزبان مجازی باید درگاه ۴۴۳ را مشخص کنید. اگر حذف شود، بهطور پیشفرض درگاه روی ۴۴۳ تنظیم میشود. اگر میزبان مجازی موجودی دارید که از درگاهی غیراز ۴۴۳ استفاده میکند، نمیتوانید درگاه را تغییر دهید. برای نسخههای پخش «ابر خصوصی» ۴.۱۶.۰۱ تا ۴.۱۷.۰۵: هنگام ایجاد میزبان مجازی، درگاه «مسیریاب» مورداستفاده میزبان مجازی را مشخص میکنید. برای مثال، درگاه ۹۰۰۱. بهطور پیشفرض، «مسیریاب» بهعنوان کاربر «apigee» اجرا میشود که به درگاههای دارای امتیاز، معمولاً درگاههای ۱۰۲۴ و پایینتر، دسترسی ندارد. اگر میخواهید میزبان مجازیای ایجاد کنید که «مسیریاب» را به درگاه محافظتشدهای پیوند دهد، باید «مسیریاب» را پیکربندی کنید تا بهعنوان کاربری که به آن درگاهها دسترسی دارد اجرا شود. برای اطلاعات بیشتر، راهاندازی میزبان مجازی را ببینید. برای نسخههای «ابر خصوصی» قبلاز 4.16.01: «مسیریاب» میتواند فقط به یک اتصال HTTPS در هر میزبان مجازی، در درگاهی خاص، با گواهینامه مشخص گوش دهد. بنابراین، اگر پایان TLS در درگاه مشخصشده در «مسیریاب» رخ دهد، چندین میزبان مجازی نمیتوانند از شماره درگاه یکسان استفاده کنند. |
خالی | بله | ||||||||||||
| BaseUrl | نشانی وب نمایشدادهشده توسط واسط کاربر Edge را برای یک پراکسی API که در میزبان مجازی مستقر شده است ملغی میکند. وقتی ترازکننده بار خارجی در مقابل «مسیریابهای لبه» دارید مفید است. برای اطلاعات بیشتر،
پیکربندی دسترسی به API برای «ابر خصوصی»
بااستفاده از «امنیت لایه انتقال» را ببینید.
مقدار |
خالی | نه | ||||||||||||
| OCSPStapling |
کارخواه OCSP (پروتکل وضعیت گواهینامه آنلاین) برای تعیین معتبر بودن گواهینامه TLS، درخواست وضعیت را به پاسخدهنده OCSP ارسال میکند. پاسخ نشان میدهد که گواهینامه TLS معتبر است و باطل نشده است. وقتی فعال باشد، چسباندن OCSP به Edge اجازه میدهد که بهعنوان سرور TLS برای TLS یکطرفه عمل کند، مستقیماً از پاسخدهنده OCSP پُرسمان کند و سپس پاسخ را در حافظه نهان ذخیره کند. سپس Edge این پاسخ را به کارخواه TLS برمیگرداند، یا آن را بهعنوان بخشی از دستدهی TLS سنجاق میکند. برای اطلاعات بیشتر، فعال کردن سنجاق کردن OCSP در سرور را ببینید. برای فعال کردن سنجاق کردن OCSP، باید «امنیت لایه انتقال» فعال باشد. برای فعال کردن، روی |
غیرفعال | نه | ||||||||||||
| HostAliases | |||||||||||||||
| HostAlias |
نام ساناد نمایان برای عموم میزبان مجازی در «مسیریاب»، که بهصورت اختیاری شامل شماره درگاه میشود. ترکیب نام مستعار میزبان و شماره درگاه برای میزبان مجازی باید برای همه میزبانهای مجازی در نصب Edge یکتا باشد. این یعنی چندین میزبان مجازی میتوانند از یک شماره درگاه استفاده کنند، اگر نامهای مستعار میزبان متفاوتی داشته باشند. باید ورودی ساناد و سابقه CNAME بسازید که با نام مستعار میزبان مطابقت داشته باشد، و نام مستعار میزبان باید با رشتهای که مشتری در سرایند شماره درگاه در میتوانید چندین تعریف میتوانید نویسه عام «*» را در نام مستعار میزبان بگنجانید. نویسه عام «*» فقط میتواند در ابتدای نام مستعار میزبان (قبلاز اولین «.») قرار گیرد و نمیتواند با نویسههای دیگر ترکیب شود.
برای مثال برای Cloud: اگر میزبان مجازی موجودی دارید که از درگاهی غیر از ۴۴۳ استفاده میکند، نمیتوانید نام مستعار میزبان اضافه یا حذف کنید. برای «ابر خصوصی»: اگر نام مستعار میزبان را بااستفاده از نشانیهای IP «رهیابهایتان» تنظیم میکنید، و نه ورودیهای ساناد، برای هر «رهیاب» نام مستعار میزبان جداگانهای اضافه کنید و نشانی IP هر «رهیاب» و درگاه میزبان مجازی را مشخص کنید. |
خالی | بله | ||||||||||||
| میانهها | فقط برای Edge for Private Cloud دردسترس است. | ||||||||||||||
| میانا |
واسطهای شبکهای را که میخواهید برای مثال، برای مشخص کردن اینکه درگاه فقط به en0 ملحق شود: <Interfaces> <Interface>en0</Interface> </Interfaces> با اجرای فرمان «ifconfig -a»، رابطهای دردسترس در سیستم خود را تعیین کنید. |
خالی | همه میانها | ||||||||||||
| RetryOptions | برای Edge Cloud و برای Private Cloud نسخه ۴.۱۸.۰۱ و بعدی دردسترس است. | ||||||||||||||
| RetryOption |
پیکربندی نحوه واکنش «رهیاب» برای این میزبان مجازی وقتی «پردازنده پیام» ازکار میافتد. بااستفاده از
اگر چندین مقدار را مشخص کنید، «مسیریاب» از «یا» منطقی برای ترکیب کردن آنها استفاده میکند. برای مثال: <RetryOptions> <RetryOption>http_599</RetryOption> <RetryOption>error</RetryOption> <RetryOption>timeout</RetryOption> <RetryOption>invalid_header</RetryOption> </RetryOptions> |
||||||||||||||
| ListenOptions | با درخواست از پشتیبانی Apigee Edge، برای «ابر خصوصی» نسخه ۴.۱۸.۰۱ و جدیدتر و برای Edge Cloud دردسترس است. | ||||||||||||||
| ListenOption |
اگر از ELB در حالت عبور TCP برای مدیریت درخواستهای «مسیریابهای لبه» استفاده میکنید،
«مسیریاب» نشانی IP مربوط به ELB را بهجای نشانی IP واقعی کارخواه بهعنوان نشانی IP کارخواه درنظر میگیرد. اگر «مسیریاب» به IP کارخواه واقعی نیاز دارد،
مقدار پیشفرض برای برای مثال: <ListenOptions> <ListenOption>proxy_protocol</ListenOption> </ListenOptions> برای اینکه بعداً |
||||||||||||||
| SSLInfo | |||||||||||||||
| فعال |
«امنیت لایه انتقال»/ پوسته ایمن یکطرفه را فعال میکند. باید یک انبار کلید تعریف کرده باشید که حاوی گواهی و کلید خصوصی باشد. برای Cloud: باید گواهی امضاشده توسط نهاد مورداعتمادی مثل Symantec یا VeriSign داشته باشید. نمیتوانید از گواهینامه خودامضا یا گواهینامههای برگ امضاشده توسط مرجع صدور گواهینامه خودامضا استفاده کنید. برای Cloud: اگر میزبان مجازی موجود شما برای استفاده از درگاهی غیراز ۴۴۳ پیکربندی شده باشد، نمیتوانید تنظیمات TLS را تغییر دهید. یعنی نمیتوانید تنظیم TLS را از فعال به غیرفعال یا از غیرفعال به فعال تغییر دهید. |
نادرست | نه | ||||||||||||
| ClientAuthEnabled | «امنیت لایه انتقال» دوطرفه یا کارخواه را بین Edge (سرور) و برنامه (کارخواه) که درخواست را ارسال میکند فعال میکند. فعال کردن «امنیت لایه انتقال» دوطرفه مستلزم این است که در Edge یک truststore راهاندازی کنید که حاوی گواهینامه کارخواه «امنیت لایه انتقال» باشد. | نادرست | نه | ||||||||||||
| KeyStore |
نام انبار کلید در Edge. Apigee توصیه میکند که از مرجع برای مشخص کردن نام انبار کلید استفاده کنید تا بتوانید انبار کلید را بدون نیاز به بازراهاندازی «مسیریابها» تغییر دهید. برای اطلاعات بیشتر، گزینههای پیکربندی «امنیت لایه انتقال» را ببینید. |
خالی | اگر «فعال» درست باشد، «بله» | ||||||||||||
| KeyAlias | نام مستعار مشخصشده هنگام بارگذاری گواهی و کلید خصوصی در انبار کلید. باید نام مستعار را دقیقاً مشخص کنید؛ نمیتوانید از مرجع استفاده کنید. برای اطلاعات بیشتر، گزینههای پیکربندی «امنیت لایه انتقال» را ببینید. | خالی | اگر «فعال» درست باشد، «بله» | ||||||||||||
| TrustStore |
نام فروشگاه مطمئن در Edge که حاوی گواهینامه یا زنجیره گواهینامه
مورد استفاده برای «امنیت لایه انتقال» دوطرفه است. اگر Apigee توصیه میکند که از مرجع برای مشخص کردن نام فروشگاه مطمئن استفاده کنید تا بتوانید فروشگاه مطمئن را بدون نیاز به راهاندازی مجدد «مسیریابها» تغییر دهید. برای اطلاعات بیشتر، گزینههای پیکربندی «امنیت لایه انتقال» را ببینید. |
خالی | نه | ||||||||||||
| IgnoreValidationErrors |
اگر درست باشد، مشخص میکند که خطاهای گواهینامه «امنیت لایه انتقال» نادیده گرفته شود. این گزینه مشابه گزینه «-k» در cURL است. این گزینه هنگام پیکربندی «امنیت لایه انتقال» برای «سرورهای هدف» و «نقطههای پایانی هدف»، و هنگام پیکربندی میزبانهای مجازی که از «امنیت لایه انتقال» دوطرفه استفاده میکنند معتبر است. وقتی با نقطه پایانی هدف/سرور هدف استفاده میشود، اگر سیستم پشتیبان از SNI استفاده کند و گواهینامهای با «نام متمایز» موضوع (DN) برگرداند که با نام میزبان مطابقت نداشته باشد، راهی برای نادیده گرفتن خطا وجود ندارد و اتصال برقرار نمیشود. |
نادرست | نه | ||||||||||||
| رمزها |
فقط برای Edge for Private Cloud نسخه ۴.۱۵.۰۷ و نسخههای قبلی. رمزهای پشتیبانیشده توسط میزبان مجازی را مشخص میکند. اگر هیچ رمزی مشخص نشده باشد، همه رمزهای دردسترس برای ماشین مجازی جاوا مجاز خواهند بود. برای محدود کردن رمزها، عناصر زیر را اضافه کنید: <Ciphers> <Cipher>TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA</Cipher> <Cipher>TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256</Cipher> </Ciphers> |
همه توسط JVM پشتیبانی میشوند | نه | ||||||||||||
| پروتکلها |
فقط برای Edge for Private Cloud نسخه ۴.۱۵.۰۷ و نسخههای قبلی. پروتکلهای پشتیبانیشده توسط میزبان مجازی را مشخص میکند. اگر هیچ پروتکلی مشخص نشده باشد، همه پروتکلهای دردسترس برای ماشین مجازی جاوا مجاز خواهند بود. برای محدود کردن پروتکلها، عناصر زیر را اضافه کنید: <Protocols> <Protocol>TLSv1</Protocol> <Protocol>TLSv1.2</Protocol> <Protocol>SSLv2Hello</Protocol> </Protocols> |
همه توسط JVM پشتیبانی میشوند | نه | ||||||||||||
| UseBuiltInFreeTrialCert | فقط برای «ابر لبه» دردسترس است. | ||||||||||||||
| UseBuiltInFreeTrialCert |
اگر حساب پولی Edge for Cloud دارید و هنوز گواهینامه و کلید TLS ندارید، میتوانید میزبان مجازیای ایجاد کنید که از گواهینامه و کلید دوره آزمایشی رایگان Apigee استفاده کند. یعنی میتوانید میزبان مجازی را بدون اینکه ابتدا انبار کلید ایجاد کنید بسازید. گواهینامه دوره آزمایشی رایگان Apigee برای دامنه به تعریف میزبان مجازی که از گواهینامه و کلید دوره آزمایشی رایگان Apigee استفاده میکند مراجعه کنید. |
نادرست | نه | ||||||||||||
| PropagateTLSInformation | فقط در نسخه آلفا برای Edge Cloud دردسترس است. | ||||||||||||||
| ConnectionProperties |
فعال کردن ضبط اطلاعات اتصال «امنیت لایه انتقال» توسط Edge. این اطلاعات سپس بهعنوان متغیرهای جریان در یک پراکسی API دردسترس قرار میگیرد. برای اطلاعات بیشتر، دسترسی به اطلاعات اتصال «امنیت لایه انتقال» در پراکسی API را ببینید. |
نادرست | نه | ||||||||||||
| ClientProperties |
فعال کردن ضبط جزئیات گواهینامه کارخواه که Edge در «امنیت لایه انتقال» دوطرفه ضبط کرده است. این اطلاعات سپس بهعنوان متغیرهای جریان در یک پراکسی API دردسترس قرار میگیرد. برای اطلاعات بیشتر، دسترسی به اطلاعات اتصال «امنیت لایه انتقال» در پراکسی API را ببینید. |
نادرست | نه | ||||||||||||
| مشخصهها | برای Edge Cloud و برای Private Cloud نسخه 4.17.01 و جدیدتر دردسترس است. | ||||||||||||||
| proxy_read_timeout |
مدت زمان وقفه بین «پردازشگرهای پیام» و «مسیریاب» را برحسب ثانیه تنظیم میکند. اگر «پیامپرداز» قبلاز پایان این مدت پاسخ ندهد، «مسیریاب» اتصال را قطع میکند و پاسخ HTTP 504 برمیگرداند. مقدار proxy_read_timeout باید بزرگتر از مقدار مهلت زمانی هدف استفادهشده توسط «پردازشگر پیام» باشد. این کار تضمین میکند که «مسیریاب» قبلاز اینکه «پردازشگر پیام» فرصت کند پاسخی برگرداند،
زمانش تمام نشود. زمان اتمام هدف پیشفرض برای
«پردازشگر پیام» ۵۵ ثانیه، ۵۵۰۰۰ میلیثانیه، است که توسط
نشان |
57 | نه | ||||||||||||
| keepalive_timeout |
مدت زمان اتمام مهلت را برحسب ثانیه بین کارخواه و «مسیریاب» تنظیم میکند وقتی کارخواه درخواستی را ارسال میکند که حاوی سرایند «زنده نگه داشتن» است. «مسیریاب» اتصال را تا پایان مدت باز نگه میدارد. اگر «مسیریاب» درحال انتظار برای دریافت پاسخ از «پردازشگر پیام» باشد، اتصال را قطع نخواهد کرد. مهلت فقط پساز اینکه «مسیریاب» پاسخ را به مشتری برمیگرداند شروع میشود. |
۶۵ | نه | ||||||||||||
| ssl_ciphers |
رمزهای پشتیبانیشده توسط میزبان مجازی را تنظیم میکند و رمزهای پیشفرض تنظیمشده در «رهیاب» را ملغی میکند. فهرستی از رمزها را با جداساز دونقطه بهصورت زیر مشخص کنید: <Property name="ssl_ciphers">HIGH:!aNULL:!MD5:!DH+3DES:!kEDH;</Property> برای اطلاعات درباره دستورگان و مقادیر مجاز این کد، به https://www.openssl.org/docs/man1.0.2/man1/ciphers.html مراجعه کنید. توجه داشته باشید که این کد از نامهای رمز OpenSSL، مانند AES128-SHA256، استفاده میکند و نه از نامهای رمز Java/JSSE، مانند TLS_RSA_WITH_AES_128_CBC_SHA256. |
بالا:!aNULL:
!MD5: !DH+3DES: !kEDH |
نه | ||||||||||||
| ssl_protocols |
فقط برای Edge for Private Cloud دردسترس است. پروتکلهای «امنیت لایه انتقال» پشتیبانیشده توسط میزبان مجازی را بهعنوان فهرست جداشده با فاصله تنظیم میکند، و پروتکلهای پیشفرض تنظیمشده در «مسیریاب» را ملغی میکند. توجه: اگر دو میزبان مجازی از یک درگاه استفاده میکنند، باید
فهرستی از پروتکلهای «امنیت لایه انتقال» را بهصورت زیر مشخص کنید که با فاصله از هم جدا شده باشند: <Property name="ssl_protocols">TLSv1 TLSv1.2</Property> |
TLSv1 TLSv1.1 TLSv1.2 | نه | ||||||||||||
| proxy_request_buffering |
بافربندی بدنه درخواست را فعال (روشن) یا غیرفعال (خاموش) میکند. وقتی بافرینگ روشن است، «روتر» کل بدنه درخواست را قبلاز ارسال آن به «پردازشگر پیام» بافر میکند. اگر خطایی وجود داشته باشد، «مسیریاب» میتواند «پردازنده پیام» دیگری را امتحان کند. اگر خاموش باشد، میانگیری غیرفعال میشود و بدنه درخواست بلافاصله پساز دریافت به «پردازشگر پیام» ارسال میشود. اگر خطایی وجود داشته باشد، «مسیریاب» درخواست را به «پردازشگر پیام» دیگری ارسال مجدد نمیکند. |
در | نه | ||||||||||||
| proxy_buffering | بافر کردن پاسخ را فعال (روشن) یا غیرفعال (خاموش) میکند. وقتی میانگیری روشن باشد، «مسیریاب» پاسخ را میانگیری میکند. وقتی بافرینگ خاموش باشد، پاسخ بهصورت همزمان و بلافاصله پساز دریافت توسط «مسیریاب» به مشتری ارسال میشود. | در | نه | ||||||||||||