Mengonfigurasi Single Sign-On (SSO) dengan SAML atau OIDC

ScribbleMaps mendukung Single Sign-On tingkat perusahaan menggunakan SAML 2.0 atau OpenID Connect (OIDC). Ini memungkinkan anggota tim Anda melakukan autentikasi menggunakan Identity Provider (IdP) organisasi Anda seperti Okta, Microsoft Entra ID (Azure AD), Google Workspace, atau Auth0.

Konfigurasi SSO tersedia di team.scribblemaps.com dan sepenuhnya gratis.

Daftar Isi

1. Fitur yang Didukung
2. Sebelum Anda Memulai
3. Langkah 1: Verifikasi Domain Email Anda
4. Langkah 2: Konfigurasi Identity Provider Anda
5. Langkah 3: Konfigurasi SSO di ScribbleMaps
6. Langkah 4: Uji Konfigurasi Anda
7. Langkah 5: Aktifkan SSO
8. SSO yang Diinisiasi SP
9. OIN Universal Logout
10. Panduan Khusus Penyedia
11. Opsi Lanjutan
12. Pemecahan Masalah

Fitur yang Didukung

Integrasi SSO ScribbleMaps mendukung fitur-fitur berikut:

Sebelum Anda Memulai

• Anda harus menjadi Team Owner untuk mengonfigurasi SSO
• Anda memerlukan akses ke konsol admin Identity Provider organisasi Anda
• Siapkan domain email Anda (misalnya, yourcompany.com)

Langkah 1: Verifikasi Domain Email Anda

Sebelum mengonfigurasi SSO, Anda harus memverifikasi kepemilikan domain email Anda. Langkah keamanan ini memastikan hanya organisasi yang berwenang yang dapat mengonfigurasi SSO untuk domain mereka.

1. Masuk ke team.scribblemaps.com
2. Buka Setelan > Single Sign-On
3. Buka tab Domains
4. Klik Add Domain dan masukkan domain email Anda (misalnya, yourcompany.com)
5. Pilih metode verifikasi:

Opsi A: DNS TXT Record (Direkomendasikan)

Tambahkan TXT record ke pengaturan DNS domain Anda:

Catatan: Perubahan DNS dapat memerlukan waktu hingga 48 jam untuk diterapkan.

Opsi B: Unggah File

1. Buat file teks bernama scribblemaps-verify.txt
2. Tambahkan kode verifikasi Anda sebagai satu-satunya konten
3. Unggah ke: https://yourcompany.com/.well-known/scribblemaps-verify.txt

Setelah menambahkan verifikasi, klik Verify Domain untuk mengonfirmasi kepemilikan.

Langkah 2: Konfigurasi Identity Provider Anda

Tambahkan ScribbleMaps sebagai aplikasi di Identity Provider Anda. Jika Anda menggunakan Okta, Anda dapat menambahkan ScribbleMaps langsung dari katalog Okta Integration Network (OIN) — SAML SSO URL, SP Entity ID, ACS URL, dan OIDC Redirect URI telah dikonfigurasi otomatis sebelumnya.

Untuk SAML 2.0

Untuk OIDC

Langkah 3: Konfigurasi SSO di ScribbleMaps

Mengonfigurasi SAML 2.0

1. Di ScribbleMaps, buka tab Setelan > Single Sign-On > SAML
2. Masukkan informasi berikut dari Identity Provider Anda:

3. Klik Simpan setelan

Mengonfigurasi OIDC

1. Di ScribbleMaps, buka tab Setelan > Single Sign-On > OIDC
2. Pilih Provider Type Anda (Google, Microsoft, Okta, Auth0, atau Kustom)
3. Masukkan informasi berikut:

4. Klik Simpan setelan

Langkah 4: Uji Konfigurasi Anda

Sebelum mengaktifkan SSO untuk semua pengguna, uji konfigurasi Anda:

1. Klik tombol Test Connection
2. Jendela baru akan terbuka untuk mensimulasikan alur login SSO
3. Selesaikan autentikasi dengan Identity Provider Anda
4. Verifikasi bahwa Anda berhasil diarahkan kembali ke ScribbleMaps

Jika pengujian gagal, tinjau pesan kesalahan dan periksa pengaturan konfigurasi Anda.

Langkah 5: Aktifkan SSO

Setelah pengujian berhasil:

1. Aktifkan sakelar Enable SSO ke ON
2. Pilih opsi penerapan Anda:
   • Optional: Pengguna dapat memilih SSO atau login dengan kata sandi
   • Enforced: Pengguna dengan domain email terverifikasi harus menggunakan SSO (login dengan kata sandi dinonaktifkan)

Catatan: Team Owner selalu dapat menggunakan login kata sandi sebagai cadangan, bahkan saat SSO diterapkan secara wajib.

SSO yang Diinisiasi SP

ScribbleMaps mendukung SSO yang diinisiasi SP, yang memungkinkan pengguna memulai proses masuk dari halaman login ScribbleMaps. Berikut cara kerjanya:

1. Buka scribblemaps.com/account/login
2. Masukkan alamat email Anda (misalnya, [email protected])
3. Klik Sign in with SSO
4. Anda akan diarahkan ke Identity Provider organisasi Anda (misalnya, Okta) untuk melakukan autentikasi
5. Setelah autentikasi berhasil, Anda akan otomatis diarahkan kembali ke ScribbleMaps dan masuk

Jika organisasi Anda telah menerapkan SSO secara wajib, memasukkan email Anda di halaman login akan secara otomatis mengarahkan Anda ke Identity Provider Anda — tidak ada kolom kata sandi yang akan ditampilkan.

OIN Universal Logout

Universal logout oleh Okta didukung. Untuk instruksi konfigurasi silakan kunjungi tautan ini.

Panduan Khusus Penyedia

Okta

1. Di Okta Admin Console, buka Applications > Browse App Catalog
2. Cari ScribbleMaps dan klik Add Integration
3. SSO URL, Entity ID, dan Redirect URI telah dikonfigurasi otomatis sebelumnya
4. Buka tab Sign On untuk menemukan detail konfigurasi IdP Anda:
   • Unduh X.509 Certificate
   • Salin Identity Provider Issuer (Entity ID)
   • Salin Single Sign-On URL
5. Masukkan nilai-nilai ini ke setelan SSO ScribbleMaps (lihat Langkah 3)

Microsoft Entra ID (Azure AD)

1. Di Azure Portal, buka Microsoft Entra ID > App registrations > New registration
2. Konfigurasikan:
   • Redirect URI: https://api.scribblemaps.com/oidc/callback (Web platform)
3. Buka Certificates & secrets > Buat Client secret baru
4. Salin Application (client) ID dan Client secret value
5. Authority URL: https://login.microsoftonline.com/YOUR-TENANT-ID/v2.0

Google Workspace

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

Catatan: Untuk mewajibkan MFA untuk Google Workspace, konfigurasikan di Google Workspace Admin Console Anda.

Auth0

1. Di Auth0 Dashboard, buka Applications > Create Application
2. Pilih Regular Web Applications
3. Konfigurasikan:
   • Allowed Callback URLs: https://api.scribblemaps.com/oidc/callback
   • Allowed Logout URLs: https://api.scribblemaps.com/oidc/logout-callback
4. Salin Client ID dan Client Secret dari tab Setelan
5. Authority URL: https://YOUR-DOMAIN.auth0.com

Opsi Lanjutan

Penyediaan Just-In-Time (JIT)

Jika diaktifkan, pengguna secara otomatis dibuat di ScribbleMaps saat login SSO pertama mereka. Informasi profil mereka (nama, email) diisi dari Identity Provider.

Wajibkan Autentikasi Multi-Faktor (hanya OIDC)

Aktifkan opsi ini untuk mewajibkan verifikasi MFA sebelum mengizinkan login. ScribbleMaps akan memverifikasi bahwa IdP Anda telah menerapkan MFA untuk pengguna.

Untuk Okta, Anda dapat menentukan nilai ACR kustom seperti:

• urn:okta:loa:2fa:any - Faktor kedua apa saja
• phr - Autentikasi tahan phishing
• phrh - Autentikasi tahan phishing berbasis hardware

Pemetaan Atribut/Klaim

Sesuaikan cara atribut pengguna dari IdP Anda dipetakan ke bidang pengguna ScribbleMaps:

Pemecahan Masalah

Masalah Umum

"Domain not verified"

• Pastikan DNS TXT record atau file verifikasi Anda telah dikonfigurasi dengan benar
• Perubahan DNS dapat memerlukan waktu hingga 48 jam untuk diterapkan
• Verifikasi tidak ada salah ketik pada kode verifikasi

"Invalid certificate"

• Pastikan Anda menggunakan sertifikat lengkap termasuk -----BEGIN CERTIFICATE----- dan -----END CERTIFICATE-----
• Periksa bahwa sertifikat belum kedaluwarsa
• Pastikan Anda menyalin sertifikat penandatanganan, bukan sertifikat enkripsi

"Invalid signature"

• Verifikasi sertifikat cocok dengan sertifikat penandatanganan IdP Anda saat ini
• Periksa bahwa algoritma signature cocok (SHA-256 vs SHA-1)

"User not found" atau "Email mismatch"

• Pastikan email yang dikembalikan oleh IdP Anda cocok dengan domain terverifikasi
• Periksa bahwa format NameID diatur ke Alamat Email
• Verifikasi pemetaan atribut/klaim sudah benar

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

• Hal ini terjadi ketika konfigurasi IdP tidak cocok dengan domain yang terverifikasi
• Pastikan domain email terverifikasi di bawah tim Anda
• Periksa bahwa Anda masuk menggunakan email dari domain yang terverifikasi

Melihat Log Audit

Pantau aktivitas SSO di Setelan > Single Sign-On > Audit Logs. Anda dapat:

• Memfilter berdasarkan jenis peristiwa (Login, Logout, Failed Login)
• Memfilter berdasarkan rentang tanggal
• Mengekspor log sebagai CSV untuk pelaporan kepatuhan

Butuh Bantuan?

Jika Anda mengalami masalah dengan konfigurasi SSO, silakan hubungi tim dukungan kami dengan:

• Nama Tim Anda
• Identity Provider yang Anda gunakan
• Apa saja pesan kesalahan yang Anda lihat
• Tangkapan layar konfigurasi IdP Anda (dengan data sensitif disamarkan)

Kami di sini untuk membantu Anda mengonfigurasi SSO untuk organisasi Anda.