Beheer/Aanmelden
SCIM-provisioning
Maak SCIM-connectors aan in Admin Center, koppel groepen en maak leden van werkruimtes automatisch aan vanuit je IdP.
In dit artikel lees je hoe je leden van een werkruimte automatisch aanmaakt vanuit je identiteitsprovider met SCIM 2.0, in plaats van mensen één voor één uit te nodigen.
SCIM maakt deel uit van de add-on SSO / SCIM. Je abonnement moet die bevatten, en een admin van de werkruimte moet SSO / SCIM inschakelen onder Settings → Advanced voordat via SCIM aangemaakte leden in die werkruimte verschijnen.
Wat SCIM doet in Clipido
SCIM maakt gebruikersrecords aan en werkt ze bij vanuit je IdP. Voor elke deployment die je aan een connector koppelt, doet Clipido het volgende:
- Leden toevoegen die toegang moeten hebben
- Namen en actieve status bijwerken
- Groepen toewijzen op basis van je koppelingsregels (afhankelijk van de toewijzingsmodus)
- Via SCIM aangemaakte leden tonen op Settings → Members met een badge "SCIM"
SCIM vervangt aanmelden via SAML niet. De meeste organisaties gebruiken beide: SAML voor de authenticatie en SCIM voor de levenscyclus van gebruikers.
Een SCIM-connector aanmaken
-
Open Admin Center → "Identity" → "SCIM Provisioners".
-
Klik op Add Provisioner.
-
Vul een "Display Name" in.
-
Selecteer onder "Assign to deployments" de werkruimtes die deze connector beheert. Elke deployment kan aan "maar één connector" gekoppeld worden.
-
Kies voor elke deployment een "Fallback access group". Die groep wordt gebruikt als er geen SCIM-groepskoppeling van toepassing is op een gebruiker die zich bij die deployment aanmeldt.
-
Kies een SCIM group assignment mode:
Modus Label Gedrag Handmatig "Manual: allow moving SCIM users between groups" Admins kunnen het groepslidmaatschap in Clipido aanpassen Afgedwongen "Enforced: SCIM controls group assignments" Wijzigingen in groepslidmaatschap moeten uit de IdP komen -
Sla op en kopieer het bearer token uit "SCIM Token Generated". Het venster waarschuwt "Copy the token below. It will not be shown again."
Stel je IdP in met:
- "Base URL:"
https://{api-host}/scim/v2(zichtbaar op het tabblad SCIM) - "Bearer token:" het token dat je hebt gekopieerd
SCIM-groepen koppelen aan Clipido-groepen
Zodra de connector actief is en de schakelaar van de werkruimte aanstaat:
- Open Settings → Groups in de werkruimte-app.
- Open een groep en ga naar Members.
- Klik bij "SCIM mapping" op Map SCIM group en koppel groeps-ID's uit je IdP aan Clipido-groepen.
Via SCIM aangemaakte leden verschijnen ook onder Settings → Members → "Provisioned members", met de telling "{n} users whitelisted via SCIM for this workspace."
Beperkingen van SCIM om rekening mee te houden
De tabel hieronder toont vaste limieten die bepalen hoe je de synchronisatie met je IdP instelt.
| Limiet | Details |
|---|---|
| Paginagrootte van lijsten | SCIM-lijstendpoints geven maximaal "100" resultaten per verzoek terug |
| Handmatig verwijderen | Leden die SCIM beheert, kun je niet verwijderen in Settings → Members |
| Groepen handmatig aanpassen | Uitgeschakeld als de toewijzingsmodus "Enforced" is, of voor rijen die SCIM beheert |
| Deactiveren | SCIM DELETE deactiveert de toegang maar behoudt de identiteitsrij |
| Eén connector per deployment | Een deployment kan niet aan twee connectors gekoppeld worden |
Voor leden die SCIM beheert, is "Remove" uitgeschakeld, met de tooltip "This member is managed by SCIM. They cannot be removed from the workspace here." Verwijder of deactiveer ze in plaats daarvan in je IdP.
SCIM inschakelen in de werkruimte
Zet SSO / SCIM aan onder Settings → Advanced. De beschrijving op de kaart luidt "Provision members from your identity provider and manage SCIM whitelisted users."
Zonder deze schakelaar kunnen SCIM-API-aanroepen op organisatieniveau wel slagen, maar toont de interface van de werkruimte geen via SCIM aangemaakte leden en past ze geen groepskoppelingen toe.
Problemen oplossen
| Probleem | Wat je controleert |
|---|---|
| Gebruikers verschijnen niet | Connector toegewezen aan de deployment, schakelaar van de werkruimte aan, synchronisatie met de IdP actief |
| Verkeerde groepen | SCIM mapping op Settings → Groups, toewijzingsmodus (handmatig of afgedwongen), fallbackgroep |
| Je kunt een gebruiker niet naar een andere groep verplaatsen | De connector staat misschien in de modus "Enforced"; wijzig groepen in de IdP |
| Token kwijt | Maak een nieuwe connector aan of vernieuw het token in Admin Center; oude tokens kun je niet opnieuw bekijken |
Kunnen leden zich aanmelden met SSO maar verschijnen SCIM-gebruikers nooit, controleer dan of de connector de juiste deployment vermeldt en of de fallbackgroep bestaat.