Centrul de ajutor Scribble Maps
Schimbă limba

SCIM Provisioning

Configurarea provizionării utilizatorilor prin SCIM

ScribbleMaps acceptă SCIM 2.0 (System for Cross-domain Identity Management) pentru provizionarea și deprovizionarea automată a utilizatorilor. Acest lucru vă permite să sincronizați automat utilizatorii de la Furnizorul dvs. de Identitate (IdP) la ScribbleMaps, asigurându-vă că componența echipei rămâne sincronizată cu directorul organizației dvs.

Provizionarea SCIM este disponibilă la team.scribblemaps.com și este complet gratuită.

Cuprins

  1. Ce este SCIM?
  2. Înainte de a începe
  3. Pasul 1: Activați SCIM în ScribbleMaps
  4. Pasul 2: Generați un Bearer Token
  5. Pasul 3: Configurați Furnizorul de Identitate
  6. Pasul 4: Setați alocarea implicită a produselor
  7. Pasul 5: Testați și atribuiți utilizatori
  8. Ghiduri specifice furnizorilor
  9. Operațiuni SCIM acceptate
  10. Gestionarea ciclului de viață al utilizatorilor
  11. Depanare

Ce este SCIM?

SCIM (System for Cross-domain Identity Management) este un standard deschis care vă permite să efectuați automat următoarele:

  • Provizionarea utilizatorilor - Creați automat conturi ScribbleMaps atunci când utilizatorii sunt alocați în IdP-ul dvs.
  • Actualizarea utilizatorilor - Păstrați informațiile despre utilizatori (nume, e-mail) sincronizate
  • Deprovizionarea utilizatorilor - Dezactivați automat conturile atunci când utilizatorii sunt eliminați din IdP-ul dvs.
  • Gestionarea rolurilor - Atribuiți utilizatorii rolurilor de Admin sau Member prin intermediul apartenenței la grup

SCIM funcționează alături de SSO (SAML/OIDC) pentru a oferi o gestionare completă a ciclului de viață al identității.

Înainte de a începe

  • Trebuie să fiți un Team Owner pentru a configura SCIM
  • Aveți nevoie de acces la consola de administrare a Furnizorului dvs. de Identitate
  • IdP-ul dvs. trebuie să accepte SCIM 2.0 (Okta, Microsoft Entra ID, OneLogin, JumpCloud etc.)
  • Vă recomandăm să configurați SSO înainte de SCIM pentru o experiență optimă a utilizatorului

Pasul 1: Activați SCIM în ScribbleMaps

  1. Conectați-vă la team.scribblemaps.com
  2. Navigați la SCIM Provisioning (bara laterală stângă)
  3. Comutați Enable SCIM pe ON

Notă: Va trebui să generați un token bearer înainte ca SCIM să poată fi complet activat.

Pasul 2: Generați un Bearer Token

Tokenul bearer autentifică Furnizorul dvs. de Identitate în raport cu ScribbleMaps.

  1. Pe pagina de setări SCIM, faceți clic pe Generate Token
  2. Copiați tokenul imediat și stocați-l în siguranță

Note importante de securitate:

  • Tokenul este afișat o singură dată - dacă îl pierdeți, va trebui să generați unul nou
  • Tratați acest token ca pe o parolă - oricine are tokenul poate gestiona utilizatorii echipei dvs.
  • Puteți revoca și regenera tokenul în orice moment dacă acesta este compromis
  • Revocarea unui token oprește imediat toate operațiunile SCIM până când este configurat un nou token

Pasul 3: Configurați Furnizorul de Identitate

Utilizați următoarele detalii pentru a configura ScribbleMaps ca aplicație SCIM în IdP-ul dvs.:

Setare Valoare
SCIM Base URL https://api.scribblemaps.com/scim/v2
Metodă de autentificare HTTP Header / Bearer Token
Antet de autorizare Bearer YOUR_TOKEN_HERE
Identificator unic userName (email address)

Referință puncte terminale (Endpoints) SCIM

Punct terminal (Endpoint) Scop
/scim/v2/Users Provizionarea și gestionarea utilizatorilor
/scim/v2/Groups Gestionarea apartenenței la roluri/grupuri
/scim/v2/ServiceProviderConfig Capabilități SCIM (descoperire)
/scim/v2/ResourceTypes Tipuri de resurse acceptate (descoperire)
/scim/v2/Schemas Scheme de utilizatori și grupuri (descoperire)

Pasul 4: Setați alocarea implicită a produselor (Opțional)

Puteți atribui automat o licență de produs utilizatorilor atunci când aceștia sunt provizionați prin SCIM:

  1. Pe pagina de setări SCIM, găsiți Default Product Assignment
  2. Selectați un produs:
    • None - Utilizatorii sunt creați fără un produs (atribuiți manual mai târziu)
    • Viewer - Acces doar pentru vizualizare
    • Pro Basic - Caracteristici standard de editare
    • Pro Business - Acces complet la funcții
  3. Faceți clic pe Save

Notă: Utilizatorilor li se va atribui un produs numai dacă sunt disponibile locuri. Dacă nu sunt locuri disponibile, utilizatorul este creat, dar rămâne neatribuit.

Pasul 5: Testați și atribuiți utilizatori

  1. În Furnizorul dvs. de Identitate, utilizați funcția Test Connection pentru a verifica conectivitatea SCIM
  2. Atribuiți un utilizator de test aplicației ScribbleMaps în IdP-ul dvs.
  3. Verificați dacă utilizatorul apare în lista de membri ai echipei ScribbleMaps
  4. După confirmare, atribuiți utilizatori sau grupuri suplimentare, după cum este necesar

Ghiduri specifice furnizorilor

Okta

  1. În Okta Admin Console, accesați Applications > Browse App Catalog
  2. Căutați „SCIM 2.0 Test App (Header Auth)” sau creați o aplicație SCIM personalizată
  3. Accesați fila Provisioning > Configure API Integration
  4. Bifați Enable API integration
  5. Configurați:
    • SCIM 2.0 Base URL: https://api.scribblemaps.com/scim/v2
    • OAuth Bearer Token: Lipiți tokenul SCIM ScribbleMaps
  6. Faceți clic pe Test API Credentials pentru a verifica
  7. Accesați Provisioning > To App și activați:
    • Create Users
    • Update User Attributes
    • Deactivate Users
  8. Accesați fila Assignments pentru a atribui utilizatori sau grupuri

Microsoft Entra ID (Azure AD)

  1. În Azure Portal, accesați Microsoft Entra ID > Enterprise Applications
  2. Selectați aplicația ScribbleMaps (sau creați una)
  3. Accesați Provisioning > Get Started
  4. Setați Provisioning Mode pe Automatic
  5. Sub Admin Credentials:
    • Tenant URL: https://api.scribblemaps.com/scim/v2
    • Secret Token: Lipiți tokenul SCIM ScribbleMaps
  6. Faceți clic pe Test Connection pentru a verifica
  7. Configurați Mappings pentru atributele utilizatorului
  8. Setați Provisioning Status pe On
  9. Accesați Users and groups pentru a atribui utilizatori

OneLogin

  1. În OneLogin Admin, accesați Applications > Add App
  2. Căutați „SCIM Provisioner with SAML (SCIM v2 Core)” sau similar
  3. Accesați fila Configuration
  4. Configurați:
    • SCIM Base URL: https://api.scribblemaps.com/scim/v2
    • SCIM Bearer Token: Lipiți tokenul SCIM ScribbleMaps
  5. Accesați fila Provisioning și activați provizionarea
  6. Accesați fila Users pentru a atribui utilizatori

JumpCloud

  1. În JumpCloud Admin, accesați SSO Applications
  2. Faceți clic pe + pentru a adăuga o aplicație nouă
  3. Selectați Custom SCIM
  4. Configurați:
    • Base URL: https://api.scribblemaps.com/scim/v2
    • Token Key: Lipiți tokenul SCIM ScribbleMaps
    • Authentication: Bearer Token
  5. Faceți clic pe Test Connection
  6. Configurați mapările de atribute
  7. Atribuiți grupuri de utilizatori aplicației

Operațiuni SCIM acceptate

Operațiuni cu utilizatori

Operațiune Metodă Acceptat Descriere
List Users GET /Users Da Preluarea tuturor utilizatorilor cu paginare și filtrare
Get User GET /Users/{id} Da Preluarea unui anumit utilizator după ID
Create User POST /Users Da Provizionarea unui utilizator nou
Replace User PUT /Users/{id} Da Actualizarea completă a atributelor utilizatorului
Update User PATCH /Users/{id} Da Actualizarea parțială a atributelor utilizatorului
Delete User DELETE /Users/{id} Da Dezactivarea utilizatorului (ștergere logică)

Operațiuni cu grupuri

Operațiune Metodă Acceptat Descriere
List Groups GET /Groups Da Returnează grupurile de roluri Admin și Member
Get Group GET /Groups/{id} Da Preluarea grupului cu lista de membri
Update Group PATCH /Groups/{id} Da Adăugarea/eliminarea membrilor din grupurile de roluri
Create Group POST /Groups Nu Neacceptat (rolurile sunt fixe)

Atribute de utilizator acceptate

Atribut SCIM Câmp ScribbleMaps Obligatoriu
userName Adresă de e-mail Da
externalId Identificator extern IdP Nu
name.givenName Prenume Nu
name.familyName Nume de familie Nu
displayName Nume afișat Nu
active Starea contului Nu
emails[].value Adresă de e-mail Nu

Filtre acceptate

Filtru Exemplu
Filtrare după e-mail userName eq "[email protected]"
Filtrare după ID extern externalId eq "12345"
Filtrare după stare active eq true

Gestionarea ciclului de viață al utilizatorilor

Când un utilizator este provizionat

  1. Un nou cont de membru al echipei este creat în ScribbleMaps
  2. Informațiile despre utilizator (nume, e-mail) sunt completate din IdP-ul dvs.
  3. Dacă este configurat un produs implicit și sunt disponibile locuri, o licență este atribuită automat
  4. Utilizatorul se poate conecta imediat prin SSO (dacă este configurat)

Când un utilizator este actualizat

  1. Atributele utilizatorului (nume, nume afișat) sunt actualizate pentru a corespunde cu cele din IdP-ul dvs.
  2. Modificările de e-mail sunt sincronizate (cu excepția cazului în care utilizatorul și-a asociat contul)

Când un utilizator este deprovizionat

  1. Contul utilizatorului este dezactivat (ștergere logică)
  2. Toate licențele de produs sunt eliminate, eliberând locuri
  3. Toate sesiunile active sunt invalidate imediat
  4. Utilizatorul nu se mai poate conecta
  5. Datele și hărțile utilizatorului sunt păstrate (nu sunt șterse)
  6. Contul poate fi reactivat dacă utilizatorul este reprovizionat

Gestionarea rolurilor prin intermediul grupurilor

ScribbleMaps expune două grupuri de roluri prin SCIM:

ID grup Rol Permisiuni
admin Administrator Gestionarea setărilor echipei, a utilizatorilor și a facturării
member Membru (Member) Acces standard pentru membrii echipei

Pentru a atribui un utilizator ca administrator, adăugați-l în grupul admin prin SCIM PATCH. Rolul Owner nu poate fi modificat prin SCIM.

Depanare

Probleme frecvente

„401 Unauthorized” sau „Invalid token”

  • Verificați dacă tokenul bearer este corect și nu a fost revocat
  • Asigurați-vă că tokenul este transmis în antetul Authorization ca Bearer YOUR_TOKEN
  • Verificați dacă tokenul a expirat (dacă a fost setată o dată de expirare)
  • Generați un token nou dacă este necesar

„409 Conflict” - Utilizatorul există deja

  • Un utilizator cu acea adresă de e-mail există deja în echipa dvs.
  • Dacă utilizatorul existent a fost dezactivat, SCIM îl va reactiva automat
  • Verificați dacă există adrese de e-mail duplicate în IdP-ul dvs.

„400 Bad Request” - Câmp obligatoriu lipsă

  • Asigurați-vă că userName (e-mailul) este inclus în solicitare
  • Verificați dacă formatul e-mailului este valid
  • Verificați configurația de mapare a atributelor din IdP-ul dvs.

Utilizatori creați, dar niciun produs atribuit

  • Verificați dacă este configurat un produs implicit în setările SCIM
  • Verificați dacă aveți locuri disponibile pentru produsul implicit
  • Utilizatorilor li se pot atribui produse manual în Team Settings

Modificările utilizatorilor nu se sincronizează

  • Unele IdP-uri se sincronizează conform unui program (de exemplu, la fiecare 40 de minute pentru Azure AD)
  • Încercați să forțați o sincronizare manuală în IdP-ul dvs.
  • Verificați dacă SCIM este încă activat și dacă tokenul este valid

Conexiunea de test eșuează

  • Verificați dacă SCIM Base URL este exact https://api.scribblemaps.com/scim/v2
  • Asigurați-vă că nu există slash-uri la sfârșit sau greșeli de tipar
  • Verificați dacă rețeaua/firewall-ul dvs. permite HTTPS de ieșire către api.scribblemaps.com
     

Aveți nevoie de ajutor?

Dacă întâmpinați probleme cu provizionarea SCIM, vă rugăm să contactați echipa noastră de asistență furnizând:

  • Numele echipei dvs. (Team name)
  • Furnizorul de Identitate pe care îl utilizați
  • Orice mesaje de eroare din jurnalele de provizionare ale IdP-ului dvs.
  • Capturi de ecran ale configurației dvs. SCIM (cu tokenul mascat)

Suntem aici pentru a vă ajuta să configurați provizionarea SCIM pentru organizația dvs.

Ultima actualizare