Ngonfigurasi Single Sign-On (SSO) nganggo SAML utawa OIDC

ScribbleMaps ndhukung Single Sign-On enterprise nganggo SAML 2.0 utawa OpenID Connect (OIDC). Iki ngidini anggota tim sampeyan kanggo otentikasi nganggo Identity Provider (IdP) organisasi sampeyan kayata Okta, Microsoft Entra ID (Azure AD), Google Workspace, utawa Auth0.

Konfigurasi SSO kasedhiya ing team.scribblemaps.com lan gratis babar blas.

Daftar Isi

1. Fitur sing Didhukung
2. Sadurunge Miwiti
3. Langkah 1: Verifikasi Domain Email Sampeyan
4. Langkah 2: Konfigurasi Identity Provider Sampeyan
5. Langkah 3: Konfigurasi SSO ing ScribbleMaps
6. Langkah 4: Uji Konfigurasi Sampeyan
7. Langkah 5: Aktifake SSO
8. SSO sing Diwiwiti SP
9. OIN Universal Logout
10. Pandhuan Khusus Panyedhiya
11. Pilihan Linuwih
12. Ngatasi Masalah

Fitur sing Didhukung

Integrasi SSO ScribbleMaps ndhukung fitur-fitur iki:

Sadurunge Miwiti

• Sampeyan kudu dadi Team Owner kanggo ngonfigurasi SSO
• Sampeyan butuh akses menyang konsol admin Identity Provider organisasi sampeyan
• Siapake domain email sampeyan (contone, yourcompany.com)

Langkah 1: Verifikasi Domain Email Sampeyan

Sadurunge ngonfigurasi SSO, sampeyan kudu verifikasi kepemilikan domain email sampeyan. Pangamanan iki mesthekake mung organisasi sing sah sing bisa ngonfigurasi SSO kanggo domain-ipun.

1. Mlebu menyang team.scribblemaps.com
2. Menyanga menyang Setelan > Single Sign-On
3. Menyanga menyang tab Domains
4. Klik Add Domain lan lebokake domain email sampeyan (contone, yourcompany.com)
5. Pilih cara verifikasi:

Pilihan A: Rekaman TXT DNS (Disaranake)

Tambahake rekaman TXT menyang setelan DNS domain sampeyan:

Cathetan: Owah-owahan DNS bisa mbutuhake nganti 48 jam kanggo nyebar.

Pilihan B: Unggah Berkas

1. Gawe berkas teks kanthi jeneng scribblemaps-verify.txt
2. Tambahake kode verifikasi sampeyan minangka siji-sijine isi
3. Unggah menyang: https://yourcompany.com/.well-known/scribblemaps-verify.txt

Sawise nambahake verifikasi, klik Verify Domain kanggo konfirmasi kepemilikan.

Langkah 2: Konfigurasi Identity Provider Sampeyan

Tambahake ScribbleMaps minangka aplikasi ing Identity Provider sampeyan. Yen sampeyan nggunakake Okta, sampeyan bisa nambahake ScribbleMaps langsung saka katalog Okta Integration Network (OIN) — SAML SSO URL, SP Entity ID, ACS URL, lan OIDC Redirect URI wis dikonfigurasi sadurunge kanthi otomatis.

Kanggo SAML 2.0

Kanggo OIDC

Langkah 3: Konfigurasi SSO ing ScribbleMaps

Ngonfigurasi SAML 2.0

1. Ing ScribbleMaps, menyanga menyang Setelan > Single Sign-On > tab SAML
2. Lebokake informasi iki saka Identity Provider sampeyan:

3. Klik Simpen Setelan

Ngonfigurasi OIDC

1. Ing ScribbleMaps, menyanga menyang Setelan > Single Sign-On > tab OIDC
2. Pilih Provider Type sampeyan (Google, Microsoft, Okta, Auth0, utawa Kustom)
3. Lebokake informasi iki:

4. Klik Simpen Setelan

Langkah 4: Uji Konfigurasi Sampeyan

Sadurunge ngaktifake SSO kanggo kabeh pangguna, uji konfigurasi sampeyan:

1. Klik tombol Test Connection
2. Jendhela anyar bakal mbukak kanggo nyimulasi alur mlebu SSO
3. Rampungake otentikasi karo Identity Provider sampeyan
4. Priksa manawa sampeyan kasil diarahake bali menyang ScribbleMaps

Yen uji gagal, priksa pesen kesalahan lan priksa setelan konfigurasi sampeyan.

Langkah 5: Aktifake SSO

Sawise uji kasil:

1. Aktifake saklar Enable SSO dadi ON
2. Pilih pilihan penegakan sampeyan:
   • Optional: Pangguna bisa milih SSO utawa mlebu nganggo sandi
   • Enforced: Pangguna kanthi domain email sing wis diverifikasi kudu nggunakake SSO (mlebu nganggo sandi dipateni)

Cathetan: Team Owner tansah bisa nggunakake mlebu nganggo sandi minangka serep, sanajan SSO ditegakake.

SSO sing Diwiwiti SP

ScribbleMaps ndhukung SSO sing diwiwiti SP, sing ngidini pangguna miwiti proses mlebu saka kaca mlebu ScribbleMaps. Mangkene cara kerjane:

1. Menyanga menyang scribblemaps.com/account/login
2. Lebokake alamat email sampeyan (contone, [email protected])
3. Klik Sign in with SSO
4. Sampeyan bakal diarahake menyang Identity Provider organisasi sampeyan (contone, Okta) kanggo otentikasi
5. Sawise otentikasi kasil, sampeyan otomatis diarahake bali menyang ScribbleMaps lan wis mlebu

Yen organisasi sampeyan nandhesake SSO, nglebokake email sampeyan ing kaca mlebu bakal otomatis ngarahake sampeyan menyang Identity Provider sampeyan — kolom sandi ora bakal ditampilake.

OIN Universal Logout

Universal logout dening Okta didhukung. Kanggo instruksi konfigurasi mangga pirsani pranala iki.

Pandhuan Khusus Panyedhiya

Okta

1. Ing Okta Admin Console, menyanga menyang Applications > Browse App Catalog
2. Goleki ScribbleMaps lan klik Add Integration
3. SSO URL, Entity ID, lan Redirect URI wis dikonfigurasi sadurunge kanthi otomatis
4. Menyanga menyang tab Sign On kanggo nemokake rincian konfigurasi IdP sampeyan:
   • Undhuh X.509 Certificate
   • Salin Identity Provider Issuer (Entity ID)
   • Salin Single Sign-On URL
5. Lebokake nilai-nilai iki menyang setelan SSO ScribbleMaps (deleng Langkah 3)

Microsoft Entra ID (Azure AD)

1. Ing Azure Portal, menyanga menyang Microsoft Entra ID > App registrations > New registration
2. Konfigurasi:
   • Redirect URI: https://api.scribblemaps.com/oidc/callback (platform Web)
3. Menyanga menyang Certificates & secrets > Gawe Client secret anyar
4. Salin Application (client) ID lan nilai Client secret
5. Authority URL: https://login.microsoftonline.com/YOUR-TENANT-ID/v2.0

Google Workspace

1. Ing Google Cloud Console, menyanga menyang APIs & Services > Credentials
2. Klik Create Credentials > OAuth client ID
3. Pilih Web application
4. Tambahake Authorized redirect URI: https://api.scribblemaps.com/oidc/callback
5. Salin Client ID lan Client Secret
6. Authority URL: https://accounts.google.com

Cathetan: Kanggo mbutuhake MFA kanggo Google Workspace, konfigurasi ing Google Workspace Admin Console sampeyan.

Auth0

1. Ing Auth0 Dashboard, menyanga menyang Applications > Create Application
2. Pilih Regular Web Applications
3. Konfigurasi:
   • Allowed Callback URLs: https://api.scribblemaps.com/oidc/callback
   • Allowed Logout URLs: https://api.scribblemaps.com/oidc/logout-callback
4. Salin Client ID lan Client Secret saka tab Setelan
5. Authority URL: https://YOUR-DOMAIN.auth0.com

Pilihan Linuwih

Just-In-Time (JIT) Provisioning

Nalika diaktifake, pangguna digawe kanthi otomatis ing ScribbleMaps nalika mlebu SSO sepisanan. Informasi profil (jeneng, email) diisi saka Identity Provider.

Mbutuhake Multi-Factor Authentication (OIDC wae)

Aktifake pilihan iki kanggo mbutuhake verifikasi MFA sadurunge ngidini mlebu. ScribbleMaps bakal verifikasi manawa IdP sampeyan wis nandhesake MFA kanggo pangguna.

Kanggo Okta, sampeyan bisa nemtokake nilai ACR kustom kayata:

• urn:okta:loa:2fa:any - Faktor kapindho apa wae
• phr - Otentikasi tahan phishing
• phrh - Otentikasi tahan phishing sing kaiket hardware

Pemetaan Atribut/Claim

Sesuaikake carane atribut pangguna saka IdP sampeyan dipetakake menyang kolom panganggo ScribbleMaps:

Ngatasi Masalah

Masalah Umum

"Domain not verified"

• Priksa manawa rekaman TXT DNS utawa berkas verifikasi sampeyan wis dikonfigurasi kanthi bener
• Owah-owahan DNS bisa mbutuhake nganti 48 jam kanggo nyebar
• Priksa manawa ora ana salah ketik ing kode verifikasi

"Invalid certificate"

• Priksa manawa sampeyan nggunakake sertifikat lengkap kalebu -----BEGIN CERTIFICATE----- lan -----END CERTIFICATE-----
• Priksa manawa sertifikat durung kadaluwarsa
• Priksa manawa sampeyan nyalin sertifikat tandha tangan, dudu sertifikat enkripsi

"Invalid signature"

• Priksa manawa sertifikat cocog karo sertifikat tandha tangan IdP sampeyan saiki
• Priksa manawa algoritma tandha tangan cocog (SHA-256 vs SHA-1)

"User not found" utawa "Email mismatch"

• Priksa manawa email sing dibalekake IdP sampeyan cocog karo domain sing wis diverifikasi
• Priksa manawa format NameID disetel menyang Alamat Email
• Priksa manawa pemetaan atribut/claim wis bener

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

• Iki kedadean nalika konfigurasi IdP ora cocog karo domain sing wis diverifikasi
• Priksa manawa domain email wis diverifikasi ing tim sampeyan
• Priksa manawa sampeyan mlebu nganggo email saka domain sing wis diverifikasi

Ndeleng Log Audit

Pantau aktivitas SSO ing Setelan > Single Sign-On > Audit Logs. Sampeyan bisa:

• Saring miturut jinis acara (Login, Logout, Failed Login)
• Saring miturut rentang tanggal
• Ekspor log minangka CSV kanggo laporan kepatuhan

Butuh Pitulungan?

Yen sampeyan ngalami masalah karo konfigurasi SSO, mangga hubungi tim dhukungan kita kanthi:

• Jeneng Tim sampeyan
• Identity Provider sing sampeyan gunakake
• Pesen kesalahan apa wae sing sampeyan deleng
• Cuplikan layar konfigurasi IdP sampeyan (kanthi data sensitif disamarake)

Kita ana ing kene kanggo mbantu sampeyan ngonfigurasi SSO kanggo organisasi sampeyan.