Pusat Bantuan Scribble Maps
Ganti basa

Provisioning SCIM

Ngonfigurasi Provisioning Panganggo SCIM

ScribbleMaps ndhukung SCIM 2.0 (System for Cross-domain Identity Management) kanggo provisioning lan deprovisioning panganggo kanthi otomatis. Iki ngidini sampeyan nyinkronake panganggo saka Identity Provider (IdP) sampeyan menyang ScribbleMaps kanthi otomatis, supaya keanggotaan tim tansah sinkron karo direktori organisasi sampeyan.

Provisioning SCIM kasedhiya ing team.scribblemaps.com lan gratis babar pisan.

Dhaptar Isi

  1. Apa iku SCIM?
  2. Sadurunge Miwiti
  3. Langkah 1: Aktifake SCIM ing ScribbleMaps
  4. Langkah 2: Gawe Bearer Token
  5. Langkah 3: Ngonfigurasi Identity Provider Sampeyan
  6. Langkah 4: Setel Penugasan Produk Standar
  7. Langkah 5: Uji lan Tugasake Panganggo
  8. Pandhuan Khusus Panyedhiya
  9. Operasi SCIM sing Didhukung
  10. Manajemen Siklus Urip Panganggo
  11. Ngatasi Masalah

Apa iku SCIM?

SCIM (System for Cross-domain Identity Management) minangka standar mbukak sing ngidini sampeyan kanthi otomatis:

  • Provision panganggo - Gawe akun ScribbleMaps kanthi otomatis nalika panganggo ditugasake ing IdP sampeyan
  • Anyari panganggo - Njaga informasi panganggo (jeneng, email) tetep sinkron
  • Deprovision panganggo - Nonaktifake akun kanthi otomatis nalika panganggo dicopot saka IdP sampeyan
  • Atur peran - Tugasake panganggo menyang peran Admin utawa Anggota liwat keanggotaan grup

SCIM bisa digunakake bebarengan karo SSO (SAML/OIDC) kanggo menehi manajemen siklus urip identitas sing lengkap.

Sadurunge Miwiti

  • Sampeyan kudu dadi Team Owner kanggo ngonfigurasi SCIM
  • Sampeyan butuh akses menyang konsol admin Identity Provider sampeyan
  • IdP sampeyan kudu ndhukung SCIM 2.0 (Okta, Microsoft Entra ID, OneLogin, JumpCloud, lan liya-liyane)
  • Disaranake ngonfigurasi SSO sadurunge SCIM supaya pengalaman panganggo paling apik

Langkah 1: Aktifake SCIM ing ScribbleMaps

  1. Mlebu menyang team.scribblemaps.com
  2. Bukak SCIM Provisioning (bilah sisih kiwa)
  3. Aktifake Enable SCIM dadi ON

Cathetan: Sampeyan kudu nggawe bearer token sadurunge SCIM bisa diaktifake kanthi lengkap.

Langkah 2: Gawe Bearer Token

Bearer token digunakake kanggo ngotentikasi Identity Provider sampeyan karo ScribbleMaps.

  1. Ing kaca setelan SCIM, klik Gawe Token
  2. Salin token kasebut langsung lan simpen kanthi aman

Cathetan Keamanan Penting:

  • Token mung ditampilake sapisan - yen ilang, sampeyan kudu nggawe sing anyar
  • Perlakukake token iki kaya sandhi - sapa wae sing duwe token bisa ngatur panganggo tim sampeyan
  • Sampeyan bisa mbatalake lan nggawe maneh token kapan wae yen kompromi
  • Mbatalake token langsung mungkasi kabeh operasi SCIM nganti token anyar dikonfigurasi

Langkah 3: Ngonfigurasi Identity Provider Sampeyan

Gunakake rincian ing ngisor iki kanggo ngonfigurasi ScribbleMaps minangka aplikasi SCIM ing IdP sampeyan:

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

Referensi Endpoint SCIM

Endpoint Tujuan
/scim/v2/Users Provisioning lan manajemen panganggo
/scim/v2/Groups Manajemen peran/keanggotaan grup
/scim/v2/ServiceProviderConfig Kapabilitas SCIM (discovery)
/scim/v2/ResourceTypes Jinis resource sing didhukung (discovery)
/scim/v2/Schemas Skema User lan Group (discovery)

Langkah 4: Setel Penugasan Produk Standar (Opsional)

Sampeyan bisa kanthi otomatis nugasake lisensi produk menyang panganggo nalika dipovision liwat SCIM:

  1. Ing kaca setelan SCIM, goleki Default Product Assignment
  2. Pilih produk:
    • Ora ana - Panganggo digawe tanpa produk (tugasake manual mengko)
    • Pandeleng - Akses mung kanggo mirsani
    • Pro Basic - Fitur panyuntingan standar
    • Pro Business - Akses fitur lengkap
  3. Klik Simpen

Cathetan: Panganggo mung bakal ditugasake produk yen ana seat sing kasedhiya. Yen ora ana seat sing kasedhiya, panganggo digawe nanging ora ditugasake.

Langkah 5: Uji lan Tugasake Panganggo

  1. Ing Identity Provider sampeyan, gunakake fitur Test Connection kanggo mriksa konektivitas SCIM
  2. Tugasake panganggo uji menyang aplikasi ScribbleMaps ing IdP sampeyan
  3. Priksa manawa panganggo muncul ing dhaptar anggota tim ScribbleMaps sampeyan
  4. Yen wis dikonfirmasi, tugasake panganggo utawa grup tambahan manut kabutuhan

Pandhuan Khusus Panyedhiya

Okta

  1. Ing Okta Admin Console, bukak Applications > Browse App Catalog
  2. Goleki "SCIM 2.0 Test App (Header Auth)" utawa gawe aplikasi SCIM kustom
  3. Bukak tab Provisioning > Configure API Integration
  4. Centhang Enable API integration
  5. Konfigurasi:
    • SCIM 2.0 Base URL: https://api.scribblemaps.com/scim/v2
    • OAuth Bearer Token: Tempel token SCIM ScribbleMaps sampeyan
  6. Klik Test API Credentials kanggo mriksa
  7. Bukak Provisioning > To App lan aktifake:
    • Create Users
    • Update User Attributes
    • Deactivate Users
  8. Bukak tab Assignments kanggo nugasake panganggo utawa grup

Microsoft Entra ID (Azure AD)

  1. Ing Azure Portal, bukak Microsoft Entra ID > Enterprise Applications
  2. Pilih aplikasi ScribbleMaps sampeyan (utawa gawe siji)
  3. Bukak Provisioning > Miwiti
  4. Setel Provisioning Mode dadi Automatic
  5. Ing Admin Credentials:
    • Tenant URL: https://api.scribblemaps.com/scim/v2
    • Secret Token: Tempel token SCIM ScribbleMaps sampeyan
  6. Klik Test Connection kanggo mriksa
  7. Konfigurasi Mappings kanggo atribut panganggo
  8. Setel Provisioning Status dadi On
  9. Bukak Users and groups kanggo nugasake panganggo

OneLogin

  1. Ing OneLogin Admin, bukak Applications > Add App
  2. Goleki "SCIM Provisioner with SAML (SCIM v2 Core)" utawa sing padha
  3. Bukak tab Konfigurasi
  4. Konfigurasi:
    • SCIM Base URL: https://api.scribblemaps.com/scim/v2
    • SCIM Bearer Token: Tempel token SCIM ScribbleMaps sampeyan
  5. Bukak tab Provisioning lan aktifake provisioning
  6. Bukak tab Pangguna kanggo nugasake panganggo

JumpCloud

  1. Ing JumpCloud Admin, bukak SSO Applications
  2. Klik + kanggo nambah aplikasi anyar
  3. Pilih Custom SCIM
  4. Konfigurasi:
    • Base URL: https://api.scribblemaps.com/scim/v2
    • Token Key: Tempel token SCIM ScribbleMaps sampeyan
    • Authentication: Bearer Token
  5. Klik Test Connection
  6. Konfigurasi pemetaan atribut
  7. Tugasake grup panganggo menyang aplikasi

Operasi SCIM sing Didhukung

Operasi Panganggo

Operasi Metode Didhukung Katrangan
List Users GET /Users Ya Njupuk kabeh panganggo kanthi pagination lan panyaringan
Get User GET /Users/{id} Ya Njupuk panganggo tartamtu adhedhasar ID
Create User POST /Users Ya Provision panganggo anyar
Replace User PUT /Users/{id} Ya Anyari lengkap atribut panganggo
Update User PATCH /Users/{id} Ya Anyari sebagean atribut panganggo
Delete User DELETE /Users/{id} Ya Nonaktifake panganggo (soft delete)

Operasi Grup

Operasi Metode Didhukung Katrangan
List Groups GET /Groups Ya Ngasilake grup peran Admin lan Anggota
Get Group GET /Groups/{id} Ya Njupuk grup kanthi dhaptar anggota
Update Group PATCH /Groups/{id} Ya Tambah/busak anggota saka grup peran
Create Group POST /Groups Ora Ora didhukung (peran wis tetep)

Atribut Panganggo sing Didhukung

Atribut SCIM Kolom ScribbleMaps Dibutuhake
userName Alamat email Ya
externalId Pengenal IdP eksternal Ora
name.givenName Jeneng ngarep Ora
name.familyName Jeneng mburi Ora
displayName Jeneng tampilan Ora
active Status akun Ora
emails[].value Alamat email Ora

Saringan sing Didhukung

Saringan Tuladha
Saring adhedhasar email userName eq "[email protected]"
Saring adhedhasar external ID externalId eq "12345"
Saring adhedhasar status active eq true

Manajemen Siklus Urip Panganggo

Nalika Panganggo Diprovision

  1. Akun anggota tim anyar digawe ing ScribbleMaps
  2. Informasi panganggo (jeneng, email) diisi saka IdP sampeyan
  3. Yen produk standar wis dikonfigurasi lan seat kasedhiya, lisensi ditugasake kanthi otomatis
  4. Panganggo bisa langsung mlebu liwat SSO (yen wis dikonfigurasi)

Nalika Panganggo Dianyari

  1. Atribut panganggo (jeneng, jeneng tampilan) dianyari supaya cocog karo IdP sampeyan
  2. Owah-owahan email disinkronake (kajaba yen panganggo wis nyambungake akune)

Nalika Panganggo Dideprovision

  1. Akun panganggo dinonaktifake (soft delete)
  2. Kabeh lisensi produk dicopot, mula seat dadi bebas
  3. Kabeh sesi aktif langsung dibatalake
  4. Panganggo ora bisa mlebu maneh
  5. Data lan peta panganggo tetep disimpen (ora dibusak)
  6. Akun bisa diaktifake maneh yen panganggo diprovision maneh

Manajemen Peran liwat Grup

ScribbleMaps nyedhiyakake rong grup peran liwat SCIM:

ID Grup Peran Idin
admin Administrator Ngatur setelan tim, panganggo, lan tagihan
member Anggota Akses anggota tim standar

Kanggo nugasake panganggo minangka admin, tambahake menyang grup admin liwat SCIM PATCH. Peran Owner ora bisa diowahi liwat SCIM.

Ngatasi Masalah

Masalah Umum

"401 Unauthorized" utawa "Invalid token"

  • Priksa manawa bearer token bener lan durung dibatalake
  • Pastekake token dikirim ing Authorization header minangka Bearer YOUR_TOKEN
  • Priksa manawa token wis kadaluwarsa (yen kadaluwarsa wis disetel)
  • Gawe token anyar yen perlu

"409 Conflict" - Panganggo wis ana

  • Panganggo kanthi email kasebut wis ana ing tim sampeyan
  • Yen panganggo sing ana wis dinonaktifake, SCIM bakal ngaktifake maneh kanthi otomatis
  • Priksa manawa ana alamat email dobel ing IdP sampeyan

"400 Bad Request" - Kolom sing dibutuhake ilang

  • Pastekake userName (email) kalebu ing request
  • Priksa manawa format email valid
  • Priksa konfigurasi pemetaan atribut IdP sampeyan

Panganggo digawe nanging ora ana produk sing ditugasake

  • Priksa manawa produk standar wis dikonfigurasi ing setelan SCIM
  • Priksa manawa sampeyan duwe seat sing kasedhiya kanggo produk standar
  • Panganggo bisa ditugasake produk kanthi manual ing Team Settings

Owah-owahan panganggo ora sinkron

  • Sawetara IdP sinkron miturut jadwal (contone, saben 40 menit kanggo Azure AD)
  • Coba pekso sinkronisasi manual ing IdP sampeyan
  • Priksa manawa SCIM isih aktif lan token isih valid

Test connection gagal

  • Priksa manawa SCIM Base URL persis https://api.scribblemaps.com/scim/v2
  • Pastekake ora ana garis miring ing mburi utawa salah ketik
  • Priksa manawa jaringan/firewall sampeyan ngidini HTTPS metu menyang api.scribblemaps.com
     

Butuh Pitulungan?

Yen sampeyan ngalami masalah karo provisioning SCIM, mangga hubungi tim dhukungan kita kanthi nyedhiyakake:

  • Jeneng Tim sampeyan
  • Identity Provider sing sampeyan gunakake
  • Pesen kesalahan apa wae saka log provisioning IdP sampeyan
  • Gambar layar konfigurasi SCIM sampeyan (token disamarake)

Kita ana ing kene kanggo nulungi sampeyan ngonfigurasi provisioning SCIM kanggo organisasi sampeyan.

Pungkasan dianyari