Centrum nápovědy Scribble Maps
Změnit jazyk

SCIM Provisioning

Konfigurace zřizování uživatelů pomocí SCIM

ScribbleMaps podporuje SCIM 2.0 (System for Cross-domain Identity Management) pro automatické zřizování a odebírání uživatelů. To vám umožňuje automaticky synchronizovat uživatele z vašeho poskytovatele identity (IdP) do ScribbleMaps, což zajišťuje, že členství v týmu zůstane synchronizované s adresářem vaší organizace.

Zřizování SCIM je k dispozici na adrese team.scribblemaps.com a je zcela zdarma.

Obsah

  1. Co je SCIM?
  2. Než začnete
  3. Krok 1: Povolte SCIM v ScribbleMaps
  4. Krok 2: Vygenerujte Bearer Token
  5. Krok 3: Nakonfigurujte svého poskytovatele identity
  6. Krok 4: Nastavte Default Product Assignment
  7. Krok 5: Otestujte a přiřaďte uživatele
  8. Návody pro konkrétní poskytovatele
  9. Podporované operace SCIM
  10. Správa životního cyklu uživatelů
  11. Řešení problémů

Co je SCIM?

SCIM (System for Cross-domain Identity Management) je otevřený standard, který vám umožňuje automaticky:

  • Zřizovat uživatele – automaticky vytvářet účty ScribbleMaps, když jsou uživatelé přiřazeni ve vašem IdP
  • Aktualizovat uživatele – udržovat informace o uživatelích (jméno, e-mail) synchronizované
  • Odebírat uživatele – automaticky deaktivovat účty, když jsou uživatelé odebráni z vašeho IdP
  • Spravovat role – přiřazovat uživatele k rolím Admin nebo Member prostřednictvím členství ve skupinách

SCIM funguje společně s SSO (SAML/OIDC) a poskytuje kompletní správu životního cyklu identity.

Než začnete

  • Pro konfiguraci SCIM musíte být Team Owner
  • Potřebujete přístup k administrátorské konzoli vašeho poskytovatele identity
  • Váš IdP musí podporovat SCIM 2.0 (Okta, Microsoft Entra ID, OneLogin, JumpCloud atd.)
  • Pro co nejlepší uživatelskou zkušenost doporučujeme nakonfigurovat SSO před SCIM

Krok 1: Povolte SCIM v ScribbleMaps

  1. Přihlaste se na team.scribblemaps.com
  2. Přejděte na SCIM Provisioning (left side bar)
  3. Přepněte Enable SCIM do polohy ON

Poznámka: Před plným povolením SCIM budete muset vygenerovat bearer token.

Krok 2: Vygenerujte Bearer Token

Bearer token autentizuje vašeho poskytovatele identity vůči ScribbleMaps.

  1. Na stránce nastavení SCIM klikněte na Generate Token
  2. Token okamžitě zkopírujte a bezpečně uložte

Důležité bezpečnostní poznámky:

  • Token se zobrazí pouze jednou – pokud jej ztratíte, budete muset vygenerovat nový
  • S tímto tokenem zacházejte jako s heslem – kdokoli s tímto tokenem může spravovat uživatele vašeho týmu
  • Pokud dojde ke kompromitaci tokenu, můžete jej kdykoli zneplatnit a vygenerovat nový
  • Zneplatnění tokenu okamžitě zastaví všechny operace SCIM, dokud nebude nakonfigurován nový token

Krok 3: Nakonfigurujte svého poskytovatele identity

Použijte následující údaje ke konfiguraci ScribbleMaps jako aplikace SCIM ve vašem IdP:

Nastavení Hodnota
SCIM Base URL https://api.scribblemaps.com/scim/v2
Authentication Method HTTP Header / Bearer Token
Authorization Header Bearer YOUR_TOKEN_HERE
Unique Identifier userName (email address)

Referenční příručka koncových bodů SCIM

Koncový bod Účel
/scim/v2/Users Zřizování a správa uživatelů
/scim/v2/Groups Správa členství v rolích/skupinách
/scim/v2/ServiceProviderConfig Možnosti SCIM (detekce)
/scim/v2/ResourceTypes Podporované typy prostředků (detekce)
/scim/v2/Schemas Schémata uživatelů a skupin (detekce)

Krok 4: Nastavte Default Product Assignment (volitelné)

Uživatelům můžete automaticky přiřadit licenci k produktu, když jsou zřízeni prostřednictvím SCIM:

  1. Na stránce nastavení SCIM najděte Default Product Assignment
  2. Vyberte produkt:
    • None – uživatelé jsou vytvořeni bez produktu (přiřaďte ručně později)
    • Viewer – přístup pouze pro čtení
    • Pro Basic – standardní funkce pro úpravy
    • Pro Business – přístup ke všem funkcím
  3. Klikněte na Save

Poznámka: Uživatelům bude produkt přiřazen pouze v případě, že jsou k dispozici volná místa. Pokud nejsou k dispozici žádná místa, uživatel je vytvořen, ale zůstane nepřiřazen.

Krok 5: Otestujte a přiřaďte uživatele

  1. Ve svém poskytovateli identity použijte funkci Test Connection k ověření připojení SCIM
  2. Přiřaďte testovacího uživatele k aplikaci ScribbleMaps ve vašem IdP
  3. Ověřte, zda se uživatel zobrazí v seznamu členů týmu ScribbleMaps
  4. Po potvrzení přiřaďte podle potřeby další uživatele nebo skupiny

Návody pro konkrétní poskytovatele

Okta

  1. V Okta Admin Console přejděte na Applications > Browse App Catalog
  2. Vyhledejte „SCIM 2.0 Test App (Header Auth)“ nebo vytvořte vlastní aplikaci SCIM
  3. Přejděte na kartu Provisioning > Configure API Integration
  4. Zaškrtněte Enable API integration
  5. Nakonfigurujte:
    • SCIM 2.0 Base URL: https://api.scribblemaps.com/scim/v2
    • OAuth Bearer Token: Vložte svůj SCIM token ze ScribbleMaps
  6. Kliknutím na Test API Credentials proveďte ověření
  7. Přejděte na Provisioning > To App a povolte:
    • Create Users
    • Update User Attributes
    • Deactivate Users
  8. Přejděte na kartu Assignments pro přiřazení uživatelů nebo skupin

Microsoft Entra ID (Azure AD)

  1. V Azure Portal přejděte na Microsoft Entra ID > Enterprise Applications
  2. Vyberte svou aplikaci ScribbleMaps (nebo ji vytvořte)
  3. Přejděte na Provisioning > Get Started
  4. Nastavte Provisioning Mode na Automatic
  5. V části Admin Credentials:
    • Tenant URL: https://api.scribblemaps.com/scim/v2
    • Secret Token: Vložte svůj SCIM token ze ScribbleMaps
  6. Kliknutím na Test Connection proveďte ověření
  7. Nakonfigurujte Mappings pro atributy uživatelů
  8. Nastavte Provisioning Status na On
  9. Přejděte na Users and groups pro přiřazení uživatelů

OneLogin

  1. V OneLogin Admin přejděte na Applications > Add App
  2. Vyhledejte „SCIM Provisioner with SAML (SCIM v2 Core)“ nebo podobný
  3. Přejděte na kartu Configuration
  4. Nakonfigurujte:
    • SCIM Base URL: https://api.scribblemaps.com/scim/v2
    • SCIM Bearer Token: Vložte svůj SCIM token ze ScribbleMaps
  5. Přejděte na kartu Provisioning a povolte zřizování
  6. Přejděte na kartu Users pro přiřazení uživatelů

JumpCloud

  1. V JumpCloud Admin přejděte na SSO Applications
  2. Kliknutím na + přidejte novou aplikaci
  3. Vyberte Custom SCIM
  4. Nakonfigurujte:
    • Base URL: https://api.scribblemaps.com/scim/v2
    • Token Key: Vložte svůj SCIM token ze ScribbleMaps
    • Authentication: Bearer Token
  5. Klikněte na Test Connection
  6. Nakonfigurujte mapování atributů
  7. Přiřaďte skupiny uživatelů k aplikaci

Podporované operace SCIM

Uživatelské operace

Operace Metoda Podporováno Popis
Zobrazit seznam uživatelů GET /Users Ano Načtení všech uživatelů se stránkováním a filtrováním
Získat uživatele GET /Users/{id} Ano Načtení konkrétního uživatele podle ID
Vytvořit uživatele POST /Users Ano Zřízení nového uživatele
Nahradit uživatele PUT /Users/{id} Ano Úplná aktualizace atributů uživatele
Aktualizovat uživatele PATCH /Users/{id} Ano Částečná aktualizace atributů uživatele
Smazat uživatele DELETE /Users/{id} Ano Deaktivace uživatele (soft delete)

Skupinové operace

Operace Metoda Podporováno Popis
Zobrazit seznam skupin GET /Groups Ano Vrací skupiny rolí Admin a Member
Získat skupinu GET /Groups/{id} Ano Načtení skupiny se seznamem členů
Aktualizovat skupinu PATCH /Groups/{id} Ano Přidání/odebrání členů ze skupin rolí
Vytvořit skupinu POST /Groups Ne Nepodporováno (role jsou pevně dané)

Podporované atributy uživatelů

Atribut SCIM Pole ScribbleMaps Vyžadováno
userName E-mailová adresa Ano
externalId Externí identifikátor IdP Ne
name.givenName Křestní jméno Ne
name.familyName Příjmení Ne
displayName Zobrazované jméno Ne
active Stav účtu Ne
emails[].value E-mailová adresa Ne

Podporované filtry

Filtr Příklad
Filtrovat podle e-mailu userName eq "[email protected]"
Filtrovat podle externího ID externalId eq "12345"
Filtrovat podle stavu active eq true

Správa životního cyklu uživatelů

Když je uživatel zřízen

  1. Ve ScribbleMaps je vytvořen nový účet člena týmu
  2. Informace o uživateli (jméno, e-mail) jsou vyplněny z vašeho IdP
  3. Pokud je nakonfigurován výchozí produkt a jsou k dispozici volná místa, licence je automaticky přiřazena
  4. Uživatel se může okamžitě přihlásit přes SSO (pokud je nakonfigurováno)

Když je uživatel aktualizován

  1. Atributy uživatele (jméno, zobrazované jméno) jsou aktualizovány tak, aby odpovídaly vašemu IdP
  2. Změny e-mailu jsou synchronizovány (pokud si uživatel nepropojil svůj účet)

Když je uživatel odebrán

  1. Účet uživatele je deaktivován (soft delete)
  2. Všechny licence k produktům jsou odebrány, čímž se uvolní místa
  3. Všechny aktivní relace jsou okamžitě zneplatněny
  4. Uživatel se již nemůže přihlásit
  5. Uživatelská data a mapy jsou zachovány (nejsou smazány)
  6. Účet lze znovu aktivovat, pokud je uživatel znovu zřízen

Správa rolí prostřednictvím skupin

ScribbleMaps zpřístupňuje dvě skupiny rolí prostřednictvím SCIM:

ID skupiny Role Oprávnění
admin Administrátor Správa nastavení týmu, uživatelů a fakturace
member Člen Standardní přístup člena týmu

Chcete-li uživatele přiřadit jako administrátora, přidejte jej do skupiny admin pomocí SCIM PATCH. Role Owner nemůže být prostřednictvím SCIM upravována.

Řešení problémů

Běžné problémy

"401 Unauthorized" nebo "Invalid token"

  • Ověřte, zda je bearer token správný a nebyl zneplatněn
  • Ujistěte se, že je token předáván v hlavičce Authorization jako Bearer YOUR_TOKEN
  • Zkontrolujte, zda nevypršela platnost tokenu (pokud byla nastavena expirace)
  • V případě potřeby vygenerujte nový token

"409 Conflict" – Uživatel již existuje

  • Uživatel s tímto e-mailem již ve vašem týmu existuje
  • Pokud byl stávající uživatel deaktivován, SCIM jej automaticky znovu aktivuje
  • Zkontrolujte duplicitní e-mailové adresy ve vašem IdP

"400 Bad Request" – Chybí vyžadované pole

  • Ujistěte se, že je v požadavku zahrnuto pole userName (e-mail)
  • Ověřte, zda je formát e-mailu platný
  • Zkontrolujte konfiguraci mapování atributů ve vašem IdP

Uživatelé jsou vytvořeni, ale není přiřazen žádný produkt

  • Zkontrolujte, zda je v nastavení SCIM nakonfigurován výchozí produkt
  • Ověřte, zda máte k dispozici volná místa pro výchozí produkt
  • Uživatelům lze produkty přiřadit ručně v Team Settings

Změny uživatelů se nesynchronizují

  • Některé IdP se synchronizují podle plánu (např. každých 40 minut u Azure AD)
  • Zkuste vynutit ruční synchronizaci ve vašem IdP
  • Ověřte, zda je SCIM stále povolen a token je platný

Test připojení selhal

  • Ověřte, zda je SCIM Base URL přesně https://api.scribblemaps.com/scim/v2
  • Ujistěte se, že na konci nejsou žádná lomítka ani překlepy
  • Zkontrolujte, zda vaše síť/firewall povoluje odchozí HTTPS na api.scribblemaps.com
     

Potřebujete pomoc?

Pokud máte problémy se zřizováním SCIM, kontaktujte prosím náš tým podpory a uveďte:

  • Název vašeho týmu (Team name)
  • Poskytovatele identity, kterého používáte
  • Jakékoli chybové zprávy z protokolů zřizování vašeho IdP
  • Snímky obrazovky vaší konfigurace SCIM (se skrytým tokenem)

Jsme tu, abychom vám pomohli nakonfigurovat zřizování SCIM pro vaši organizaci.

Naposledy aktualizováno