Alanınızı özelleştirin

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. info

Geliştirici portalı oluşturduğunuzda varsayılan olarak, canlı portalınıza aşağıdaki biçimde erişmek için bir Apigee örnek alan adı sağlanır:

https://orgname-portalname.apigee.io

Burada orgname kuruluş adı, portalname ise portal adı kullanılarak tanımlanır. Portal adı küçük harfe dönüştürülür, boşluklar ve kısa çizgiler kaldırılır.

Geliştirici portalı oluşturmadan önce kendi özel alan adınızı sağlamanız önerilir. Örneğin, popüler bir alternatif:

https://developers.example.com

SAML kimlik sağlayıcısıyla özel alan kullanmayla ilgili dikkat edilmesi gereken noktalar için SAML sağlayıcısıyla özel alan kullanma başlıklı makaleyi inceleyin.

Aşağıdaki bölümlerde alanınızı nasıl özelleştireceğiniz açıklanmaktadır.

Alan adınızı özelleştirme (Apigee Edge)

Apigee Edge entegre portallarında alan adınızı özelleştirmek için aşağıdaki adımları uygulayın:

1. Alan adınızı kaydedin.
2. TLS'yi yapılandırın.
3. Portalınıza özel alan adı ekleyin.
4. DNS'nizi yapılandırın.

Özel alan adı ekledikten sonra bu alanı düzenleyebilir veya devre dışı bırakabilirsiniz. Sorun gidermeyle ilgili yardım için Özel alanınızla ilgili sorunları giderme başlıklı makaleyi inceleyin.

1. Adım: Alan adınızı kaydettirin

Yeni bir alan adı kaydettirmeniz gerekiyorsa Google Domains gibi birçok popüler alan kaydı sitesi mevcuttur. Hangi alan kaydı sitesini seçeceğiniz size bağlıdır.

Alan adınıza karar verirken, kullanıcı tarafından okunabilen, kullanıcı tarafından okunabilen URL'lerin, Arama motoru optimizasyonunu (SEO) uygulama başlıklı makalede açıklandığı gibi, arama motoru optimizasyonunu iyileştirmede önemli bir bileşen olduğunu göz önünde bulundurun.

2. adım: TLS'yi yapılandırın

HTTPS'yi desteklemek için aşağıdaki prosedürde açıklandığı gibi, portal ortamında gerekli dijital sertifikaları içeren anahtar depoları ve takma adlar oluşturarak TLS'yi yapılandırmanız gerekir.

TLS'yi yapılandırmak için:

1. Google Trust Services gibi saygın bir sertifika yetkilisinden TLS sertifikası satın alın. Hangi sertifika yetkilisini seçeceğinize siz karar verirsiniz.
2. https://apigee.com/edge adresinde oturum açın.
3. Kullanıcı profili menünüzden kuruluşunuzu seçin.
4. TLS anahtar depoları sayfasını görüntülemek için Yönetici > Ortam > TLS Anahtar Depoları'nı seçin.

5. Ortam açılır menüsünden portal'ı seçin.

   

6. Edge kullanıcı arayüzünü kullanarak anahtar deposu ve güven deposu oluşturma bölümünde açıklandığı gibi bir anahtar deposu ve takma ad oluşturun.

3. adım: Portalınıza özel bir alan adı ekleyin

Portalınıza özel bir alan adı eklediğinizde sistem sizin için aşağıdaki kaynakları oluşturur (api.example.com gibi bir uç noktaya özel alan adı uygulamak için kullanılan aynı işlevi kullanarak):

• Belirttiğiniz özel alan adını kullanarak 443 numaralı bağlantı noktasında dinleyen bir sanal ana makine.

• Hedef uç noktası varsayılan portal alanına ayarlanmış özel alan URL'sini kullanan bir API proxy'si. API proxy'sinin adı, noktaların alt çizgiyle değiştirildiği özel alan adıyla eşleşir. API proxy'si portal ortamına dağıtılır.

Portalınıza özel alan adı eklemek için:

1. Yayınla > Portallar'ı ve portalınızı seçin.
2. Üst gezinme çubuğundaki veya açılış sayfasındaki açılır menüden Ayarlar'ı seçin.
3. Alanlar sekmesini tıklayın.
4. Custom Domains (Özel Alan) altında, aşağıdaki alanları doldurun.
   

   Alan	Açıklama
   Anahtar deposu	Açılır listeden bir anahtar mağazası seçin. Not: Liste, 2. adımda portal ortamında oluşturduğunuz anahtar depoları kullanılarak doldurulur. Bir anahtar mağazası seçtikten sonra Takma ad alanı gösterilir.
   Takma ad	Açılır listeden geçerli bir takma ad seçin. Not: Liste, seçilen anahtar deposu için oluşturduğunuz takma adlar kullanılarak doldurulur. Geçersiz sertifika zincirlerine, Apigee alanlarına veya güvence depolarına sahip anahtar depoları bu listeye dahil edilmez. Listedeki bir sertifikanın geçerlilik süresinin ne zaman dolacağını belirlemek için: Simgeleri görüntüleyin: Sertifikanın süresi 30 günden uzun bir süre sonra doluyor veya seçilen özel alan zaten kullanılıyor olabilir. Sertifikanın geçerlilik süresi 30 gün sonra dolar. Sertifika süresi doldu. Sertifikanın geçerlilik süresinin kalan gün sayısını görüntülemek için imlecinizi bir takma adın üzerine getirin. Bir takma ad seçtikten sonra Alan alanı gösterilir.
   Alan	Açılır listeden bir alan seçin. Joker karakter takma adı seçtiyseniz alt alan adını girin. Not: Alan listesi, seçilen takma ad tarafından tanımlanan zincirdeki üst düzey sertifika için ortak ve alternatif adlar kullanılarak doldurulur.

   Tüm alanları doldurduktan sonra Özel Alan durum simgesi aşağıdaki gibi güncellenir:

   Durum	Açıklama
   	Anahtar kasası, takma ad ve özel alan geçerli olmalıdır.
   	Sertifikanın geçerlilik süresi 30 gün sonra dolacaktır.
   	Anahtar anahtarı, takma ad ve özel alan geçersiz.

   Ayrıca, DNS yapılandırması doğrulanır ve DNS yapılandırması simgesi aşağıdaki gibi güncellenir:

   Durum	Açıklama
   	DNS yapılandırması geçerlidir.
   	DNS yapılandırması geçerli değil. DNS'nizi DNS'nizi yapılandırma bölümünde açıklandığı şekilde yapılandırmanız gerekir.

5. Etkinleştir'i (veya düzenleme yapıyorsanız Kaydet'i) tıklayın.
   Özel alan veya DNS yapılandırması geçersiz olsa bile özel alanınızı etkinleştirebilirsiniz.

4. adım: DNS'nizi yapılandırın

Ardından, {org_name}-portal.apigee.net adresini işaretlemek için alan adınızın DNS'sine bir standart ad (CNAME) kaydı eklemeniz gerekir.

CNAME değerini onaylamak için:

1. Yayınla > Portallar'ı ve portalınızı seçin.
2. Üst gezinme çubuğundaki veya açılış sayfasındaki açılır menüden Ayarlar'ı seçin.
3. Alanlar sekmesini tıklayın.
4. Kuruluşunuzun CNAME değerini, aşağıdaki şekilde gösterildiği gibi DNS'yi Yapılandır bölümünde görüntüleyin:

Aşağıda, yukarıda gösterilen özel alan (yani myorg kuruluşundaki developers.example.com özel alanı) için yapılandıracağınız CNAME kaydının örneği verilmiştir:

developers.example.com. CNAME myorg-portal.apigee.net.

Özel alanınızla ilgili sorunları giderme

Aşağıdaki bölümlerde, özel alanınızla ilgili sorunları gidermeyle ilgili öneriler verilmiştir.

Sorun giderme: dig kullanarak alanınızın DNS kurulumunu doğrulama

Alanınızın DNS'si CNAME kaydını içerecek şekilde güncellendikten sonra değişikliklerin dünya genelindeki diğer DNS sunucularına yayılması zaman alır. dig'i kullanarak CNAME kaydının diğer DNS sunucularına tam olarak yayılmadan önce bile doğru şekilde ayarlandığını doğrulamak için alan DNS sunucunuzu sorgulayabilirsiniz.

Örneğin, aşağıdaki dig komutu alan DNS sunucunuzu sorgular. Komut çıktısında ANSWER SECTION, CNAME kaydı girişini içerir.

$ dig @your.domain.dns developer.mycompany.com
; <<>> DiG 9.8.3-P1 <<>> @your.domain.dns developer.mycompany.com
; (1 server found)
;; global options:  cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 41356
;; flags: qr rd ra; QUERY: 1, ANSWER: 3, AUTHORITY: 0, ADDITIONAL: 0
;; WARNING: recursion requested but not available

;; QUESTION SECTION:
;developer.mycompany.com.       IN  A

;; ANSWER SECTION:
developer.mycompany.com.    29  IN  CNAME   myorg-portal.apigee.net.

;; Query time: 141 msec
;; SERVER: 192.168.1.254#53(192.168.1.254)
;; WHEN: Mon Mar 20 16:41:59 2017
;; MSG SIZE  rcvd: 136

Sorun giderme: Ana makine için proxy tanımlanamıyor

Portalınıza özel bir alan adı eklediğinizde varsayılan olarak, hedef uç noktası varsayılan portal alanına ayarlanmış özel alan URL'sini kullanan bir API proxy'si oluşturulur. Özel alanla ilişkili API proxy'sini değiştirirseniz veya silerseniz özel alan yapılandırması geçersiz hale gelir ve özel alan URL'sine erişmeye çalışırken Unable to identify proxy for host hata mesajı alırsınız. Örneğin:

{"fault":{"faultstring":"Unable to identify proxy for host: developers.mycompany.com:443 and url: \/","detail":{"errorcode":"messaging.adaptors.http.flow.ApplicationNotFound"}}}

API proxy'sinin değiştirilmesi veya silinmesi durumunda özel alan yapılandırmasını geri yüklemek için:

1. Yayınla > Portallar'ı ve portalınızı seçin.
2. Üst gezinme çubuğundaki veya açılış sayfasındaki açılır menüden Ayarlar'ı seçin.
3. Alanlar sekmesini tıklayın.
4. API proxy'sini geri yüklemek için Kaydet'i tıklayın.

Sertifikanızı güncelleme

TLS sertifikalarını güncelleme hakkında genel bilgi için TLS sertifikasını güncelleme başlıklı makaleyi inceleyin.

1. 2. Adım: TLS'yi yapılandırın bölümündeki adımları uygulayın.
2. 3. Adım: Portalınıza özel bir alan adı ekleyin bölümündeki adımları uygulayın