Tzentru de agiudu de Scribble Maps
Muda sa limba

Provisioning SCIM

Cunfigurare su Provisioning de Utentes SCIM

ScribbleMaps suportat SCIM 2.0 (System for Cross-domain Identity Management) pro su provisioning e deprovisioning automàticu de utentes. Custu ti permitit de sincronizare automaticamente is utentes dae su Identity Provider (IdP) tuo a ScribbleMaps, garantende chi sa pertzenèntzia a s'iscuadra b'resti sincronizada cun sa directory de s'organizatzione tua.

Su provisioning SCIM est disponìbile in team.scribblemaps.com e est totally gratuitu.

Inditze

  1. Ite est SCIM?
  2. In antis de Cominzare
  3. Passu 1: Ativa SCIM in ScribbleMaps
  4. Passu 2: Gènera unu Bearer Token
  5. Passu 3: Cunfigura su Identity Provider Tuo
  6. Passu 4: Defini s'Assignatzione de Prodotu Predefinida
  7. Passu 5: Proa e Assigna Utentes
  8. Ghias Ispetzìficas pro Provider
  9. Operatziones SCIM Suportadas
  10. Ghestione de su Tzìclu de Vida de s'Utente
  11. Risolutzione de Problemas

Ite est SCIM?

SCIM (System for Cross-domain Identity Management) est unu istandard abertu chi ti permitit de fàghere automaticamente:

  • Provisioning de utentes - Crea automaticamente contos ScribbleMaps cando is utentes benint assignados in s'IdP tuo
  • Agiornamentu de utentes - Mantene sincronizadas is informatziones de s'utente (nùmene, e-mail)
  • Deprovisioning de utentes - Disativa automaticamente is contos cando is utentes benint bogados dae s'IdP tuo
  • Ghestione de ruolos - Assigna is utentes a is ruolos Amministradore o Membru tràmite sa pertzenèntzia a grupos

SCIM funtzionat paris cun SSO (SAML/OIDC) pro furrire una ghestione cumpleta de su tzìclu de vida de s'identidade.

In antis de Cominzare

  • Depes èssere Team Owner pro cunfigurare SCIM
  • Ti serbit s'atzessu a sa consola de amministratzione de s'Identity Provider tuo
  • S'IdP tuo depet suportare SCIM 2.0 (Okta, Microsoft Entra ID, OneLogin, JumpCloud, etc.)
  • Ti cussigiamus de cunfigurare SSO in antis de SCIM pro un'esperièntzia mègius de s'utente

Passu 1: Ativa SCIM in ScribbleMaps

  1. Intra in team.scribblemaps.com
  2. Bae a SCIM Provisioning (barra laterale a manca)
  3. Ativa Enable SCIM in ON

Nota: Ti at a serbire de generare unu bearer token in antis chi SCIM potzat èssere ativadu de manera cumpleta.

Passu 2: Gènera unu Bearer Token

Su bearer token autèntica s'Identity Provider tuo cun ScribbleMaps.

  1. In sa pàgina de impostatziones SCIM, blica Gènera Token
  2. Còpia su token a sa lestra e sarva·lu in manera segura

Notas Importantes de Seguresa:

  • Su token benit ammustradu isceti una borta - si ddu perdes, ti at a serbire de generare unu nou
  • Tràtta custu token comente una password - chie tenet su token podet ghestire is utentes de s'iscuadra tua
  • Podes revocare e rigenerare su token in cale si siat momentu si est cumpromissu
  • Revocare unu token firmat immediatamente totu is operatziones SCIM fintzas a cando non benit cunfiguradu unu token nou

Passu 3: Cunfigura su Identity Provider Tuo

Imprea custos dettàllios pro cunfigurare ScribbleMaps comente aplicatzione SCIM in s'IdP tuo:

Impostatziones Balore
SCIM Base URL https://api.scribblemaps.com/scim/v2
Mètodu de Autenticatzione HTTP Header / Bearer Token
Intestatzione de Autorizatzione Bearer YOUR_TOKEN_HERE
Identificadore Ùnicu userName (indiritzu e-mail)

Riferimentu de is Endpoint SCIM

Endpoint Iscopu
/scim/v2/Users Provisioning e ghestione de utentes
/scim/v2/Groups Ghestione de ruolos/pertzenèntzia a grupos
/scim/v2/ServiceProviderConfig Capatzidades SCIM (discovery)
/scim/v2/ResourceTypes Tipos de risorsa suportados (discovery)
/scim/v2/Schemas Schemas de Utente e Grupu (discovery)

Passu 4: Defini s'Assignatzione de Prodotu Predefinida (Opzionale)

Podes assignare automaticamente una litzèntzia de prodotu a is utentes cando benint provisionados tràmite SCIM:

  1. In sa pàgina de impostatziones SCIM, agata Default Product Assignment
  2. Seletziona unu prodotu:
    • Nudda - Is utentes benint creados chene prodotu (assigna a manu a pustis)
    • Visualizadore - Atzessu de isceti letura
    • Pro Basic - Funtzionalidades de editzione istandard
    • Pro Business - Atzessu cumpletu a is funtzionalidades
  3. Blica Sarva

Nota: Is utentes ant a retzire unu prodotu isceti si b'at postos disponìbiles. Si non b'at postos disponìbiles, s'utente benit creadu ma lassadu chene assignatzione.

Passu 5: Proa e Assigna Utentes

  1. In s'Identity Provider tuo, imprea sa funtzione Test Connection pro verificare sa connessione SCIM
  2. Assigna un'utente de proa a s'aplicatzione ScribbleMaps in s'IdP tuo
  3. Verifica chi s'utente aparat in sa lista de is membros de s'iscuadra ScribbleMaps tua
  4. Una borta cunfirmadu, assigna àtere utentes o grupos comente serbit

Ghias Ispetzìficas pro Provider

Okta

  1. In s'Okta Admin Console, bae a Applications > Browse App Catalog
  2. Chirca "SCIM 2.0 Test App (Header Auth)" o crea un'app SCIM personalizada
  3. Bae a sa tab Provisioning > Configure API Integration
  4. Marca Enable API integration
  5. Cunfigura:
    • SCIM 2.0 Base URL: https://api.scribblemaps.com/scim/v2
    • OAuth Bearer Token: Aplica su token SCIM de ScribbleMaps tuo
  6. Blica Test API Credentials pro verificare
  7. Bae a Provisioning > To App e ativa:
    • Create Users
    • Update User Attributes
    • Deactivate Users
  8. Bae a sa tab Assignments pro assignare utentes o grupos

Microsoft Entra ID (Azure AD)

  1. In su Portale Azure, bae a Microsoft Entra ID > Enterprise Applications
  2. Seletziona s'aplicatzione ScribbleMaps tua (o creane una)
  3. Bae a Provisioning > Comintza
  4. Defini Provisioning Mode a Automatic
  5. In Admin Credentials:
    • Tenant URL: https://api.scribblemaps.com/scim/v2
    • Secret Token: Aplica su token SCIM de ScribbleMaps tuo
  6. Blica Test Connection pro verificare
  7. Cunfigura is Mappings pro is atributos de s'utente
  8. Defini Provisioning Status a On
  9. Bae a Users and groups pro assignare utentes

OneLogin

  1. In OneLogin Admin, bae a Applications > Add App
  2. Chirca "SCIM Provisioner with SAML (SCIM v2 Core)" o simile
  3. Bae a sa tab Configuration
  4. Cunfigura:
    • SCIM Base URL: https://api.scribblemaps.com/scim/v2
    • SCIM Bearer Token: Aplica su token SCIM de ScribbleMaps tuo
  5. Bae a sa tab Provisioning e ativa su provisioning
  6. Bae a sa tab Users pro assignare utentes

JumpCloud

  1. In JumpCloud Admin, bae a SSO Applications
  2. Blica + pro agiunghere un'aplicatzione noa
  3. Seletziona Custom SCIM
  4. Cunfigura:
    • Base URL: https://api.scribblemaps.com/scim/v2
    • Token Key: Aplica su token SCIM de ScribbleMaps tuo
    • Authentication: Bearer Token
  5. Blica Test Connection
  6. Cunfigura is mapatziones de atributos
  7. Assigna grupos de utentes a s'aplicatzione

Operatziones SCIM Suportadas

Operatziones de Utente

Operatzione Mètodu Suportadu Descritzione
List Users GET /Users Eja Recuperare totu is utentes cun paginatzione e filtros
Get User GET /Users/{id} Eja Recuperare un'utente ispetzìficu pro ID
Create User POST /Users Eja Provisionare un'utente nou
Replace User PUT /Users/{id} Eja Agiornamentu cumpletu de is atributos de s'utente
Update User PATCH /Users/{id} Eja Agiornamentu partziale de is atributos de s'utente
Delete User DELETE /Users/{id} Eja Disativare s'utente (soft delete)

Operatziones de Grupu

Operatzione Mètodu Suportadu Descritzione
List Groups GET /Groups Eja Torrat is grupos de ruolu Amministradore e Membru
Get Group GET /Groups/{id} Eja Recuperare unu grupu cun sa lista de is membros
Update Group PATCH /Groups/{id} Eja Agiunghere/bogare membros dae is grupos de ruolu
Create Group POST /Groups No Non suportadu (is ruolos sunt fissos)

Atributos de Utente Suportados

Atributu SCIM Campu ScribbleMaps Obligatòriu
userName Indiritzu e-mail Eja
externalId Identificadore IdP esternu No
name.givenName Nùmene No
name.familyName Sambenadu No
displayName Nùmene visualizadu No
active Istadu de su contu No
emails[].value Indiritzu e-mail No

Filtros Suportados

Filtru Esèmpiu
Filtru pro e-mail userName eq "[email protected]"
Filtru pro ID esternu externalId eq "12345"
Filtru pro istadu active eq true

Ghestione de su Tzìclu de Vida de s'Utente

Cando un'Utente benit Provisionadu

  1. Unu contu nou de membru de s'iscuadra benit creadu in ScribbleMaps
  2. Is informatziones de s'utente (nùmene, e-mail) benint populadas dae s'IdP tuo
  3. Si unu prodotu predefinidu est cunfiguradu e b'at postos disponìbiles, una litzèntzia benit assignada automaticamente
  4. S'utente podet intrare immediatamente tràmite SSO (si cunfiguradu)

Cando un'Utente benit Agiornadu

  1. Is atributos de s'utente (nùmene, nùmene visualizadu) benint agiornados pro currispondere a s'IdP tuo
  2. Is cambiamentos de e-mail benint sincronizados (francu chi s'utente apat collegadu su contu suo)

Cando un'Utente benit Deprovisionadu

  1. Su contu de s'utente benit disativadu (soft delete)
  2. Totu is litzèntzias de prodotu benint bogadas, liberende is postos
  3. Totu is sessiones ativas benint invalidadas immediatamente
  4. S'utente non podet pius intrare
  5. Is datos e is mapas de s'utente benint mantènnidos (no cantzelladas)
  6. Su contu podet èssere riativadu si s'utente benit provisionadu torra

Ghestione de Ruolos tràmite Grupos

ScribbleMaps espondet duos grupos de ruolu tràmite SCIM:

ID de Grupu Ruolu Permissos
admin Amministradore Ghestionare impostatziones de s'iscuadra, utentes e fatturatzione
member Membru Atzessu istandard de membru de s'iscuadra

Pro assignare un'utente comente amministradore, agiunghe·ddu a su grupu admin tràmite SCIM PATCH. Su ruolu Owner non podet èssere modificadu tràmite SCIM.

Risolutzione de Problemas

Problemas Comunes

"401 Unauthorized" o "Invalid token"

  • Verifica chi su bearer token siat curretu e non siat istadu revocadu
  • Assegura·ti chi su token siat passadu in s'intestatzione Authorization comente Bearer YOUR_TOKEN
  • Controlla si su token est iscadidu (si fiat istadu impostadu un'iscadèntzia)
  • Gènera unu token nou si serbit

"409 Conflict" - S'utente esistit giai

  • Un'utente cun cuss'e-mail esistit giai in s'iscuadra tua
  • Si s'utente esistente fiat istadu disativadu, SCIM ddu at a riativare automaticamente
  • Controlla chi non b'apat indiritzos e-mail duplicados in s'IdP tuo

"400 Bad Request" - Campu obligatòriu mancante

  • Assegura·ti chi userName (e-mail) siat incluidu in sa rechesta
  • Verifica chi su formatu de s'e-mail siat vàlidu
  • Controlla sa cunfiguratzione de mapatzione de is atributos de s'IdP tuo

Utentes creados ma nissunu prodotu assignadu

  • Controlla si unu prodotu predefinidu est cunfiguradu in is impostatziones SCIM
  • Verifica chi tengas postos disponìbiles pro su prodotu predefinidu
  • Is utentes podent èssere assignados a prodotos a manu in Team Settings

Is cambiamentos de s'utente non si sincronizant

  • Calicunu IdP sincronizat segundu una programmatzione (pro esèmpiu, cada 40 minutos pro Azure AD)
  • Proa a fortzare una sincronizatzione manuale in s'IdP tuo
  • Verifica chi SCIM siat galu ativu e su token siat vàlidu

Sa proa de connessione faddit

  • Verifica chi su SCIM Base URL siat esatamente https://api.scribblemaps.com/scim/v2
  • Assegura·ti chi non b'apat slash finales o errores de iscritura
  • Controlla chi sa rete/firewall tua permitat HTTPS in essida a api.scribblemaps.com
     

Tenes Bisòngiu de Agiudu?

Si ses tenende problemas cun su provisioning SCIM, cuntata s'iscuadra de suportu nostra cun:

  • Su nùmene de s'Iscuadra tua
  • S'Identity Provider chi ses impreende
  • Calesisiat messàgiu de errore dae is log de provisioning de s'IdP tuo
  • Screenshots de sa cunfiguratzione SCIM tua (cun su token cuadu)

Semus inoghe pro t'agiudare a cunfigurare su provisioning SCIM pro s'organizatzione tua.

Ùrtima atualizatzione