Private Cloud için Edge'de SAML'yi destekleme

Edge for Private Cloud 4.19.01 sürümü

Edge kullanıcı arayüzü ve Edge Management API, Edge Management Server'a istek göndererek çalışır. Management Server aşağıdaki kimlik doğrulama türlerini destekler:

  • Temel Kimlik Doğrulama Kullanıcı adınızı ve şifrenizi girerek Edge kullanıcı arayüzüne giriş yapın veya Edge Management API'ye istek gönderin.
  • OAuth2 Edge Basic Auth kimlik bilgilerinizi bir OAuth2 erişim jetonu ve yenileme jetonuyla değiştirin. Bir API çağrısının Bearer başlığında OAuth2 erişim jetonunu ileterek Edge Management API'ye çağrı yapın.

Edge, kimlik doğrulama mekanizması olarak Güvenlik Onayı Biçimlendirme Dili (SAML) 2.0'ı da destekler. SAML etkinleştirildiğinde Edge kullanıcı arayüzüne ve Edge Management API'ye erişim için OAuth2 erişim jetonları kullanılmaya devam eder. Ancak artık bu jetonları bir SAML kimlik sağlayıcısı tarafından döndürülen SAML onaylarından oluşturabilirsiniz.

SAML, tek oturum açma (TOA) ortamını destekler. Edge ile SAML'yi kullanarak Edge kullanıcı arayüzü ve API'si için TOA'yı destekleyebilirsiniz. Ayrıca, sağladığınız ve SAML'yi destekleyen diğer hizmetler için de TOA'yı destekleyebilirsiniz.

Edge for Private Cloud için OAuth2 desteği eklendi

Yukarıda belirtildiği gibi, SAML'nin Edge uygulaması OAuth2 erişim jetonlarına dayanır.Bu nedenle, Edge for Private Cloud'a OAuth2 desteği eklenmiştir. Daha fazla bilgi için OAuth 2.0'a giriş başlıklı makaleyi inceleyin.

SAML'nin avantajları

SAML kimlik doğrulamasının çeşitli avantajları vardır. SAML'yi kullanarak şunları yapabilirsiniz:

  • Kullanıcı yönetiminin tam kontrolünü elinize alın. Kullanıcılar kuruluşunuzdan ayrıldığında ve temel hazırlıkları merkezi olarak kaldırıldığında Edge'e erişimleri otomatik olarak reddedilir.
  • Kullanıcıların Edge'e erişmek için nasıl kimlik doğrulayacağını kontrol edin. Farklı Edge kuruluşları için farklı kimlik doğrulama türleri seçebilirsiniz.
  • Kimlik doğrulama politikalarını kontrol etme SAML sağlayıcınız, kurumsal standartlarınıza daha uygun kimlik doğrulama politikalarını destekleyebilir.
  • Edge dağıtımınızda girişleri, çıkışları, başarısız giriş denemelerini ve yüksek riskli etkinlikleri izleyebilirsiniz.

Edge ile SAML kullanma

Edge'de SAML'yi desteklemek için Edge TOA modülü olan apigee-sso'i yüklemeniz gerekir. Aşağıdaki resimde, Edge for Private Cloud kurulumunda Edge TOA gösterilmektedir:

Edge TOA modülünü Edge kullanıcı arayüzü ve Yönetim Sunucusu ile aynı düğüme veya kendi düğümüne yükleyebilirsiniz. Edge TOA'nın 8080 numaralı bağlantı noktası üzerinden Yönetim Sunucusu'na erişebildiğinden emin olun.

Edge TOA'ya bir tarayıcıdan, harici SAML IdP'den, Yönetim Sunucusu'ndan ve Edge kullanıcı arayüzünden erişimi desteklemek için Edge TOA düğümünde 9099 numaralı bağlantı noktasının açık olması gerekir. Edge TOA'yı yapılandırırken harici bağlantının HTTP veya şifrelenmiş HTTPS protokolünü kullanacağını belirtebilirsiniz.

Edge TOA, Postgres düğümündeki 5432 numaralı bağlantı noktasından erişilebilen bir Postgres veritabanı kullanır. Genellikle Edge ile yüklediğiniz Postgres sunucusunu (bağımsız bir Postgres sunucusu veya ana/bekleme modunda yapılandırılmış iki Postgres sunucusu) kullanabilirsiniz. Postgres sunucunuzdaki yük yüksekse yalnızca Edge TOA için ayrı bir Postgres düğümü oluşturmayı da seçebilirsiniz.

SAML etkinleştirildiğinde Edge kullanıcı arayüzüne ve Edge Management API'ye erişim için OAuth2 erişim jetonları kullanılır. Bu jetonlar, IdP'niz tarafından döndürülen SAML onaylarını kabul eden Edge TOA modülü tarafından oluşturulur.

SAML onayından oluşturulan OAuth jetonu 30 dakika, yenileme jetonu ise 24 saat boyunca geçerlidir. Geliştirme ortamınız, daha uzun süreli jetonlar gerektiren test otomasyonu veya sürekli entegrasyon/sürekli dağıtım (CI/CD) gibi yaygın geliştirme görevleri için otomasyonu destekleyebilir. Otomatik görevler için özel jetonlar oluşturma hakkında bilgi edinmek üzere Otomatik görevlerle SAML kullanma başlıklı makaleyi inceleyin.

Edge kullanıcı arayüzü ve API URL'leri

Edge kullanıcı arayüzüne ve Edge Management API'ye erişmek için kullandığınız URL, SAML'yi etkinleştirmeden önce kullandığınız URL ile aynıdır. Edge kullanıcı arayüzü için:

http://edge_ui_IP_DNS:9000
https://edge_ui_IP_DNS:9000

Burada edge_ui_IP_DNS, Edge kullanıcı arayüzünü barındıran makinenin IP adresi veya DNS adıdır. Edge kullanıcı arayüzünü yapılandırırken bağlantının HTTP veya şifrelenmiş HTTPS protokolünü kullanacağını belirtebilirsiniz.

Edge Management API için:

http://ms_IP_DNS:8080/v1
https://ms_IP_DNS:8080/v1

Burada ms_IP_DNS, yönetim sunucusunun IP adresi veya DNS adıdır. API'yi yapılandırırken bağlantının HTTP veya şifrelenmiş HTTPS protokolünü kullanacağını belirtebilirsiniz.

Edge TOA'da TLS'yi yapılandırma

Varsayılan olarak, Edge TOA bağlantısı, Edge TOA modülü olan apigee-sso'u barındıran düğümde 9099 numaralı bağlantı noktası üzerinden HTTP kullanır. apigee-sso, HTTP ve HTTPS isteklerini işleyen bir Tomcat örneği içerir.

Edge TOA ve Tomcat üç bağlantı modunu destekler:

  • DEFAULT: Varsayılan yapılandırma, 9099 numaralı bağlantı noktasındaki HTTP isteklerini destekler.
  • SSL_TERMINATION: Seçtiğiniz bağlantı noktasında Edge TOA'ya TLS erişimini etkinleştirir. Bu mod için bir TLS anahtarı ve sertifikası belirtmeniz gerekir.
  • SSL_PROXY: Edge TOA'yı proxy modunda yapılandırır. Bu, apigee-sso'nin önüne bir yük dengeleyici yüklediğiniz ve yük dengeleyicide TLS'yi sonlandırdığınız anlamına gelir. Yük dengeleyiciden gelen istekler için apigee-sso üzerinde kullanılan bağlantı noktasını belirtebilirsiniz.

Portal için SAML desteğini etkinleştirme

Edge için SAML desteğini etkinleştirdikten sonra, isterseniz Apigee Geliştirici Hizmetleri portalı (veya kısaca portal) için SAML'yi etkinleştirebilirsiniz. Portal, Edge'e istek gönderirken SAML kimlik doğrulamasını destekler. Bu, geliştiricinin portalda oturum açması için kullanılan SAML kimlik doğrulamasından farklıdır. Geliştirici girişi için SAML kimlik doğrulamasını ayrı olarak yapılandırırsınız. Daha fazla bilgi için Portalı, Edge ile iletişim kurmak için SAML kullanacak şekilde yapılandırma başlıklı makaleyi inceleyin.

Portalı yapılandırırken Edge ile yüklediğiniz Edge TOA modülünün URL'sini belirtmeniz gerekir: