SSO Provider Ekleme Paneli

Genel Bakış

SSO Provider Ekleme paneli, harici kimlik sağlayıcılarını platforma kaydetmek için kullanılan bir yapılandırma sihirbazıdır. Bu panel; güvenli istemci uygulamalarının eşleştirilmesini, endpoint keşif protokollerinin yapılandırılmasını ve harici kimlik sağlayıcısından (IdP) dönen kimlik bilgilerinin yerel platform kullanıcı profilleriyle eşleştirilmesini sağlar.

Platform şu anda aşağıdaki SSO sağlayıcılarını desteklemektedir:

• Google
• Okta
• Microsoft Azure / Microsoft Entra ID
• Keycloak

Panel Yapılandırma Bölümleri

Erişim Gereksinimleri

Bu sayfa yalnızca Administrator yetkisine sahip kullanıcılar tarafından kullanılabilir.

Yalnızca yöneticiler SSO Provider yapılandırmalarını görüntüleyebilir ve yönetebilir. Yönetici yetkisine sahip olmayan kullanıcılar bu sayfaya erişemez.

Yönetici yetkisi olmayan kullanıcılar aşağıdaki yetkilendirme hatasıyla karşılaşır:

Access Denied

You don't have access to this resource.

Kullanıcı Alanları

Giriş arayüzü; bağlantı yapılandırmaları, kullanıcı öznitelik eşleştirmeleri ve doğrulama yapılandırmaları olmak üzere mantıksal bölümlere ayrılmıştır.

1. Bağlantı Parametreleri

Kimlik sağlayıcı ile kimlik doğrulama akışlarının doğru şekilde gerçekleştirilebilmesi için gerekli temel yapılandırma alanları:

• Provider: Hedef kimlik sağlayıcının seçildiği açılır menüdür.
• Base URL: Kimlik sağlayıcının ana domain veya sunucu adresidir.
• Well-Known Endpoint: Kimlik sağlayıcının OpenID Connect / OAuth2 metadata bilgilerini otomatik olarak almak için kullanılan yapılandırma keşif URL'sidir.
• Client Id: Harici kimlik sağlayıcı tarafından DataFloem için atanan benzersiz uygulama kimliğidir.
• Client Secret: Kimlik doğrulama sırasında kullanılan korumalı istemci kimlik bilgisidir. Göz simgesi kullanılarak görünürlüğü değiştirilebilir.
• Is Active: SSO entegrasyonunun oluşturulduktan sonra aktif olup olmadığını belirleyen ana açma/kapatma anahtarıdır.

2. Kullanıcı Öznitelikleri

Harici IdP tarafından döndürülen kimlik bilgileri ve kullanıcı claim'lerinin DataFloem içerisindeki kullanıcı hesaplarına nasıl aktarılacağını belirler:

• Username: Platformdaki kullanıcı giriş kimliğini temsil edecek uzak kimlik sağlayıcı claim'ini belirler.
• First Name / Last Name: Kullanıcının profilindeki ad ve soyad alanlarını doldurmak için kullanılacak claim'leri belirler.
• Email: Kullanıcının kurumsal e-posta adresini içeren token alanını belirler.

3. Doğrulama Parametreleri

Yöneticilerin özel claim doğrulamaları, audience kısıtlamaları veya isteğe bağlı parametreler eklemesine olanak sağlayan dinamik bir Key / Value matrisidir.

Ek doğrulama parametreleri + butonu kullanılarak eklenebilir. Mevcut parametreler ise 🗑️ butonu kullanılarak silinebilir.

Kimlik Sağlayıcı Yapılandırması

DataFloem üzerinde bir SSO Provider kaydedilmeden önce, seçilen kimlik sağlayıcı üzerinde ilgili uygulama/client oluşturulmalı ve yapılandırılmalıdır.

Aşağıdaki callback URL kullanılmalıdır:

<base_url>/api/v1/public/authentication/external-token-exchange

Örneğin:

http://10.34.41.235:30242/api/v1/public/authentication/external-token-exchange

Önemli: <base_url> değerini hedef ortamın gerçek DataFloem base URL'si ile değiştirin. Production ortamlarında uygun HTTPS URL'sini kullanın.

Google

Google için bir OAuth 2.0 Client oluşturun ve callback URL'sini Authorized redirect URIs bölümünde yapılandırın.

Aşağıdaki URI'yi ekleyin:

<base_url>/api/v1/public/authentication/external-token-exchange

Örnek:

https://datafloem.example.com/api/v1/public/authentication/external-token-exchange

Callback URL, uygulama tarafından kullanılan redirect URI ile birebir aynı olmalıdır. Scheme (http / https), hostname, path veya sondaki slash gibi farklılıklar redirect_uri_mismatch hatasına neden olabilir.

Okta

Okta için bir OIDC - OpenID Connect uygulama entegrasyonu oluşturun ve callback URL'sini Sign-in redirect URIs bölümünde yapılandırın.

Aşağıdaki URI'yi ekleyin:

<base_url>/api/v1/public/authentication/external-token-exchange

Örnek:

https://datafloem.example.com/api/v1/public/authentication/external-token-exchange

Yapılandırılan URI, kimlik doğrulama sırasında DataFloem tarafından gönderilen redirect URI ile eşleşmelidir.

Microsoft Azure / Microsoft Entra ID

Azure için Microsoft Entra ID üzerinde bir uygulama kaydedin ve redirect URI'yi aşağıdaki bölümden yapılandırın:

Authentication → Platform configurations → Web → Redirect URI

Aşağıdaki URI'yi ekleyin:

<base_url>/api/v1/public/authentication/external-token-exchange

Örnek:

https://datafloem.example.com/api/v1/public/authentication/external-token-exchange

Sunucu taraflı kimlik doğrulama akışı kullanıldığında uygulama Web uygulaması olarak yapılandırılmalıdır.

Keycloak

Keycloak için client oluşturun/yapılandırın ve callback URL'sini Valid Redirect URIs bölümüne ekleyin.

Aşağıdaki URI'yi ekleyin:

<base_url>/api/v1/public/authentication/external-token-exchange

Örnek:

https://datafloem.example.com/api/v1/public/authentication/external-token-exchange

Keycloak, yapılandırılan redirect URI'leri büyük/küçük harfe duyarlı şekilde eşleştirir. Redirect URI'ler mümkün olduğunca spesifik olmalıdır. Production ortamlarında * gibi geniş wildcard desenlerinin kullanılmasından kaçının.

Callback URL Özeti

Desteklenen tüm sağlayıcılar için aynı DataFloem callback endpoint'i kullanılır:

Kurulum Süreci

1. Seçilen kimlik sağlayıcı üzerinde bir uygulama/client oluşturun:

   • Google
   • Okta
   • Microsoft Azure / Microsoft Entra ID
   • Keycloak

2. Sağlayıcının redirect/callback URI'sini aşağıdaki değer ile yapılandırın:

   <base_url>/api/v1/public/authentication/external-token-exchange

3. Kimlik sağlayıcıdan gerekli client bilgilerini alın:

   • Client ID
   • Client Secret

4. Varsa, sağlayıcının OpenID Connect discovery endpoint'ini (Well-Known Endpoint) alın.

5. DataFloem içerisindeki SSO Provider Ekleme panelini açın.

6. Uygun Provider seçimini yapın.

7. Bağlantı Parametreleri alanlarını doldurun:

   • Base URL
   • Well-Known Endpoint
   • Client Id
   • Client Secret
   • Is Active

8. Kullanıcı Öznitelikleri eşleştirmelerini yapılandırın:

   • Username
   • First Name
   • Last Name
   • Email

9. Gerekli Doğrulama Parametrelerini yapılandırın.

10. SSO entegrasyonunu oluşturmak için Save butonuna tıklayın.

11. Yapılandırmayı kaydetmeden iptal etmek için Cancel butonuna tıklayın.