Scribble Maps Help Center
Change language

Provisioning SCIM

Mengonfigurasi Provisioning Pengguna SCIM

ScribbleMaps mendukung SCIM 2.0 (System for Cross-domain Identity Management) untuk provisioning dan deprovisioning pengguna otomatis. Ini memungkinkan Anda menyinkronkan pengguna secara otomatis dari Identity Provider (IdP) Anda ke ScribbleMaps, memastikan keanggotaan tim tetap sinkron dengan direktori organisasi Anda.

Provisioning SCIM tersedia di team.scribblemaps.com dan sepenuhnya gratis.

Daftar Isi

  1. Apa itu SCIM?
  2. Sebelum Anda Mulai
  3. Langkah 1: Mengaktifkan SCIM di ScribbleMaps
  4. Langkah 2: Membuat Bearer Token
  5. Langkah 3: Mengonfigurasi Identity Provider Anda
  6. Langkah 4: Mengatur Penetapan Produk Default
  7. Langkah 5: Menguji dan Menetapkan Pengguna
  8. Panduan Khusus Provider
  9. Operasi SCIM yang Didukung
  10. Pengelolaan Siklus Hidup Pengguna
  11. Pemecahan Masalah

Apa itu SCIM?

SCIM (System for Cross-domain Identity Management) adalah standar terbuka yang memungkinkan Anda secara otomatis:

  • Provisioning pengguna - Membuat akun ScribbleMaps secara otomatis saat pengguna ditetapkan di IdP Anda
  • Memperbarui pengguna - Menjaga informasi pengguna (nama, email) tetap sinkron
  • Deprovisioning pengguna - Menonaktifkan akun secara otomatis saat pengguna dihapus dari IdP Anda
  • Mengelola peran - Menetapkan pengguna ke peran Admin atau Member melalui keanggotaan grup

SCIM bekerja bersama SSO (SAML/OIDC) untuk menyediakan pengelolaan siklus hidup identitas yang lengkap.

Sebelum Anda Mulai

  • Anda harus menjadi Team Owner untuk mengonfigurasi SCIM
  • Anda memerlukan akses ke konsol admin Identity Provider Anda
  • IdP Anda harus mendukung SCIM 2.0 (Okta, Microsoft Entra ID, OneLogin, JumpCloud, dll.)
  • Kami menyarankan mengonfigurasi SSO sebelum SCIM untuk pengalaman pengguna terbaik

Langkah 1: Mengaktifkan SCIM di ScribbleMaps

  1. Masuk ke team.scribblemaps.com
  2. Buka SCIM Provisioning (bilah sisi kiri)
  3. Alihkan Enable SCIM ke ON

Catatan: Anda perlu membuat bearer token sebelum SCIM dapat diaktifkan sepenuhnya.

Langkah 2: Membuat Bearer Token

Bearer token mengautentikasi Identity Provider Anda dengan ScribbleMaps.

  1. Di halaman setelan SCIM, klik Generate Token
  2. Salin token segera dan simpan dengan aman

Catatan Keamanan Penting:

  • Token hanya ditampilkan sekali - jika Anda kehilangannya, Anda perlu membuat token baru
  • Perlakukan token ini seperti kata sandi - siapa pun yang memiliki token dapat mengelola pengguna tim Anda
  • Anda dapat mencabut dan membuat ulang token kapan saja jika token tersebut disusupi
  • Mencabut token akan langsung menghentikan semua operasi SCIM hingga token baru dikonfigurasi

Langkah 3: Mengonfigurasi Identity Provider Anda

Gunakan detail berikut untuk mengonfigurasi ScribbleMaps sebagai aplikasi SCIM di IdP Anda:

Setelan Nilai
SCIM Base URL https://api.scribblemaps.com/scim/v2
Metode Autentikasi HTTP Header / Bearer Token
Authorization Header Bearer YOUR_TOKEN_HERE
Unique Identifier userName (alamat email)

Referensi Endpoint SCIM

Endpoint Tujuan
/scim/v2/Users Provisioning dan pengelolaan pengguna
/scim/v2/Groups Pengelolaan keanggotaan peran/grup
/scim/v2/ServiceProviderConfig Kapabilitas SCIM (discovery)
/scim/v2/ResourceTypes Jenis sumber daya yang didukung (discovery)
/scim/v2/Schemas Skema User dan Group (discovery)

Langkah 4: Mengatur Penetapan Produk Default (Opsional)

Anda dapat secara otomatis menetapkan lisensi produk ke pengguna saat mereka diprovisioning melalui SCIM:

  1. Di halaman setelan SCIM, temukan Default Product Assignment
  2. Pilih produk:
    • Tidak ada - Pengguna dibuat tanpa produk (tetapkan secara manual nanti)
    • Pelihat - Akses khusus lihat
    • Pro Basic - Fitur pengeditan standar
    • Pro Bisnis - Akses fitur penuh
  3. Klik Simpan

Catatan: Pengguna hanya akan ditetapkan produk jika kursi tersedia. Jika tidak ada kursi tersedia, pengguna dibuat tetapi dibiarkan tanpa penetapan.

Langkah 5: Menguji dan Menetapkan Pengguna

  1. Di Identity Provider Anda, gunakan fitur Test Connection untuk memverifikasi konektivitas SCIM
  2. Tetapkan pengguna uji ke aplikasi ScribbleMaps di IdP Anda
  3. Verifikasi pengguna muncul di daftar anggota tim ScribbleMaps Anda
  4. Setelah dikonfirmasi, tetapkan pengguna atau grup tambahan sesuai kebutuhan

Panduan Khusus Provider

Okta

  1. Di Okta Admin Console, buka Applications > Browse App Catalog
  2. Cari "SCIM 2.0 Test App (Header Auth)" atau buat aplikasi SCIM kustom
  3. Buka tab Provisioning > Configure API Integration
  4. Centang Enable API integration
  5. Konfigurasikan:
    • SCIM 2.0 Base URL: https://api.scribblemaps.com/scim/v2
    • OAuth Bearer Token: Tempel token SCIM ScribbleMaps Anda
  6. Klik Test API Credentials untuk memverifikasi
  7. Buka Provisioning > To App dan aktifkan:
    • Create Users
    • Update User Attributes
    • Deactivate Users
  8. Buka tab Assignments untuk menetapkan pengguna atau grup

Microsoft Entra ID (Azure AD)

  1. Di Azure Portal, buka Microsoft Entra ID > Enterprise Applications
  2. Pilih aplikasi ScribbleMaps Anda (atau buat satu)
  3. Buka Provisioning > Get Started
  4. Atur Provisioning Mode ke Automatic
  5. Di bawah Admin Credentials:
    • Tenant URL: https://api.scribblemaps.com/scim/v2
    • Secret Token: Tempel token SCIM ScribbleMaps Anda
  6. Klik Test Connection untuk memverifikasi
  7. Konfigurasikan Mappings untuk atribut pengguna
  8. Atur Provisioning Status ke On
  9. Buka Users and groups untuk menetapkan pengguna

OneLogin

  1. Di OneLogin Admin, buka Applications > Add App
  2. Cari "SCIM Provisioner with SAML (SCIM v2 Core)" atau serupa
  3. Buka tab Configuration
  4. Konfigurasikan:
    • SCIM Base URL: https://api.scribblemaps.com/scim/v2
    • SCIM Bearer Token: Tempel token SCIM ScribbleMaps Anda
  5. Buka tab Provisioning dan aktifkan provisioning
  6. Buka tab Users untuk menetapkan pengguna

JumpCloud

  1. Di JumpCloud Admin, buka SSO Applications
  2. Klik + untuk menambahkan aplikasi baru
  3. Pilih Custom SCIM
  4. Konfigurasikan:
    • Base URL: https://api.scribblemaps.com/scim/v2
    • Token Key: Tempel token SCIM ScribbleMaps Anda
    • Authentication: Bearer Token
  5. Klik Test Connection
  6. Konfigurasikan pemetaan atribut
  7. Tetapkan grup pengguna ke aplikasi

Operasi SCIM yang Didukung

Operasi Pengguna

Operasi Metode Didukung Deskripsi
List Users GET /Users Ya Mengambil semua pengguna dengan pagination dan filter
Get User GET /Users/{id} Ya Mengambil pengguna tertentu berdasarkan ID
Create User POST /Users Ya Melakukan provisioning pengguna baru
Replace User PUT /Users/{id} Ya Pembaruan penuh atribut pengguna
Update User PATCH /Users/{id} Ya Pembaruan sebagian atribut pengguna
Delete User DELETE /Users/{id} Ya Menonaktifkan pengguna (soft delete)

Operasi Grup

Operasi Metode Didukung Deskripsi
List Groups GET /Groups Ya Mengembalikan grup peran Admin dan Member
Get Group GET /Groups/{id} Ya Mengambil grup beserta daftar anggota
Update Group PATCH /Groups/{id} Ya Menambah/menghapus anggota dari grup peran
Create Group POST /Groups Tidak Tidak didukung (peran bersifat tetap)

Atribut Pengguna yang Didukung

Atribut SCIM Kolom ScribbleMaps Wajib
userName Alamat email Ya
externalId Pengidentifikasi IdP eksternal Tidak
name.givenName Nama depan Tidak
name.familyName Nama belakang Tidak
displayName Nama tampilan Tidak
active Status akun Tidak
emails[].value Alamat email Tidak

Filter yang Didukung

Filter Contoh
Filter berdasarkan email userName eq "[email protected]"
Filter berdasarkan ID eksternal externalId eq "12345"
Filter berdasarkan status active eq true

Pengelolaan Siklus Hidup Pengguna

Saat Pengguna Diprovisioning

  1. Akun anggota tim baru dibuat di ScribbleMaps
  2. Informasi pengguna (nama, email) diisi dari IdP Anda
  3. Jika produk default dikonfigurasi dan kursi tersedia, lisensi akan ditetapkan secara otomatis
  4. Pengguna dapat segera masuk melalui SSO (jika dikonfigurasi)

Saat Pengguna Diperbarui

  1. Atribut pengguna (nama, nama tampilan) diperbarui agar sesuai dengan IdP Anda
  2. Perubahan email disinkronkan (kecuali pengguna telah menautkan akun mereka)

Saat Pengguna Dideprovisioning

  1. Akun pengguna dinonaktifkan (soft delete)
  2. Semua lisensi produk dihapus, membebaskan kursi
  3. Semua sesi aktif langsung dibatalkan
  4. Pengguna tidak dapat lagi masuk
  5. Data pengguna dan peta tetap dipertahankan (tidak dihapus)
  6. Akun dapat diaktifkan kembali jika pengguna diprovisioning ulang

Pengelolaan Peran melalui Grup

ScribbleMaps mengekspos dua grup peran melalui SCIM:

ID Grup Peran Izin
admin Administrator Mengelola setelan tim, pengguna, dan penagihan
member Member Akses anggota tim standar

Untuk menetapkan pengguna sebagai admin, tambahkan mereka ke grup admin melalui SCIM PATCH. Peran Owner tidak dapat diubah melalui SCIM.

Pemecahan Masalah

Masalah Umum

"401 Unauthorized" atau "Invalid token"

  • Verifikasi bahwa bearer token sudah benar dan belum dicabut
  • Pastikan token diteruskan di header Authorization sebagai Bearer YOUR_TOKEN
  • Periksa apakah token telah kedaluwarsa (jika masa berlaku ditetapkan)
  • Buat token baru jika diperlukan

"409 Conflict" - Pengguna sudah ada

  • Pengguna dengan email tersebut sudah ada di tim Anda
  • Jika pengguna yang sudah ada sebelumnya dinonaktifkan, SCIM akan secara otomatis mengaktifkannya kembali
  • Periksa alamat email duplikat di IdP Anda

"400 Bad Request" - Kolom wajib tidak ada

  • Pastikan userName (email) disertakan dalam permintaan
  • Verifikasi format email valid
  • Periksa konfigurasi pemetaan atribut IdP Anda

Pengguna dibuat tetapi tidak ada produk yang ditetapkan

  • Periksa apakah produk default dikonfigurasi di setelan SCIM
  • Verifikasi Anda memiliki kursi yang tersedia untuk produk default
  • Pengguna dapat ditetapkan produk secara manual di Team Settings

Perubahan pengguna tidak tersinkronisasi

  • Beberapa IdP melakukan sinkronisasi sesuai jadwal (misalnya, setiap 40 menit untuk Azure AD)
  • Coba paksa sinkronisasi manual di IdP Anda
  • Verifikasi SCIM masih diaktifkan dan token masih valid

Test connection gagal

  • Verifikasi SCIM Base URL persis https://api.scribblemaps.com/scim/v2
  • Pastikan tidak ada garis miring tambahan di akhir atau kesalahan ketik
  • Periksa bahwa jaringan/firewall Anda mengizinkan HTTPS keluar ke api.scribblemaps.com
     

Butuh Bantuan?

Jika Anda mengalami masalah dengan provisioning SCIM, silakan hubungi tim dukungan kami dengan menyertakan:

  • Nama Tim Anda
  • Identity Provider yang Anda gunakan
  • Pesan kesalahan apa pun dari log provisioning IdP Anda
  • Tangkapan layar konfigurasi SCIM Anda (dengan token disamarkan)

Kami siap membantu Anda mengonfigurasi provisioning SCIM untuk organisasi Anda.

Last updated