SAML və ya OIDC ilə vahid girişin (SSO) konfiqurasiyası

ScribbleMaps SAML 2.0 və ya OpenID Connect (OIDC) vasitəsilə korporativ vahid girişi dəstəkləyir. Bu, komanda üzvlərinizə təşkilatınızın Okta, Microsoft Entra ID (Azure AD), Google Workspace və ya Auth0 kimi Şəxsiyyət Provayderi (IdP) ilə autentifikasiya etməyə imkan verir.

SSO konfiqurasiyası team.scribblemaps.com ünvanında mövcuddur və tamamilə pulsuzdur.

Mündəricat

1. Dəstəklənən imkanlar
2. Başlamazdan əvvəl
3. Addım 1: E-poçt domeninizi təsdiqləyin
4. Addım 2: Şəxsiyyət Provayderinizi konfiqurasiya edin
5. Addım 3: SSO-nu ScribbleMaps-də konfiqurasiya edin
6. Addım 4: Konfiqurasiyanızı yoxlayın
7. Addım 5: SSO-nu aktivləşdirin
8. SP tərəfindən başladılan SSO
9. OIN Universal Logout
10. Provayderə aid bələdçilər
11. Təkmil seçimlər
12. Problemlərin aradan qaldırılması

Dəstəklənən imkanlar

ScribbleMaps SSO inteqrasiyası aşağıdakı imkanları dəstəkləyir:

Başlamazdan əvvəl

• SSO-nu konfiqurasiya etmək üçün Komanda sahibi olmalısınız
• Təşkilatınızın Şəxsiyyət Provayderinin administrator konsoluna girişiniz olmalıdır
• E-poçt domeniniz hazır olsun (məsələn, yourcompany.com)

Addım 1: E-poçt domeninizi təsdiqləyin

SSO-nu konfiqurasiya etməzdən əvvəl e-poçt domeninizə sahib olduğunuzu təsdiqləməlisiniz. Bu təhlükəsizlik tədbiri yalnız səlahiyyətli təşkilatların öz domenləri üçün SSO konfiqurasiya edə bilməsini təmin edir.

1. team.scribblemaps.com ünvanında daxil olun
2. Ayarlar > Single Sign-On bölməsinə keçin
3. Domains sekmesinə keçin
4. Add Domain düyməsinə klikləyin və e-poçt domeninizi daxil edin (məsələn, yourcompany.com)
5. Təsdiqləmə metodunu seçin:

Seçim A: DNS TXT qeydi (Tövsiyə olunur)

Domeninizin DNS ayarlarına TXT qeydi əlavə edin:

Qeyd: DNS dəyişikliklərinin yayılması 48 saata qədər çəkə bilər.

Seçim B: Fayl yükləmə

1. scribblemaps-verify.txt adlı mətn faylı yaradın
2. Təsdiqləmə kodunuzu yeganə məzmun kimi əlavə edin
3. Bu ünvana yükləyin: https://yourcompany.com/.well-known/scribblemaps-verify.txt

Təsdiqləməni əlavə etdikdən sonra sahibliyi təsdiqləmək üçün Verify Domain düyməsinə klikləyin.

Addım 2: Şəxsiyyət Provayderinizi konfiqurasiya edin

ScribbleMaps-i Şəxsiyyət Provayderinizdə tətbiq kimi əlavə edin. Okta istifadə edirsinizsə, ScribbleMaps-i birbaşa Okta Integration Network (OIN) kataloqundan əlavə edə bilərsiniz — SAML SSO URL, SP Entity ID, ACS URL və OIDC Redirect URI avtomatik olaraq əvvəlcədən konfiqurasiya edilir.

SAML 2.0 üçün

OIDC üçün

Addım 3: SSO-nu ScribbleMaps-də konfiqurasiya edin

SAML 2.0-ın konfiqurasiyası

1. ScribbleMaps-də Ayarlar > Single Sign-On > SAML sekmesinə keçin
2. Şəxsiyyət Provayderinizdən aşağıdakı məlumatları daxil edin:

3. Ayarları yadda saxla düyməsinə klikləyin

OIDC-nin konfiqurasiyası

1. ScribbleMaps-də Ayarlar > Single Sign-On > OIDC sekmesinə keçin
2. Provider Type seçin (Google, Microsoft, Okta, Auth0 və ya Fərdi)
3. Aşağıdakı məlumatları daxil edin:

4. Ayarları yadda saxla düyməsinə klikləyin

Addım 4: Konfiqurasiyanızı yoxlayın

SSO-nu bütün istifadəçilər üçün aktivləşdirməzdən əvvəl konfiqurasiyanızı yoxlayın:

1. Test Connection düyməsinə klikləyin
2. SSO giriş axınını simulyasiya etmək üçün yeni pəncərə açılacaq
3. Şəxsiyyət Provayderinizlə autentifikasiyanı tamamlayın
4. ScribbleMaps-ə uğurla geri yönləndirildiyinizi yoxlayın

Test uğursuz olarsa, xəta mesajını nəzərdən keçirin və konfiqurasiya ayarlarınızı yoxlayın.

Addım 5: SSO-nu aktivləşdirin

Test uğurlu olduqdan sonra:

1. Enable SSO açarını AÇIQ vəziyyətinə keçirin
2. Tətbiq seçiminizi müəyyən edin:
   • Optional: İstifadəçilər SSO və ya parolla girişdən birini seçə bilər
   • Enforced: Təsdiqlənmiş e-poçt domenləri olan istifadəçilər SSO-dan istifadə etməlidir (parolla giriş deaktiv edilir)

Qeyd: SSO məcburi edildikdə belə, Komanda sahibləri ehtiyat variant kimi həmişə parolla girişdən istifadə edə bilər.

SP tərəfindən başladılan SSO

ScribbleMaps SP tərəfindən başladılan SSO-nu dəstəkləyir, bu da istifadəçilərə giriş prosesini ScribbleMaps giriş səhifəsindən başlatmağa imkan verir. Bu belə işləyir:

1. scribblemaps.com/account/login səhifəsinə keçin
2. E-poçt ünvanınızı daxil edin (məsələn, [email protected])
3. Sign in with SSO düyməsinə klikləyin
4. Autentifikasiya üçün təşkilatınızın Şəxsiyyət Provayderinə (məsələn, Okta) yönləndiriləcəksiniz
5. Uğurlu autentifikasiyadan sonra avtomatik olaraq ScribbleMaps-ə geri yönləndirilir və daxil olursunuz

Təşkilatınızda SSO məcburi edilibsə, giriş səhifəsində e-poçtunuzu daxil etdikdə avtomatik olaraq Şəxsiyyət Provayderinizə yönləndiriləcəksiniz — parol sahəsi göstərilməyəcək.

OIN Universal Logout

Okta tərəfindən təqdim olunan universal logout dəstəklənir. Konfiqurasiya təlimatları üçün bu keçidə baxın.

Provayderə aid bələdçilər

Okta

1. Okta Admin Console-da Applications > Browse App Catalog bölməsinə keçin
2. ScribbleMaps axtarın və Add Integration düyməsinə klikləyin
3. SSO URL, Entity ID və Redirect URI avtomatik olaraq əvvəlcədən konfiqurasiya edilir
4. IdP konfiqurasiya təfərrüatlarını tapmaq üçün Sign On sekmesinə keçin:
   • X.509 Certificate faylını endirin
   • Identity Provider Issuer (Entity ID) dəyərini kopyalayın
   • Single Sign-On URL dəyərini kopyalayın
5. Bu dəyərləri ScribbleMaps SSO ayarlarına daxil edin (bax: Addım 3)

Microsoft Entra ID (Azure AD)

1. Azure Portal-da Microsoft Entra ID > App registrations > New registration bölməsinə keçin
2. Konfiqurasiya edin:
   • Redirect URI: https://api.scribblemaps.com/oidc/callback (Web platforması)
3. Certificates & secrets bölməsinə keçin > yeni Client secret yaradın
4. Application (client) ID və Client secret value dəyərlərini 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ölməsinə keçin
2. Create Credentials > OAuth client ID seçin
3. Web application seçin
4. Authorized redirect URI əlavə edin: https://api.scribblemaps.com/oidc/callback
5. Client ID və Client Secret dəyərlərini kopyalayın
6. Authority URL: https://accounts.google.com

Qeyd: Google Workspace üçün MFA tələb etmək istəyirsinizsə, onu Google Workspace Admin Console-da konfiqurasiya edin.

Auth0

1. Auth0 Dashboard-da Applications > Create Application bölməsinə keçin
2. Regular Web Applications seçin
3. Konfiqurasiya edin:
   • Allowed Callback URLs: https://api.scribblemaps.com/oidc/callback
   • Allowed Logout URLs: https://api.scribblemaps.com/oidc/logout-callback
4. Settings sekmesindən Client ID və Client Secret dəyərlərini kopyalayın
5. Authority URL: https://YOUR-DOMAIN.auth0.com

Təkmil seçimlər

Just-In-Time (JIT) təchizatı

Aktiv edildikdə, istifadəçilər ilk SSO girişində ScribbleMaps-də avtomatik yaradılır. Onların profil məlumatları (ad, e-poçt) Şəxsiyyət Provayderindən doldurulur.

Çoxfaktorlu autentifikasiya tələb et (yalnız OIDC)

Girişə icazə verməzdən əvvəl MFA yoxlamasını tələb etmək üçün bu seçimi aktiv edin. ScribbleMaps IdP-nizin istifadəçi üçün MFA tətbiq etdiyini yoxlayacaq.

Okta üçün aşağıdakı kimi fərdi ACR dəyərləri təyin edə bilərsiniz:

• urn:okta:loa:2fa:any - İstənilən ikinci faktor
• phr - Fişinqə davamlı autentifikasiya
• phrh - Fişinqə davamlı, aparata bağlı autentifikasiya

Atribut/Claim xəritələndirilməsi

IdP-nizdən gələn istifadəçi atributlarının ScribbleMaps istifadəçi sahələrinə necə uyğunlaşdırılacağını fərdiləşdirin:

Problemlərin aradan qaldırılması

Ümumi problemlər

"Domain not verified"

• DNS TXT qeydinizin və ya təsdiqləmə faylınızın düzgün konfiqurasiya edildiyinə əmin olun
• DNS dəyişikliklərinin yayılması 48 saata qədər çəkə bilər
• Təsdiqləmə kodunda yazı səhvi olmadığını yoxlayın

"Invalid certificate"

• -----BEGIN CERTIFICATE----- və -----END CERTIFICATE----- daxil olmaqla tam sertifikatdan istifadə etdiyinizə əmin olun
• Sertifikatın vaxtının bitmədiyini yoxlayın
• Şifrələmə sertifikatını deyil, imza sertifikatını kopyaladığınızdan əmin olun

"Invalid signature"

• Sertifikatın IdP-nizin cari imza sertifikatına uyğun olduğunu yoxlayın
• İmza alqoritminin uyğun olduğunu yoxlayın (SHA-256 və SHA-1)

"User not found" və ya "Email mismatch"

• IdP-nizin qaytardığı e-poçtun təsdiqlənmiş domenə uyğun olduğundan əmin olun
• NameID formatının E-poçt ünvanı olaraq təyin edildiyini yoxlayın
• Atribut/claim xəritələndirilməsinin düzgün olduğunu yoxlayın

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

• Bu, IdP konfiqurasiyası təsdiqlənmiş domenə uyğun gəlmədikdə baş verir
• E-poçt domeninin komandanız altında təsdiqləndiyinə əmin olun
• Təsdiqlənmiş domendən olan e-poçtla daxil olduğunuzu yoxlayın

Audit jurnallarına baxış

SSO fəaliyyətini Ayarlar > Single Sign-On > Audit Logs bölməsində izləyin. Siz bunları edə bilərsiniz:

• Hadisə növünə görə filtrləmək (Login, Logout, Failed Login)
• Tarix aralığına görə filtrləmək
• Uyğunluq hesabatı üçün jurnalları CSV kimi ixrac etmək

Köməyə ehtiyacınız var?

SSO konfiqurasiyası ilə bağlı problem yaşayırsınızsa, zəhmət olmasa dəstək komandamızla aşağıdakı məlumatlarla əlaqə saxlayın:

• Komandanızın adı
• İstifadə etdiyiniz Şəxsiyyət Provayderi
• Gördüyünüz xəta mesajları
• IdP konfiqurasiyanızın ekran görüntüləri (həssas məlumatlar gizlədilmiş şəkildə)

Təşkilatınız üçün SSO-nu konfiqurasiya etməyinizə kömək etməyə hazırıq.