SCIM provisioning

Copernica biedt een gedeeltelijke implementatie van de SCIM 2.0 standaard. Deze implementatie bestaat uit een aantal REST API methodes waarmee gebruikers beheerd kunnen worden vanuit een extern systeem.

Ondersteunde operaties

De volgende operaties worden ondersteund op de /Users resource:

• Gebruikers aanmaken
• Gebruikers opvragen
• Zoeken en filteren op gebruikers
• Gebruikers bijwerken
• Gebruikers deactiveren en heractiveren
• Gebruikers verwijderen

Externe systemen die SCIM ondersteunen kunnen deze operaties automatisch aanroepen om gebruikers in Copernica in sync te houden met het externe systeem.

API endpoint en authenticatie

SCIM gebruikt geen aparte infrastructuur. De operaties zijn beschikbaar via het reguliere Copernica REST API endpoint, net zoals andere API calls. Het basispad voor de SCIM endpoints is:

https://api.copernica.com/v4/scim/v2

Voor authenticatie wordt een regulier API access token gebruikt. Het enige verschil is dat het token de SCIM-functionaliteit moet mogen gebruiken. Bij het aanmaken van het token in Marketing Suite kan worden aangegeven dat het token voor SCIM gebruikt mag worden.

Account context

API access tokens zijn gekoppeld aan een account. De SCIM operaties werken binnen dat account:

• Bij het aanmaken van een gebruiker via SCIM wordt die gebruiker toegevoegd aan het account waaraan het token gekoppeld is.
• Bij het verwijderen van een gebruiker via SCIM wordt die gebruiker uit dat account verwijderd.

De SCIM operaties gaan dus over het lidmaatschap van een account, niet over een globale Copernica-gebruikersdirectory.

Gebruikers die bij meerdere accounts horen

Een gebruiker in Copernica kan bij meerdere accounts horen. Bijvoorbeeld omdat dezelfde persoon werkt voor verschillende klanten of partners.

Voor zulke gebruikers beheert SCIM nog steeds het lidmaatschap van het account waaraan het token gekoppeld is. Wat SCIM in dat geval niet doet, is de naam of het e-mailadres van de gebruiker bijwerken. Die velden zijn namelijk gedeeld over alle accounts waar de gebruiker bij hoort, en het is niet wenselijk dat een wijziging vanuit het ene account effect heeft in andere accounts.

Relatie met identity platforms en SSO

SCIM is een gestandaardiseerd protocol. Veel identity platforms, zoals Microsoft Entra ID, ondersteunen SCIM standaard. Door in zo'n platform de Copernica SCIM endpoint en een access token in te stellen, kan het platform automatisch de provisioning calls uitvoeren.

SCIM regelt alleen het beheer van gebruikers, niet het inloggen zelf. Voor het inloggen kan Single Sign On worden geconfigureerd. SSO en SCIM zijn vaak een logische combinatie: SSO regelt dat gebruikers via het identity platform inloggen, en SCIM zorgt dat die gebruikers ook automatisch worden aangemaakt, bijgewerkt en verwijderd in Copernica.