SAML veya OIDC ile Tekli Oturum Açmayı (SSO) Yapılandırma

ScribbleMaps, SAML 2.0 veya OpenID Connect (OIDC) kullanarak kurumsal Tekli Oturum Açmayı destekler. Bu, ekip üyelerinizin Okta, Microsoft Entra ID (Azure AD), Google Workspace, veya Auth0 gibi kuruluşunuzun Kimlik Sağlayıcısını (IdP) kullanarak kimlik doğrulaması yapmasına olanak tanır.

SSO yapılandırması team.scribblemaps.com adresinde mevcuttur ve tamamen ücretsizdir.

İçindekiler

1. Desteklenen Özellikler
2. Başlamadan Önce
3. Adım 1: E-posta Alan Adınızı Doğrulayın
4. Adım 2: Kimlik Sağlayıcınızı Yapılandırın
5. Adım 3: ScribbleMaps'te SSO'yu Yapılandırın
6. Adım 4: Yapılandırmanızı Test Edin
7. Adım 5: SSO'yu Etkinleştirin
8. SP Tarafından Başlatılan SSO
9. OIN Evrensel Oturumu Kapatma
10. Sağlayıcıya Özel Kılavuzlar
11. Gelişmiş Seçenekler
12. Sorun Giderme

Desteklenen Özellikler

ScribbleMaps SSO entegrasyonu aşağıdaki özellikleri destekler:

Başlamadan Önce

• SSO'yu yapılandırmak için Team Owner olmalısınız
• Kuruluşunuzun Kimlik Sağlayıcı yönetici konsoluna erişiminiz olmalıdır
• E-posta alan adınızı hazır bulundurun (örneğin, yourcompany.com)

Adım 1: E-posta Alan Adınızı Doğrulayın

SSO'yu yapılandırmadan önce, e-posta alan adınızın sahipliğini doğrulamanız gerekir. Bu güvenlik önlemi, yalnızca yetkili kuruluşların kendi alan adları için SSO yapılandırmasını sağlar.

1. team.scribblemaps.com adresinde oturum açın
2. Settings > Single Sign-On bölümüne gidin
3. Domains sekmesine gidin
4. Add Domain seçeneğine tıklayın ve e-posta alan adınızı girin (örneğin, yourcompany.com)
5. Bir doğrulama yöntemi seçin:

Seçenek A: DNS TXT Kaydı (Önerilen)

Alan adınızın DNS ayarlarına bir TXT kaydı ekleyin:

Not: DNS değişikliklerinin yayılması 48 saate kadar sürebilir.

Seçenek B: Dosya Yükleme

1. scribblemaps-verify.txt adında bir metin dosyası oluşturun
2. Tek içerik olarak doğrulama kodunuzu ekleyin
3. Şuraya yükleyin: https://yourcompany.com/.well-known/scribblemaps-verify.txt

Doğrulamayı ekledikten sonra, sahipliği onaylamak için Verify Domain seçeneğine tıklayın.

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

ScribbleMaps'i Kimlik Sağlayıcınıza bir uygulama olarak ekleyin. Okta kullanıyorsanız, ScribbleMaps'i doğrudan Okta Integration Network (OIN) kataloğundan ekleyebilirsiniz — SAML SSO URL'si, SP Entity ID, ACS URL'si ve OIDC Redirect URI'si otomatik olarak önceden yapılandırılmıştır.

SAML 2.0 için

OIDC için

Adım 3: ScribbleMaps'te SSO'yu Yapılandırın

SAML 2.0 Yapılandırması

1. ScribbleMaps'te Settings > Single Sign-On > SAML sekmesine gidin
2. Kimlik Sağlayıcınızdan aşağıdaki bilgileri girin:

3. Save Settings seçeneğine tıklayın

OIDC Yapılandırması

1. ScribbleMaps'te Settings > Single Sign-On > OIDC sekmesine gidin
2. Provider Type seçeneğinizi belirleyin (Google, Microsoft, Okta, Auth0 veya Custom)
3. Aşağıdaki bilgileri girin:

4. Save Settings seçeneğine tıklayın

Adım 4: Yapılandırmanızı Test Edin

Tüm kullanıcılar için SSO'yu etkinleştirmeden önce yapılandırmanızı test edin:

1. Test Connection düğmesine tıklayın
2. SSO oturum açma akışını simüle etmek için yeni bir pencere açılacaktır
3. Kimlik Sağlayıcınızla kimlik doğrulamasını tamamlayın
4. ScribbleMaps'e başarıyla geri yönlendirildiğinizi doğrulayın

Test başarısız olursa, hata mesajını inceleyin ve yapılandırma ayarlarınızı kontrol edin.

Adım 5: SSO'yu Etkinleştirin

Test başarılı olduğunda:

1. Enable SSO anahtarını ON konumuna getirin
2. Zorunluluk seçeneğinizi belirleyin:
   • Optional: Kullanıcılar SSO veya şifre ile girişi seçebilirler
   • Enforced: Doğrulanmış e-posta alan adlarına sahip kullanıcılar SSO kullanmalıdır (şifre ile giriş devre dışı bırakılır)

Not: Team Owners, SSO zorunlu kılınmış olsa bile her zaman yedek olarak şifre ile girişi kullanabilirler.

SP Tarafından Başlatılan SSO

ScribbleMaps, kullanıcıların oturum açma sürecini ScribbleMaps giriş sayfasından başlatmasına olanak tanıyan SP tarafından başlatılan SSO'yu destekler. İşte nasıl çalıştığı:

1. scribblemaps.com/account/login adresine gidin
2. E-posta adresinizi girin (örneğin, [email protected])
3. Sign in with SSO seçeneğine tıklayın
4. Kimlik doğrulaması yapmak için kuruluşunuzun Kimlik Sağlayıcısına (örneğin, Okta) yönlendirileceksiniz
5. Başarılı kimlik doğrulamasından sonra, otomatik olarak ScribbleMaps'e geri yönlendirilir ve oturum açarsınız

Kuruluşunuzda SSO zorunlu kılınmışsa, giriş sayfasında e-posta adresinizi girdiğinizde otomatik olarak Kimlik Sağlayıcınıza yönlendirilirsiniz — şifre alanı gösterilmez.

OIN Evrensel Oturumu Kapatma

Okta tarafından sunulan evrensel oturumu kapatma (Universal logout) desteklenmektedir. Yapılandırma talimatları için lütfen bu bağlantıyı ziyaret edin.

Sağlayıcıya Özel Kılavuzlar

Okta

1. Okta Admin Console'da Applications > Browse App Catalog bölümüne gidin
2. ScribbleMaps araması yapın ve Add Integration seçeneğine tıklayın
3. SAML SSO URL'si, Entity ID ve Redirect URI otomatik olarak önceden yapılandırılmıştır
4. IdP yapılandırma ayrıntılarınızı bulmak için Sign On sekmesine gidin:
   • X.509 Certificate dosyasını indirin
   • Identity Provider Issuer (Entity ID) değerini kopyalayın
   • Single Sign-On URL değerini kopyalayın
5. Bu değerleri ScribbleMaps SSO ayarlarına girin (bkz. Adım 3)

Microsoft Entra ID (Azure AD)

1. Azure Portal'da Microsoft Entra ID > App registrations > New registration bölümüne gidin
2. Yapılandırın:
   • Redirect URI: https://api.scribblemaps.com/oidc/callback (Web platformu)
3. Certificates & secrets > Yeni bir Client secret oluşturun bölümüne gidin
4. Application (client) ID ve Client secret value değerlerini kopyalayın
5. Authority URL: https://login.microsoftonline.com/YOUR-TENANT-ID/v2.0

Google Workspace

1. Google Cloud Console'da APIs & Services > Credentials bölümüne gidin
2. Create Credentials > OAuth client ID seçeneğine tıklayın
3. Web application seçeneğini belirleyin
4. Authorized redirect URI ekleyin: https://api.scribblemaps.com/oidc/callback
5. Client ID ve Client Secret değerlerini kopyalayın
6. Authority URL: https://accounts.google.com

Not: Google Workspace için MFA'yı zorunlu kılmak için bunu Google Workspace Admin Console'unuzda yapılandırın.

Auth0

1. Auth0 Dashboard'da Applications > Create Application bölümüne gidin
2. Regular Web Applications seçeneğini belirleyin
3. Yapılandırın:
   • Allowed Callback URLs: https://api.scribblemaps.com/oidc/callback
   • Allowed Logout URLs: https://api.scribblemaps.com/oidc/logout-callback
4. Settings sekmesinden Client ID ve Client Secret değerlerini kopyalayın
5. Authority URL: https://YOUR-DOMAIN.auth0.com

Gelişmiş Seçenekler

Just-In-Time (JIT) Provisioning

Etkinleştirildiğinde, kullanıcılar ilk SSO girişlerinde ScribbleMaps'te otomatik olarak oluşturulur. Profil bilgileri (ad, e-posta) Kimlik Sağlayıcıdan alınır.

Çok Faktörlü Kimlik Doğrulamayı Zorunlu Kıl (Yalnızca OIDC)

Oturum açmaya izin vermeden önce MFA doğrulaması gerektirmek için bu seçeneği etkinleştirin. ScribbleMaps, IdP'nizin kullanıcı için MFA'yı zorunlu kıldığını doğrulayacaktır.

Okta için aşağıdaki gibi özel ACR değerleri belirtebilirsiniz:

• urn:okta:loa:2fa:any - Herhangi bir ikinci faktör
• phr - Kimlik avına dayanıklı kimlik doğrulama
• phrh - Kimlik avına dayanıklı donanıma bağlı kimlik doğrulama

Öznitelik/Talep Eşlemesi (Attribute/Claim Mapping)

IdP'nizdeki kullanıcı özniteliklerinin ScribbleMaps kullanıcı alanlarıyla nasıl eşleşeceğini özelleştirin:

Sorun Giderme

Sık Karşılaşılan Sorunlar

"Domain not verified"

• DNS TXT kaydınızın veya doğrulama dosyanızın doğru şekilde yapılandırıldığından emin olun
• DNS değişikliklerinin yayılması 48 saate kadar sürebilir
• Doğrulama kodunda yazım hatası olmadığından emin olun

"Invalid certificate"

• -----BEGIN CERTIFICATE----- ve -----END CERTIFICATE----- dahil olmak üzere sertifikanın tamamını kullandığınızdan emin olun
• Sertifikanın süresinin dolmadığını kontrol edin
• Şifreleme sertifikasını değil, imzalama sertifikasını kopyaladığınızdan emin olun

"Invalid signature"

• Sertifikanın IdP'nizin mevcut imzalama sertifikasıyla eşleştiğini doğrulayın
• İmza algoritmasının eşleştiğini kontrol edin (SHA-256'ya karşı SHA-1)

"User not found" veya "Email mismatch"

• IdP'niz tarafından döndürülen e-postanın doğrulanmış bir alan adıyla eşleştiğinden emin olun
• NameID formatının E-posta Adresi olarak ayarlandığını kontrol edin
• Öznitelik/talep eşlemesinin doğru olduğunu doğrulayın

"Security error: Your Identity Provider is not authorized for this email domain"

• Bu durum, IdP yapılandırması doğrulanmış alan adıyla eşleşmediğinde meydana gelir
• E-posta alan adının ekibiniz altında doğrulandığından emin olun
• Doğrulanmış bir alan adına ait bir e-posta ile giriş yaptığınızdan emin olun

Denetim Günlüklerini Görüntüleme

SSO etkinliğini Settings > Single Sign-On > Audit Logs bölümünden izleyin. Şunları yapabilirsiniz:

• Etkinlik türüne göre filtreleyin (Login, Logout, Failed Login)
• Tarih aralığına göre filtreleyin
• Uyum raporlaması için günlükleri CSV olarak dışa aktarın

Yardıma mı İhtiyacınız Var?

SSO yapılandırmasıyla ilgili sorunlar yaşıyorsanız, lütfen aşağıdaki bilgilerle destek ekibimizle iletişime geçin:

• Ekip adınız
• Kullandığınız Kimlik Sağlayıcı
• Karşılaştığınız tüm hata mesajları
• IdP yapılandırmanızın ekran görüntüleri (hassas veriler gizlenmiş olarak)

Kuruluşunuz için SSO'yu yapılandırmanıza yardımcı olmak için buradayız.