Helpcentro de Scribble Maps
Ŝanĝi lingvon

SCIM-provizado

Agordado de SCIM-uzanta provizado

ScribbleMaps subtenas SCIM 2.0 (System for Cross-domain Identity Management) por aŭtomata provizado kaj malprovizado de uzantoj. Ĉi tio ebligas al vi aŭtomate sinkronigi uzantojn de via Identity Provider (IdP) al ScribbleMaps, certigante ke la teamanaro restu sinkronigita kun la dosierujo de via organizo.

SCIM-provizado haveblas ĉe team.scribblemaps.com kaj estas tute senpaga.

Enhavtabelo

  1. Kio estas SCIM?
  2. Antaŭ ol vi komencas
  3. Paŝo 1: Ebligu SCIM en ScribbleMaps
  4. Paŝo 2: Generu Bearer-ĵetonon
  5. Paŝo 3: Agordu vian Identity Provider
  6. Paŝo 4: Agordu defaŭltan produktan asignon
  7. Paŝo 5: Testu kaj asignu uzantojn
  8. Gvidiloj laŭ provizanto
  9. Subtenataj SCIM-operacioj
  10. Administrado de la vivociklo de uzantoj
  11. Solvado de problemoj

Kio estas SCIM?

SCIM (System for Cross-domain Identity Management) estas malferma normo, kiu ebligas al vi aŭtomate:

  • Provizi uzantojn - Aŭtomate krei ScribbleMaps-kontojn kiam uzantoj estas asignitaj en via IdP
  • Ĝisdatigi uzantojn - Gardi uzantajn informojn (nomo, retpoŝto) sinkronigitaj
  • Malprovizi uzantojn - Aŭtomate malaktivigi kontojn kiam uzantoj estas forigitaj el via IdP
  • Administri rolojn - Asigni uzantojn al la roloj Administranto aŭ Membro per grupa membreco

SCIM funkcias kune kun SSO (SAML/OIDC) por proponi kompletan administradon de identeca vivociklo.

Antaŭ ol vi komencas

  • Vi devas esti Team Owner por agordi SCIM
  • Vi bezonas aliron al la administra konzolo de via Identity Provider
  • Via IdP devas subteni SCIM 2.0 (Okta, Microsoft Entra ID, OneLogin, JumpCloud, ktp.)
  • Ni rekomendas agordi SSO antaŭ SCIM por la plej bona uzanta sperto

Paŝo 1: Ebligu SCIM en ScribbleMaps

  1. Ensalutu ĉe team.scribblemaps.com
  2. Navigu al SCIM Provisioning (maldekstra flanka breto)
  3. Ŝaltu Enable SCIM al ON

Noto: Vi bezonos generi Bearer-ĵetonon antaŭ ol SCIM povos esti plene ebligita.

Paŝo 2: Generu Bearer-ĵetonon

La Bearer-ĵetono aŭtentigas vian Identity Provider ĉe ScribbleMaps.

  1. En la SCIM-agorda paĝo, alklaku Generi Token
  2. Kopiu la ĵetonon tuj kaj konservu ĝin sekure

Gravaj sekurecaj notoj:

  • La ĵetono estas montrata nur unufoje - se vi perdos ĝin, vi devos generi novan
  • Traktu ĉi tiun ĵetonon kiel pasvorton - ĉiu, kiu havas la ĵetonon, povas administri la uzantojn de via teamo
  • Vi povas revoki kaj regeneri la ĵetonon iam ajn se ĝi estas kompromitita
  • Revoki ĵetonon tuj haltigas ĉiujn SCIM-operaciojn ĝis nova ĵetono estas agordita

Paŝo 3: Agordu vian Identity Provider

Uzu la sekvajn detalojn por agordi ScribbleMaps kiel SCIM-aplikaĵon en via IdP:

Agordoj Valoro
SCIM Base URL https://api.scribblemaps.com/scim/v2
Authentication Method HTTP Header / Bearer Token
Authorization Header Bearer YOUR_TOKEN_HERE
Unika identigilo userName (retpoŝta adreso)

Referenco pri SCIM-finpunktoj

Finpunkto Celo
/scim/v2/Users Provizado kaj administrado de uzantoj
/scim/v2/Groups Administrado de roloj/grupa membreco
/scim/v2/ServiceProviderConfig SCIM-kapabloj (eltrovado)
/scim/v2/ResourceTypes Subtenataj rimedaj tipoj (eltrovado)
/scim/v2/Schemas Skemoj de uzantoj kaj grupoj (eltrovado)

Paŝo 4: Agordu defaŭltan produktan asignon (nedevige)

Vi povas aŭtomate asigni produktan licencon al uzantoj kiam ili estas provizitaj per SCIM:

  1. En la SCIM-agorda paĝo, trovu Default Product Assignment
  2. Elektu produkton:
    • Neniu - Uzantoj estas kreitaj sen produkto (asignu mane poste)
    • Vidanto - Nur-vida aliro
    • Pro Baza - Normaj redaktaj funkcioj
    • Pro Komerco - Plena aliro al funkcioj
  3. Alklaku Konservi

Noto: Uzantoj ricevos produkton nur se sidlokoj disponeblas. Se neniu sidloko disponeblas, la uzanto estas kreita sed restas neasignita.

Paŝo 5: Testu kaj asignu uzantojn

  1. En via Identity Provider, uzu la funkcion Test Connection por kontroli la SCIM-konekton
  2. Asignu testan uzanton al la ScribbleMaps-aplikaĵo en via IdP
  3. Kontrolu ke la uzanto aperas en la listo de teamanoj de ScribbleMaps
  4. Post konfirmo, asignu aldonajn uzantojn aŭ grupojn laŭbezone

Gvidiloj laŭ provizanto

Okta

  1. En Okta Admin Console, iru al Applications > Browse App Catalog
  2. Serĉu "SCIM 2.0 Test App (Header Auth)" aŭ kreu propran SCIM-aplikaĵon
  3. Iru al la langeto Provisioning > Configure API Integration
  4. Marku Enable API integration
  5. Agordu:
    • SCIM 2.0 Base URL: https://api.scribblemaps.com/scim/v2
    • OAuth Bearer Token: Algluu vian ScribbleMaps SCIM-ĵetonon
  6. Alklaku Test API Credentials por kontroli
  7. Iru al Provisioning > To App kaj ebligu:
    • Create Users
    • Update User Attributes
    • Deactivate Users
  8. Iru al la langeto Assignments por asigni uzantojn aŭ grupojn

Microsoft Entra ID (Azure AD)

  1. En Azure Portal, iru al Microsoft Entra ID > Enterprise Applications
  2. Elektu vian ScribbleMaps-aplikaĵon (aŭ kreu unu)
  3. Iru al Provisioning > Komenci
  4. Agordu Provisioning Mode al Automatic
  5. Sub Admin Credentials:
    • Tenant URL: https://api.scribblemaps.com/scim/v2
    • Secret Token: Algluu vian ScribbleMaps SCIM-ĵetonon
  6. Alklaku Test Connection por kontroli
  7. Agordu Mappings por uzantaj atributoj
  8. Agordu Provisioning Status al On
  9. Iru al Users and groups por asigni uzantojn

OneLogin

  1. En OneLogin Admin, iru al Applications > Add App
  2. Serĉu "SCIM Provisioner with SAML (SCIM v2 Core)" aŭ similan
  3. Iru al la langeto Configuration
  4. Agordu:
    • SCIM Base URL: https://api.scribblemaps.com/scim/v2
    • SCIM Bearer Token: Algluu vian ScribbleMaps SCIM-ĵetonon
  5. Iru al la langeto Provisioning kaj ebligu provizadon
  6. Iru al la langeto Users por asigni uzantojn

JumpCloud

  1. En JumpCloud Admin, iru al SSO Applications
  2. Alklaku + por aldoni novan aplikaĵon
  3. Elektu Custom SCIM
  4. Agordu:
    • Base URL: https://api.scribblemaps.com/scim/v2
    • Token Key: Algluu vian ScribbleMaps SCIM-ĵetonon
    • Authentication: Bearer Token
  5. Alklaku Test Connection
  6. Agordu atributajn mapadojn
  7. Asignu uzantogrupojn al la aplikaĵo

Subtenataj SCIM-operacioj

Uzantaj operacioj

Operacio Metodo Subtenata Priskribo
List Users GET /Users Jes Preni ĉiujn uzantojn kun paĝado kaj filtrado
Get User GET /Users/{id} Jes Preni specifan uzanton laŭ ID
Create User POST /Users Jes Provizi novan uzanton
Replace User PUT /Users/{id} Jes Plena ĝisdatigo de uzantaj atributoj
Update User PATCH /Users/{id} Jes Parta ĝisdatigo de uzantaj atributoj
Delete User DELETE /Users/{id} Jes Malaktivigi uzanton (mola forigo)

Grupaj operacioj

Operacio Metodo Subtenata Priskribo
List Groups GET /Groups Jes Resendas la rolgrupojn Administranto kaj Membro
Get Group GET /Groups/{id} Jes Preni grupon kun membrolisto
Update Group PATCH /Groups/{id} Jes Aldoni/forigi membrojn de rolgrupoj
Create Group POST /Groups Ne Nesubtenata (roloj estas fiksitaj)

Subtenataj uzantaj atributoj

SCIM-atributo ScribbleMaps-kampo Postulata
userName Retpoŝta adreso Jes
externalId Ekstera IdP-identigilo Ne
name.givenName Persona nomo Ne
name.familyName Familia nomo Ne
displayName Montra nomo Ne
active Konta statuso Ne
emails[].value Retpoŝta adreso Ne

Subtenataj filtriloj

Filtrilo Ekzemplo
Filtri laŭ retpoŝto userName eq "[email protected]"
Filtri laŭ ekstera ID externalId eq "12345"
Filtri laŭ statuso active eq true

Administrado de la vivociklo de uzantoj

Kiam uzanto estas provizita

  1. Nova teamana konto estas kreita en ScribbleMaps
  2. Uzantaj informoj (nomo, retpoŝto) estas plenigitaj el via IdP
  3. Se defaŭlta produkto estas agordita kaj sidlokoj disponeblas, licenco estas aŭtomate asignita
  4. La uzanto povas tuj ensaluti per SSO (se agordita)

Kiam uzanto estas ĝisdatigita

  1. Uzantaj atributoj (nomo, montra nomo) estas ĝisdatigitaj por kongrui kun via IdP
  2. Retpoŝtaj ŝanĝoj estas sinkronigitaj (krom se la uzanto ligis sian konton)

Kiam uzanto estas malprovizita

  1. La konto de la uzanto estas malaktivigita (mola forigo)
  2. Ĉiuj produktaj licencoj estas forigitaj, liberigante sidlokojn
  3. Ĉiuj aktivaj seancoj estas tuj nuligitaj
  4. La uzanto ne plu povas ensaluti
  5. Uzantaj datumoj kaj mapoj estas konservitaj (ne forigitaj)
  6. La konto povas esti reaktivigita se la uzanto estas reprovizita

Administrado de roloj per grupoj

ScribbleMaps montras du rolgrupojn per SCIM:

Grupa ID Rolo Permesoj
admin Administranto Administri teamajn agordojn, uzantojn kaj fakturadon
member Membro Norma aliro de teamano

Por asigni uzanton kiel administranton, aldonu ilin al la grupo admin per SCIM PATCH. La rolo Owner ne povas esti modifita per SCIM.

Solvado de problemoj

Oftaj problemoj

"401 Unauthorized" aŭ "Invalid token"

  • Kontrolu ke la Bearer-ĵetono estas ĝusta kaj ne estis revokita
  • Certigu ke la ĵetono estas transdonita en la Authorization-kaplinio kiel Bearer YOUR_TOKEN
  • Kontrolu ĉu la ĵetono eksvalidiĝis (se eksvalidiĝo estis agordita)
  • Generu novan ĵetonon se necese

"409 Conflict" - Uzanto jam ekzistas

  • Uzanto kun tiu retpoŝto jam ekzistas en via teamo
  • Se la ekzistanta uzanto estis malaktivigita, SCIM aŭtomate reaktivigos ĝin
  • Kontrolu duoblajn retpoŝtajn adresojn en via IdP

"400 Bad Request" - Mankas postulata kampo

  • Certigu ke userName (retpoŝto) estas inkludita en la peto
  • Kontrolu ke la retpoŝta formato validas
  • Kontrolu la atributan mapadon en via IdP

Uzantoj kreitaj sed neniu produkto asignita

  • Kontrolu ĉu defaŭlta produkto estas agordita en la SCIM-agordoj
  • Kontrolu ke vi havas disponeblajn sidlokojn por la defaŭlta produkto
  • Produktoj povas esti asignitaj mane al uzantoj en la teamaj agordoj

Uzantaj ŝanĝoj ne sinkroniĝas

  • Kelkaj IdP-oj sinkronigas laŭ horaro (ekz., ĉiujn 40 minutojn por Azure AD)
  • Provu devigi manan sinkronigon en via IdP
  • Kontrolu ke SCIM ankoraŭ estas ebligita kaj la ĵetono validas

Konekta testo malsukcesas

  • Kontrolu ke la SCIM Base URL estas ĝuste https://api.scribblemaps.com/scim/v2
  • Certigu ke ne ekzistas postaj oblikvoj aŭ tajperaroj
  • Kontrolu ke via reto/fajroŝirmilo permesas eliran HTTPS al api.scribblemaps.com
     

Ĉu vi bezonas helpon?

Se vi renkontas problemojn pri SCIM-provizado, bonvolu kontakti nian subtenan teamon kun:

  • La nomo de via Teamo
  • La Identity Provider, kiun vi uzas
  • Iuj ajn erarmesaĝoj el la provizadaj protokoloj de via IdP
  • Ekrankopioj de via SCIM-agordo (kun la ĵetono cenzurita)

Ni estas ĉi tie por helpi vin agordi SCIM-provizadon por via organizo.

Laste ĝisdatigita