Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. info
Sanal ana makine temsili
Sanal ana makine tanımlamak için kullandığınız XML nesnesi, Edge sürümünüze (Cloud veya Private Cloud) bağlıdır.
Private Cloud müşterisiyseniz Edge sürümünüz için doğru XML'i kullandığınızdan emin olmanız gerekir.
Cloud ve Private Cloud 4.17.01 ve sonraki sürümler
<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 4.15.07 ve önceki sürümler
<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>
Sanal ana makine yapılandırma özellikleri
Aşağıdaki tabloda, sanal ana makineyi yapılandırmak için kullandığınız özellikler listelenmektedir:
Özellikler | Açıklama | Varsayılan | Zorunlu | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
VirtualHost |
Sanal ana makinenin adını belirtir. API proxy'sini yapılandırırken sanal ana makineye referans vermek için bu adı kullanırsınız. Ad özelliğinde kullanabileceğiniz karakterler şu şekilde kısıtlanmıştır: A-Z0-9._\-$%. |
Yok | Evet | ||||||||||||
Bağlantı noktası |
Sanal ana makinenin kullandığı bağlantı noktası numarasını belirtir. Bağlantı noktasının Edge Yönlendirici'de açık olduğundan emin olun. Bir Cloud için: Sanal ana makine oluştururken bağlantı noktası 443'ü belirtmeniz gerekir. Atlanırsa bağlantı noktası varsayılan olarak 443 olarak ayarlanır. 443 dışında bir bağlantı noktası kullanan mevcut bir sanal barındırıcınız varsa bağlantı noktasını değiştiremezsiniz. 4.16.01 ile 4.17.05 arasındaki Private Cloud sürümleri için: Sanal ana makine oluştururken, sanal ana makine tarafından kullanılan yönlendirici bağlantı noktasını belirtirsiniz. Örneğin, bağlantı noktası 9001. Yönlendirici varsayılan olarak "apigee" kullanıcısı olarak çalışır. Bu kullanıcı, ayrıcalıklı bağlantı noktalarına (genellikle 1024 ve altı bağlantı noktaları) erişemez. Yönlendiriciyi korunan bir bağlantı noktasına bağlayan bir sanal ana makine oluşturmak istiyorsanız Yönlendiriciyi bu bağlantı noktalarına erişimi olan bir kullanıcı olarak çalışacak şekilde yapılandırmanız gerekir. Daha fazla bilgi için Sanal ana makine oluşturma başlıklı makaleyi inceleyin. 4.16.01'den önceki Özel Bulut sürümleri için: Yönlendirici, belirli bir bağlantı noktasında, belirtilen sertifikayla sanal ana makine başına yalnızca bir HTTPS bağlantısını dinleyebilir. Bu nedenle, Yönlendirici'de belirtilen bağlantı noktasında TLS sonlandırması gerçekleşirse birden fazla sanal ana makine aynı bağlantı noktası numarasını kullanamaz. |
Yok | Evet | ||||||||||||
BaseUrl | Sanal ana makineye dağıtılan bir API proxy'si için Edge kullanıcı arayüzü tarafından görüntülenen URL'yi geçersiz kılar. Edge Yönlendiricilerin önünde harici bir yük dengeleyiciniz olduğunda kullanışlıdır. Daha fazla bilgi için Private Cloud için bir API'ye TLS erişimini yapılandırma başlıklı makaleyi inceleyin.
|
Yok | Hayır | ||||||||||||
OCSPStapling |
OCSP (Çevrimiçi Sertifika Durum Protokolü) istemcisi, TLS sertifikasının geçerli olup olmadığını belirlemek için OCSP yanıtlayıcısına durum isteği gönderir. Yanıt, TLS sertifikasının geçerli olup olmadığını ve iptal edilip edilmediğini gösterir. OCSP stapling etkinleştirildiğinde, tek yönlü TLS için TLS sunucusu olarak hareket eden Edge'in OCSP yanıtlayıcıyı doğrudan sorgulamasına ve ardından yanıtı önbelleğe almasına olanak tanır. Daha sonra Edge bu yanıtı TLS istemcisine döndürür veya TLS el sıkışmasının bir parçası olarak yapıştırır. Daha fazla bilgi için Sunucunuzda OCSP Stapling'i etkinleştirme başlıklı makaleyi inceleyin. OCSP zımbalama özelliğini etkinleştirmek için TLS etkinleştirilmelidir. Etkinleştirmek için |
kapalı | Hayır | ||||||||||||
HostAliases | |||||||||||||||
HostAlias |
İsteğe bağlı olarak bağlantı noktası numarası da dahil olmak üzere, Yönlendirici üzerindeki sanal ana makinenin herkes tarafından görülebilen DNS adı. Sanal ana makinenin ana makine takma adı ve bağlantı noktası numarası kombinasyonu, Edge kurulumundaki tüm sanal ana makineler için benzersiz olmalıdır. Bu, farklı ana makine takma adlarına sahip birden fazla sanal ana makinenin aynı bağlantı noktası numarasını kullanabileceği anlamına gelir. Ana makine takma adıyla eşleşen bir DNS girişi ve CNAME kaydı oluşturmanız gerekir. Ayrıca, ana makine takma adı, istemcinin
Aynı sanal ana makine tanımında, sanal ana makine için birden fazla DNS girişine karşılık gelen birden fazla Ana makine takma adına "*" joker karakterini ekleyebilirsiniz. "*" joker karakteri yalnızca ana makine takma adının başında (ilk "." karakterinden önce) bulunabilir ve diğer karakterlerle birlikte kullanılamaz.
Örneğin Cloud için: 443 dışında bir bağlantı noktası kullanan mevcut bir sanal ana makineniz varsa ana makine takma adı ekleyemez veya kaldıramazsınız. Private Cloud için: Ana makine takma adını DNS girişlerini değil, yönlendiricilerinizin IP adreslerini kullanarak ayarlıyorsanız her yönlendiricinin IP adresini ve sanal ana makinenin bağlantı noktasını belirterek her yönlendirici için ayrı bir ana makine takma adı ekleyin. |
Yok | Evet | ||||||||||||
Arayüzler | Yalnızca Private Cloud için Edge'de kullanılabilir. | ||||||||||||||
Arayüz |
Örneğin, bağlantı noktasını yalnızca en0 ile bağlamayı belirtmek için: <Interfaces> <Interface>en0</Interface> </Interfaces> "ifconfig -a" komutunu çalıştırarak sisteminizde kullanılabilen arayüzleri belirleyin. |
Yok | Tüm arayüzler | ||||||||||||
RetryOptions | Edge Cloud ve Private Cloud 4.18.01 ve sonraki sürümlerde kullanılabilir. | ||||||||||||||
RetryOption |
İleti İşleyen devre dışı kaldığında Yönlendirici'nin bu sanal ana makine için nasıl tepki vereceğini yapılandırın.
Birden çok değer belirtirseniz Yönlendirici bunları birleştirmek için mantıksal bir VEYA kullanır. Örneğin: <RetryOptions> <RetryOption>http_599</RetryOption> <RetryOption>error</RetryOption> <RetryOption>timeout</RetryOption> <RetryOption>invalid_header</RetryOption> </RetryOptions> |
||||||||||||||
ListenOptions | Private Cloud 4.18.01 ve sonraki sürümlerde ve Edge Cloud'da Apigee Edge Destek Ekibi'ne istek göndererek kullanılabilir. | ||||||||||||||
ListenOption |
Edge yönlendiricilere gelen istekleri işlemek için TCP geçiş modunda bir ELB kullanıyorsanız yönlendirici, ELB'nin IP adresini gerçek istemci IP adresi yerine istemci IP adresi olarak işler. Yönlendirici gerçek istemci IP'sini gerektiriyorsa istemci IP'sini TCP paketinde iletmesi için ELB'de
Örneğin: <ListenOptions> <ListenOption>proxy_protocol</ListenOption> </ListenOptions> Daha sonra |
||||||||||||||
SSLInfo | |||||||||||||||
Etkin |
Tek yönlü TLS/SSL'yi etkinleştirir. Sertifikayı ve özel anahtarı içeren bir anahtar deposu tanımlamış olmanız gerekir. Cloud için: Symantec veya VeriSign gibi güvenilir bir tüzel kişi tarafından imzalanmış bir sertifikanız olmalıdır. Kendinden imzalı sertifika veya kendinden imzalı bir CA tarafından imzalanmış alt sertifika kullanamazsınız. Cloud için: Mevcut sanal ana makineniz 443 dışında bir bağlantı noktası kullanacak şekilde yapılandırılmışsa TLS ayarını değiştiremezsiniz. Yani TLS ayarını etkinden devre dışıya veya devre dışıdan etkin duruma geçiremezsiniz. |
yanlış | Hayır | ||||||||||||
ClientAuthEnabled | Edge (sunucu) ile isteği gönderen uygulama (istemci) arasında iki yönlü veya istemci TLS'yi etkinleştirir. İki yönlü TLS'yi etkinleştirmek için Edge'de TLS istemcisinin sertifikasını içeren bir güven mağazası oluşturmanız gerekir. | yanlış | Hayır | ||||||||||||
KeyStore |
Edge'deki anahtar deposunun adı. Apigee, yönlendiricileri yeniden başlatmak zorunda kalmadan anahtar deposunu değiştirebilmek için anahtar deposu adını belirtmek üzere bir referans kullanmanızı önerir. Daha fazla bilgi için TLS'yi yapılandırma seçenekleri başlıklı makaleyi inceleyin. |
Yok | Etkin değeri doğruysa evet | ||||||||||||
KeyAlias | Sertifikayı ve özel anahtarı anahtar deposuna yüklerken belirttiğiniz takma ad. Takma ad adını tam olarak belirtmeniz gerekir; referans kullanamazsınız. Daha fazla bilgi için TLS'yi yapılandırma seçenekleri başlıklı makaleyi inceleyin. | Yok | Etkin değeri doğruysa evet | ||||||||||||
TrustStore |
Edge'de iki yönlü TLS için kullanılan sertifikayı veya sertifika zincirini içeren güven mağazasının adı. Apigee, yönlendiricileri yeniden başlatmak zorunda kalmadan güven mağazasını değiştirebilmek için güven mağazası adını belirtmek üzere bir referans kullanmanızı önerir. Daha fazla bilgi için TLS yapılandırma seçenekleri bölümüne bakın. |
Yok | Hayır | ||||||||||||
IgnoreValidationErrors |
Doğru ise TLS sertifika hatalarının göz ardı edileceğini belirtir. Bu, cURL'daki "-k" seçeneğine benzer. Bu seçenek, Hedef Sunucular ve Hedef Uç Noktaları için TLS'yi yapılandırırken ve 2 yönlü TLS kullanan sanal ana makineleri yapılandırırken geçerlidir. Hedef uç nokta/hedef sunucuyla kullanıldığında, arka uç sistemi SNI kullanıyorsa ve ana makine adıyla eşleşmeyen bir konu Ayırt Edici Adı (DN) içeren sertifika döndürürse hatayı yoksaymanın bir yolu yoktur ve bağlantı başarısız olur. |
yanlış | Hayır | ||||||||||||
Şifreler |
Yalnızca Private Cloud için Edge 4.15.07 ve önceki sürümler için. Sanal ana makine tarafından desteklenen şifreleri belirtir. Şifre belirtilmezse JVM için kullanılabilen tüm sifrelere izin verilir. Şifreleri kısıtlamak için aşağıdaki öğeleri ekleyin: <Ciphers> <Cipher>TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA</Cipher> <Cipher>TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256</Cipher> </Ciphers> |
Tüm bunlar JVM tarafından desteklenir. | Hayır | ||||||||||||
Protokoller |
Yalnızca Private Cloud için Edge 4.15.07 ve önceki sürümler için. Sanal ana makine tarafından desteklenen protokolleri belirtir. Protokol belirtilmezse JVM için kullanılabilen tüm protokollere izin verilir. Protokolleri kısıtlamak için aşağıdaki öğeleri ekleyin: <Protocols> <Protocol>TLSv1</Protocol> <Protocol>TLSv1.2</Protocol> <Protocol>SSLv2Hello</Protocol> </Protocols> |
Tüm bunlar JVM tarafından desteklenir. | Hayır | ||||||||||||
UseBuiltInFreeTrialCert | Yalnızca Edge Cloud için kullanılabilir. | ||||||||||||||
UseBuiltInFreeTrialCert |
Ücretli bir Edge for Cloud hesabınız varsa ve henüz TLS sertifikanız ve anahtarınız yoksa Apigee ücretsiz deneme sertifika ve anahtarını kullanan bir sanal ana makine oluşturabilirsiniz. Yani, önce bir anahtar mağazası oluşturmadan sanal ana makine oluşturabilirsiniz. Apigee ücretsiz deneme sertifikası, Apigee ücretsiz deneme sertifikası ve anahtarını kullanan bir sanal ana makine tanımlama başlıklı makaleyi inceleyin. |
yanlış | Hayır | ||||||||||||
PropagateTLSInformation | Yalnızca Edge Cloud için alfa sürümünde kullanılabilir. | ||||||||||||||
ConnectionProperties |
Edge'in TLS bağlantı bilgilerini yakalamasını sağlar. Bu bilgiler daha sonra API proxy'sinde akış değişkenleri olarak kullanılabilir. Daha fazla bilgi için API proxy'sinde TLS bağlantı bilgilerine erişme başlıklı makaleyi inceleyin. |
yanlış | Hayır | ||||||||||||
ClientProperties |
İki yönlü TLS'de Edge tarafından yakalanan istemci sertifikası ayrıntılarının yakalanmasını sağlar. Bu bilgiler daha sonra API proxy'sinde akış değişkenleri olarak kullanılabilir. Daha fazla bilgi için API proxy'sinde TLS bağlantı bilgilerine erişme başlıklı makaleyi inceleyin. |
yanlış | Hayır | ||||||||||||
Mülkler | Edge Cloud ve Private Cloud 4.17.01 ve sonraki sürümlerde kullanılabilir. | ||||||||||||||
proxy_read_timeout |
Mesaj işleyiciler ile yönlendirici arasındaki zaman aşımı süresini saniye cinsinden ayarlar. Bu süre dolmadan Mesaj İşleyiciden yanıt alamazsa yönlendirici bağlantıyı keser ve HTTP 504 yanıtı döndürür. proxy_read_timeout değerinin, Mesaj İşleyen tarafından kullanılan hedef zaman aşımı değerinden büyük olması gerekir. Bu sayede, Mesaj İşleyen'in yanıt döndürmesi için zaman tanımadan önce Yönlendirici'nin zaman aşımı sorunu yaşamaması sağlanır. Mesaj işleyici için varsayılan hedef zaman aşımı, mesaj işleyicinin |
57 | Hayır | ||||||||||||
keepalive_timeout |
İstemci, Keep-Alive başlığını içeren bir istek gönderdiğinde istemci ile yönlendirici arasındaki zaman aşımı süresini saniye cinsinden belirler. Yönlendirici, süre sona erene kadar bağlantıyı açık tutar. Yönlendirici, şu anda Mesaj İşleyiciden yanıt bekliyorsa bağlantıyı kapatmaz. Zaman aşımı yalnızca Yönlendirici yanıtı istemciye döndürdükten sonra başlar. |
65 | Hayır | ||||||||||||
ssl_ciphers |
Yönlendiricide ayarlanan varsayılan şifreleri geçersiz kılarak sanal ana makine tarafından desteklenen şifreleri ayarlar. İki nokta işaretiyle ayrılmış bir şifre listesi şu biçimde belirtin: <Property name="ssl_ciphers">HIGH:!aNULL:!MD5:!DH+3DES:!kEDH;</Property> Bu jetonun izin verdiği söz dizimi ve değerler hakkında bilgi edinmek için https://www.openssl.org/docs/man1.0.2/man1/ciphers.html adresine bakın. Bu jetonun, TLS_RSA_WITH_AES_128_CBC_SHA256 gibi Java/JSSE şifre adlarını değil, AES128-SHA256 gibi OpenSSL şifre adlarını kullandığını unutmayın. |
YÜKSEK:!aNULL:
!MD5: !DH+3DES: !kEDH |
Hayır | ||||||||||||
ssl_protocols |
Yalnızca Private Cloud için Edge'de kullanılabilir. Yönlendiricide ayarlanan varsayılan protokolleri geçersiz kılarak sanal ana makine tarafından desteklenen TLS protokollerini boşlukla ayrılmış bir liste olarak ayarlar. Not: İki sanal ana makine aynı bağlantı noktasını paylaşıyorsa TLS protokollerinin boşluk ayraçlı listesini şu biçimde belirtin: <Property name="ssl_protocols">TLSv1 TLSv1.2</Property> |
TLSv1 TLSv1.1 TLSv1.2 | Hayır | ||||||||||||
proxy_request_buffering |
İstek gövdesinin arabelleğe alınmasını etkinleştirir (açık) veya devre dışı bırakır (kapalı). Arabelleğe alma açık olduğunda, Yönlendirici, Mesaj İşleyiciye göndermeden önce istek gövdesinin tamamını arabelleğe alır. Hata varsa yönlendirici farklı bir Mesaj İşleyen'i yeniden deneyebilir. Bu ayar kapalıysa arabelleğe alma devre dışı bırakılır ve isteğin gövdesi, alındığında hemen Mesaj İşleyen'e gönderilir. Bir hata oluşursa Yönlendirici, isteği başka bir Mesaj İşleyen'e yeniden göndermez. |
CANNOT TRANSLATE | Hayır | ||||||||||||
proxy_buffering | Yanıtın arabelleğe alınmasını etkinleştirir (açık) veya devre dışı bırakır (kapalı). Aktarıcı, arabelleğe alma açıkken yanıtı arabelleğe alır. Arabelleğe alma kapalı olduğunda yanıt, istemciye eşzamanlı olarak ve Yönlendirici tarafından alınır alınmaz iletilir. | CANNOT TRANSLATE | Hayır |