Scribble Maps Help Center
Change language

SCIM-etablering

Konfigurera SCIM-användaretablering

ScribbleMaps stöder SCIM 2.0 (System for Cross-domain Identity Management) för automatiserad etablering och avetablering av användare. Detta gör att du automatiskt kan synkronisera användare från din identitetsleverantör (IdP) till ScribbleMaps, så att teammedlemskap hålls i synk med din organisations katalog.

SCIM-etablering är tillgängligt på team.scribblemaps.com och är helt gratis.

Innehållsförteckning

  1. Vad är SCIM?
  2. Innan du börjar
  3. Steg 1: Aktivera SCIM i ScribbleMaps
  4. Steg 2: Generera en Bearer-token
  5. Steg 3: Konfigurera din identitetsleverantör
  6. Steg 4: Ange standardprodukttilldelning
  7. Steg 5: Testa och tilldela användare
  8. Leverantörsspecifika guider
  9. Stödda SCIM-åtgärder
  10. Hantering av användarens livscykel
  11. Felsökning

Vad är SCIM?

SCIM (System for Cross-domain Identity Management) är en öppen standard som gör att du automatiskt kan:

  • Etablera användare - Skapa ScribbleMaps-konton automatiskt när användare tilldelas i din IdP
  • Uppdatera användare - Hålla användarinformation (namn, e-post) synkroniserad
  • Avetablera användare - Inaktivera konton automatiskt när användare tas bort från din IdP
  • Hantera roller - Tilldela användare till rollerna Administratör eller Medlem via gruppmedlemskap

SCIM fungerar tillsammans med SSO (SAML/OIDC) för att ge en komplett hantering av identitetens livscykel.

Innan du börjar

  • Du måste vara Team Owner för att konfigurera SCIM
  • Du behöver åtkomst till din identitetsleverantörs administratörskonsol
  • Din IdP måste stödja SCIM 2.0 (Okta, Microsoft Entra ID, OneLogin, JumpCloud, etc.)
  • Vi rekommenderar att du konfigurerar SSO innan SCIM för bästa användarupplevelse

Steg 1: Aktivera SCIM i ScribbleMaps

  1. Logga in på team.scribblemaps.com
  2. Navigera till SCIM Provisioning (vänster sidofält)
  3. Slå på Enable SCIM

Obs: Du måste generera en bearer-token innan SCIM kan aktiveras helt.

Steg 2: Generera en Bearer-token

Bearer-token autentiserar din identitetsleverantör mot ScribbleMaps.

  1. På SCIM-inställningssidan, klicka på Generate Token
  2. Kopiera token omedelbart och förvara den säkert

Viktiga säkerhetsanmärkningar:

  • Token visas endast en gång - om du tappar bort den måste du generera en ny
  • Behandla denna token som ett lösenord - alla med token kan hantera ditt teams användare
  • Du kan återkalla och generera om token när som helst om den komprometteras
  • Att återkalla en token stoppar omedelbart alla SCIM-åtgärder tills en ny token konfigureras

Steg 3: Konfigurera din identitetsleverantör

Använd följande uppgifter för att konfigurera ScribbleMaps som ett SCIM-program i din IdP:

Inställning Värde
SCIM Base URL https://api.scribblemaps.com/scim/v2
Autentiseringsmetod HTTP Header / Bearer Token
Authorization Header Bearer YOUR_TOKEN_HERE
Unik identifierare userName (e-postadress)

Referens för SCIM-slutpunkter

Slutpunkt Syfte
/scim/v2/Users Etablering och hantering av användare
/scim/v2/Groups Hantering av roll-/gruppmedlemskap
/scim/v2/ServiceProviderConfig SCIM-funktioner (upptäckt)
/scim/v2/ResourceTypes Stödda resurstyper (upptäckt)
/scim/v2/Schemas Scheman för User och Group (upptäckt)

Steg 4: Ange standardprodukttilldelning (valfritt)

Du kan automatiskt tilldela en produktlicens till användare när de etableras via SCIM:

  1. På SCIM-inställningssidan, hitta Default Product Assignment
  2. Välj en produkt:
    • Ingen - Användare skapas utan produkt (tilldela manuellt senare)
    • Viewer - Endast visningsåtkomst
    • Pro Basic - Standardfunktioner för redigering
    • Pro Business - Full funktionsåtkomst
  3. Klicka på Spara

Obs: Användare tilldelas endast en produkt om det finns lediga platser. Om det inte finns några lediga platser skapas användaren men lämnas otilldelad.

Steg 5: Testa och tilldela användare

  1. I din identitetsleverantör, använd funktionen Test Connection för att verifiera SCIM-anslutningen
  2. Tilldela en testanvändare till ScribbleMaps-programmet i din IdP
  3. Verifiera att användaren visas i din ScribbleMaps-teammedlemslista
  4. När det är bekräftat, tilldela fler användare eller grupper efter behov

Leverantörsspecifika guider

Okta

  1. I Okta Admin Console, gå till Applications > Browse App Catalog
  2. Sök efter "SCIM 2.0 Test App (Header Auth)" eller skapa ett anpassat SCIM-program
  3. Gå till fliken Provisioning > Configure API Integration
  4. Kryssa i Enable API integration
  5. Konfigurera:
    • SCIM 2.0 Base URL: https://api.scribblemaps.com/scim/v2
    • OAuth Bearer Token: Klistra in din ScribbleMaps SCIM-token
  6. Klicka på Test API Credentials för att verifiera
  7. Gå till Provisioning > To App och aktivera:
    • Create Users
    • Update User Attributes
    • Deactivate Users
  8. Gå till fliken Assignments för att tilldela användare eller grupper

Microsoft Entra ID (Azure AD)

  1. I Azure Portal, gå till Microsoft Entra ID > Enterprise Applications
  2. Välj ditt ScribbleMaps-program (eller skapa ett)
  3. Gå till Provisioning > Kom igång
  4. Ange Provisioning Mode till Automatic
  5. Under Admin Credentials:
    • Tenant URL: https://api.scribblemaps.com/scim/v2
    • Secret Token: Klistra in din ScribbleMaps SCIM-token
  6. Klicka på Test Connection för att verifiera
  7. Konfigurera Mappings för användarattribut
  8. Ange Provisioning Status till On
  9. Gå till Users and groups för att tilldela användare

OneLogin

  1. I OneLogin Admin, gå till Applications > Add App
  2. Sök efter "SCIM Provisioner with SAML (SCIM v2 Core)" eller liknande
  3. Gå till fliken Configuration
  4. Konfigurera:
    • SCIM Base URL: https://api.scribblemaps.com/scim/v2
    • SCIM Bearer Token: Klistra in din ScribbleMaps SCIM-token
  5. Gå till fliken Provisioning och aktivera etablering
  6. Gå till fliken Users för att tilldela användare

JumpCloud

  1. I JumpCloud Admin, gå till SSO Applications
  2. Klicka på + för att lägga till ett nytt program
  3. Välj Custom SCIM
  4. Konfigurera:
    • Base URL: https://api.scribblemaps.com/scim/v2
    • Token Key: Klistra in din ScribbleMaps SCIM-token
    • Authentication: Bearer Token
  5. Klicka på Test Connection
  6. Konfigurera attributmappningar
  7. Tilldela användargrupper till programmet

Stödda SCIM-åtgärder

Användaråtgärder

Åtgärd Metod Stöds Beskrivning
Lista användare GET /Users Ja Hämta alla användare med sidnumrering och filtrering
Hämta användare GET /Users/{id} Ja Hämta en specifik användare via ID
Skapa användare POST /Users Ja Etablera en ny användare
Ersätt användare PUT /Users/{id} Ja Fullständig uppdatering av användarattribut
Uppdatera användare PATCH /Users/{id} Ja Delvis uppdatering av användarattribut
Ta bort användare DELETE /Users/{id} Ja Inaktivera användare (mjuk borttagning)

Gruppåtgärder

Åtgärd Metod Stöds Beskrivning
Lista grupper GET /Groups Ja Returnerar rollgrupperna Admin och Member
Hämta grupp GET /Groups/{id} Ja Hämta grupp med medlemslista
Uppdatera grupp PATCH /Groups/{id} Ja Lägg till/ta bort medlemmar från rollgrupper
Skapa grupp POST /Groups Nej Stöds inte (roller är fasta)

Stödda användarattribut

SCIM-attribut ScribbleMaps-fält Obligatoriskt
userName E-postadress Ja
externalId Extern IdP-identifierare Nej
name.givenName Förnamn Nej
name.familyName Efternamn Nej
displayName Visningsnamn Nej
active Kontostatus Nej
emails[].value E-postadress Nej

Stödda filter

Filter Exempel
Filtrera efter e-post userName eq "[email protected]"
Filtrera efter externt ID externalId eq "12345"
Filtrera efter status active eq true

Hantering av användarens livscykel

När en användare etableras

  1. Ett nytt teammedlemskonto skapas i ScribbleMaps
  2. Användarinformation (namn, e-post) fylls i från din IdP
  3. Om en standardprodukt är konfigurerad och det finns lediga platser tilldelas en licens automatiskt
  4. Användaren kan logga in omedelbart via SSO (om konfigurerat)

När en användare uppdateras

  1. Användarattribut (namn, visningsnamn) uppdateras för att matcha din IdP
  2. E-poständringar synkroniseras (om inte användaren har länkat sitt konto)

När en användare avetableras

  1. Användarens konto inaktiveras (mjuk borttagning)
  2. Alla produktlicenser tas bort, vilket frigör platser
  3. Alla aktiva sessioner ogiltigförklaras omedelbart
  4. Användaren kan inte längre logga in
  5. Användardata och kartor bevaras (tas inte bort)
  6. Kontot kan återaktiveras om användaren etableras på nytt

Rollhantering via grupper

ScribbleMaps exponerar två rollgrupper via SCIM:

Grupp-ID Roll Behörigheter
admin Administratör Hantera teaminställningar, användare och fakturering
member Medlem Standardåtkomst för teammedlem

För att tilldela en användare som administratör, lägg till dem i gruppen admin via SCIM PATCH. Rollen Owner kan inte ändras via SCIM.

Felsökning

Vanliga problem

"401 Unauthorized" eller "Invalid token"

  • Kontrollera att bearer-token är korrekt och inte har återkallats
  • Se till att token skickas i Authorization-huvudet som Bearer YOUR_TOKEN
  • Kontrollera om token har gått ut (om en utgångstid angetts)
  • Generera en ny token om det behövs

"409 Conflict" - Användaren finns redan

  • En användare med den e-postadressen finns redan i ditt team
  • Om den befintliga användaren var inaktiverad kommer SCIM automatiskt att återaktivera dem
  • Kontrollera om det finns dubbla e-postadresser i din IdP

"400 Bad Request" - Obligatoriskt fält saknas

  • Se till att userName (e-post) finns med i förfrågan
  • Kontrollera att e-postformatet är giltigt
  • Kontrollera din IdP:s konfiguration för attributmappning

Användare skapas men ingen produkt tilldelas

  • Kontrollera om en standardprodukt är konfigurerad i SCIM-inställningarna
  • Kontrollera att du har lediga platser för standardprodukten
  • Användare kan tilldelas produkter manuellt i Team Settings

Användarändringar synkroniseras inte

  • Vissa IdP:er synkroniserar enligt ett schema (t.ex. var 40:e minut för Azure AD)
  • Försök tvinga fram en manuell synkronisering i din IdP
  • Kontrollera att SCIM fortfarande är aktiverat och att token är giltig

Testanslutning misslyckas

  • Kontrollera att SCIM Base URL är exakt https://api.scribblemaps.com/scim/v2
  • Se till att det inte finns avslutande snedstreck eller stavfel
  • Kontrollera att ditt nätverk/brandvägg tillåter utgående HTTPS till api.scribblemaps.com
     

Behöver du hjälp?

Om du har problem med SCIM-etablering, kontakta vårt supportteam med:

  • Ditt teamnamn
  • Identitetsleverantören du använder
  • Eventuella felmeddelanden från din IdP:s etableringsloggar
  • Skärmdumpar av din SCIM-konfiguration (med token dold)

Vi finns här för att hjälpa dig konfigurera SCIM-etablering för din organisation.

Last updated