Kurumsal SSO Kurulum Rehberi

Tek Oturum Açma (SSO), ekip üyelerinizin FlowHunt’a kuruluşunuzun mevcut kimlik sağlayıcısını (IdP) kullanarak erişmesini sağlar. Bu rehber, kurumsal FlowHunt hesabınız için SSO entegrasyonunu kurma sürecinde sizi adım adım yönlendirir.

Önkoşullar

SSO kurulum sürecine başlamadan önce aşağıdakilere sahip olduğunuzdan emin olun:

• Aktif bir FlowHunt Kurumsal planı
• Kuruluşunuzun Microsoft Azure AD / Entra ID’sine yönetici erişimi
• FlowHunt Çalışma Alanında sahiplik
• Alan adınızın sahipliğini doğrulamak için DNS Sağlayıcınızın paneline erişim

Yapılandırma Adımları

Adım 1: FlowHunt’ta SSO Ayarlarına Erişin

1. FlowHunt hesabınıza yönetici olarak giriş yapın
2. Genel Ayarlar > Kimlik Doğrulama bölümüne gidin
3. İlgili Kimlik Sağlayıcıya SSO’yu Yapılandır düğmesine tıklayarak erişin

Adım 2: Microsoft Azure AD / Entra ID’nizi Seçin

SSO’nun varsayılan olarak etkin olduğunu göreceksiniz.

Adım 3: FlowHunt SSO Bilgilerini Toplayın

FlowHunt SSO ayarları sayfasından Assertion Consumer Service (ACS) URL‘sini kopyalayın.

Adım 4: Kimlik Sağlayıcınızı Yapılandırın

1. Azure portalına giriş yapın
2. Azure Active Directory > Kurumsal uygulamalar > Yeni uygulama yolunu izleyin

3. Kendi uygulamanızı oluşturun seçeneğini seçin

4. Ad olarak “FlowHunt” girin ve “Galeri’de bulamadığınız herhangi bir uygulamayı entegre edin” seçeneğini seçin
5. Tek oturum açmayı ayarla seçeneğine tıklayın
6. Temel SAML Yapılandırmasını yapın:
   • Tanımlayıcı (Entity ID): https://www.flowhunt.io olarak ayarlayın
   • Yanıt URL’si: FlowHunt’tan aldığınız Assertion Consumer Service (ACS) URL‘si olarak ayarlayın
7. Kullanıcı Öznitelikleri & Talepler bölümünde aşağıdaki özniteliklerin eşlendiğinden emin olun. Varsayılan ayar doğru olmalıdır:
   • Name ID: user.mail (e-posta adresi)
   • İsim: user.givenname
   • Soyadı: user.surname
   • E-posta: user.mail
8. Sertifika (Base64) dosyasını indirin
9. FlowHunt Test SSO'yu Ayarlayın bölümünden Giriş URL’sini kopyalayın

Adım 7: FlowHunt SSO’yu Yapılandırın

1. FlowHunt’a geri dönün
2. IdP SSO URL seçeneğini seçin ve Microsoft Entra ID’den Login URL kısmından kopyaladığınız URL’yi IdP SSO URL alanına yapıştırın
3. Entra ID sayfasındaki Microsoft Entra Identifier alanındaki değeri IdP Entity ID alanına yapıştırın
4. İndirdiğiniz Certificate (Base64) dosyasının içeriğini IdP Certificate alanına yapıştırın. İçerik büyük ihtimalle -----BEGIN CERTIFICATE----- ile başlayıp -----END CERTIFICATE----- ile bitecektir
5. Alan adınızı doğrulamak için “Alanı doğrula” düğmesine tıklayın ve yönergeleri izleyin. DNS sağlayıcınıza bir TXT kaydı eklemeniz gerekecek.

6. Alan adı doğrulama işlemi başarılı olduktan sonra SAML Ayarlarını Güncelle düğmesine tıklayın. Bir sonraki bölümde, SAML Ayarları kısmında SSO yapılandırmanızı daha da özelleştirmek için kullanabileceğiniz isteğe bağlı ayarları açıklayacağız.

Adım 8: Gelişmiş SAML Yapılandırması (İsteğe Bağlı)

Giriş Yöntemi

Herhangi Bir Yöntem olarak ayarlanırsa, kullanıcılar SSO veya kullanıcı adı/şifre ile giriş yapabilir. SSO'yu Zorunlu Kıl olarak ayarlanırsa, kullanıcılar giriş yapmak için SSO kullanmalıdır.

Otomatik Hesap Oluşturma (Just-in-Time Provisioning)

Etkinleştirilirse, FlowHunt ilk kez giriş yapan kullanıcılar için otomatik olarak yeni bir hesap oluşturur. Devre dışı bırakılırsa, kullanıcıların FlowHunt’a manuel olarak eklenmesi gerekir.

Sorun Giderme

SSO kurulum sürecinde sorunlarla karşılaşırsanız:

Yaygın Sorunlar ve Çözümleri

1. “Geçersiz SAML Yanıtı” Hatası

   • IdP sunucunuzdaki saatin senkronize olduğundan emin olun
   • Entity ID ve ACS URL’nin doğru yapılandırıldığını kontrol edin

2. Kullanıcılar SSO ile Giriş Yaptıktan Sonra FlowHunt’a Erişemiyor

   • Kullanıcıların IdP’nizde FlowHunt uygulamasına atandığından emin olun
   • Kullanıcı e-posta adreslerinin IdP ve FlowHunt arasında eşleştiğini doğrulayın

3. Öznitelik Eşleme Sorunları

   • Gerekli özniteliklerin (email, firstName, lastName) doğru şekilde eşlendiğinden emin olun
   • Öznitelik adlarında büyük/küçük harf duyarlılığı sorunlarını kontrol edin

Yardım Alma

SSO yapılandırmanızda yaşamaya devam ettiğiniz sorunlar varsa:

1. FlowHunt Destek ile support@flowhunt.io adresinden iletişime geçin
2. Destek talebinize aşağıdaki bilgileri ekleyin:
   • Kuruluş adınız
   • Kimlik sağlayıcı adı
   • Belirli hata mesajları
   • Yapılandırma ekran görüntüleri (gizli bilgileri karartın)