SCIM-directorysynchronisatie (provisioning) configureren

Zodra single sign-on actief is, kan CalendarBridge automatisch gebruikersaccounts aanmaken, bijwerken en deactiveren vanuit je identity provider met SCIM 2.0. Dit betekent dat gebruikers worden geprovisioneerd op het moment dat ze in je directory worden toegewezen en gedeprovisioneerd op het moment dat ze vertrekken — geen handmatig licentiebeheer.

C Chad Bijgewerkt op 16 juni 2026 6 min lezen

Wat SCIM-provisioning doet

SCIM (System for Cross-domain Identity Management) is de open standaard die identity providers gebruiken om wijzigingen in de levenscyclus van gebruikers naar applicaties te pushen. Met SCIM ingeschakeld stuurt je IdP CalendarBridge een verzoek wanneer een gebruiker wordt toegewezen, bijgewerkt of verwijderd, en houdt CalendarBridge zijn gebruikerslijst automatisch synchroon.

Je SCIM-eindpunt en -token

Wanneer SCIM voor een domein is ingeschakeld, toont het tabblad Single Sign-On twee waarden die je identity provider nodig heeft:

WaardeBeschrijving
SCIM-eindpunt (Base URL / Tenant URL) De basis-URL waar je IdP SCIM-verzoeken naartoe stuurt. Kopieer deze van het SSO-tabblad met de knop Kopiëren.
Bearer-token (API-token / geheim token) Het authenticatietoken dat je IdP bij elk verzoek presenteert. Het wordt slechts één keer weergegeven wanneer het wordt gegenereerd of geroteerd — kopieer het onmiddellijk en bewaar het in je IdP.
warning
Het token wordt slechts één keer weergegeven Uit veiligheidsoverwegingen toont CalendarBridge het bearer-token eenmalig. Als je het kwijtraakt, gebruik dan Token roteren in de SCIM-sectie om een nieuw token te genereren — werk vervolgens het token in je IdP bij, want het oude token werkt onmiddellijk niet meer.

Authenticatie

CalendarBridge authenticeert SCIM-verzoeken met een OAuth 2.0-bearer-token dat in de HTTP-header Authorization wordt gepresenteerd. Voer het token in de SCIM-connector van je IdP exact in zoals weergegeven (neem in Okta het woord "Bearer" niet op — Okta voegt het toe). Je kunt het token op elk moment vanuit de SCIM-sectie roteren zonder SSO opnieuw te configureren.

Ondersteunde resources en attributen

CalendarBridge implementeert de SCIM 2.0-resource Users. De attributen die CalendarBridge leest, staan hieronder vermeld; aanvullende attributen die je IdP verstuurt, worden geaccepteerd en genegeerd.

SCIM-attribuutToegewezen aan in CalendarBridgeOpmerkingen
userNameUnieke login van de gebruiker (e-mail)Vereist. Moet op een geverifieerd domein voor de organisatie staan.
emails[primary] / emails[work]E-mailadresGebruikt om de gebruiker te koppelen aan je domein en SSO.
name.givenNameVoornaamVult de weergavenaam in.
name.familyNameAchternaamOptioneel.
activeAccount ingeschakeld / uitgeschakeldHet instellen van active=false deprovisioneert (deactiveert) de CalendarBridge-gebruiker.
info
Deprovisioning Wanneer een gebruiker in je IdP wordt opgeheven, stuurt de IdP een update die active=false instelt (soft delete), wat de gebruiker in CalendarBridge deactiveert en zijn licentie vrijgeeft. Het opnieuw toewijzen van de gebruiker reactiveert hem.

SCIM inschakelen in je identity provider

Open het tabblad Single Sign-On, zoek de actieve configuratie voor je domein en scroll naar de sectie SCIM. Selecteer je identity provider uit de ingebouwde gids voor de exacte menupaden en volg dan de stappen voor je IdP hieronder. In elk geval plak je het SCIM-eindpunt en bearer-token uit het portaal.

Microsoft Entra ID (Azure AD)

  1. Open het Provisioning-blad van de app

    Ga in het Microsoft Entra-beheercentrum naar Enterprise applications, open je CalendarBridge-app en selecteer Provisioning.

  2. Stel Provisioning Mode in op Automatic

    Voer dan de inloggegevens in: Tenant URL = het SCIM-eindpunt uit het portaal; Secret Token = het bearer-token uit het portaal.

  3. Test Connection, dan Save

    Klik op Test Connection om te bevestigen dat Entra ID het eindpunt kan bereiken en kan authenticeren, en klik dan op Save. Laat de standaard gebruikersattribuuttoewijzingen staan.

  4. Schakel provisioning in en wijs gebruikers toe

    Zet Provisioning Status op On en sla op. Wijs onder Users and groups de gebruikers of groepen toe om te synchroniseren. Entra ID provisioneert ze in de volgende cyclus.

Okta

  1. Open het tabblad Provisioning

    Open in Okta Admin je CalendarBridge-app, ga naar het tabblad Provisioning en klik op Configure API Integration → Enable API integration.

  2. Voer de SCIM-inloggegevens in

    Base URL = het SCIM-eindpunt uit het portaal; API token = het bearer-token uit het portaal (zonder Bearer-prefix). Klik op Test API Credentials, dan op Save.

  3. Schakel provisioning-acties in

    Schakel onder Provisioning → To App Create Users, Update User Attributes en Deactivate Users in.

  4. Wijs gebruikers of groepen toe

    Wijs gebruikers of groepen toe aan de app; Okta pusht ze onmiddellijk naar CalendarBridge.

Google Workspace

  1. Open Auto-provisioning

    Ga in de Google Admin-console naar Apps → Web and mobile apps, open je CalendarBridge SAML-app en klik op Auto-provisioning.

  2. Voer de SCIM-inloggegevens in

    Base URL = het SCIM-eindpunt uit het portaal; API token = het bearer-token uit het portaal. Klik op Test connection.

  3. Wijs attributen toe

    Wijs Primary email → userName, First name → name.givenName, Last name → name.familyName toe.

  4. Stel het bereik in en schakel het in

    Kies de gebruikers, OU's of groepen om te provisioneren en zet dan Auto-provisioning ON.

info
Edition-vereiste voor Google Workspace Auto-provisioning is alleen beschikbaar op Google Workspace Enterprise Standard, Enterprise Plus of Education Plus. Het is niet beschikbaar op de niveaus Business Starter/Standard/Plus.

JumpCloud

  1. Open Identity Management

    Open in JumpCloud Admin je CalendarBridge SAML-app en ga naar het tabblad Identity Management.

  2. Schakel SCIM in en voer inloggegevens in

    Base URL = het SCIM-eindpunt uit het portaal; Token = het bearer-token uit het portaal. Klik op Test en Save.

  3. Wijs gebruikers of groepen toe

    Wijs gebruikers of gebruikersgroepen toe aan de app; JumpCloud synchroniseert ze naar CalendarBridge.

Het SCIM-token roteren

Als een token wordt blootgesteld, verloren raakt of je het simpelweg op een schema wilt roteren, klik dan op Token roteren in de SCIM-sectie. Het nieuwe token wordt eenmalig weergegeven; het vorige token werkt onmiddellijk niet meer, dus werk het direct bij in de SCIM-connector van je IdP om een synchronisatieonderbreking te voorkomen.

Problemen oplossen

SymptoomWaarschijnlijke oorzaak & oplossing
Testverbinding mislukt met 401 / unauthorized Het bearer-token is verkeerd of werd geroteerd. Kopieer het huidige token uit de SCIM-sectie (roteer indien nodig) en voer het opnieuw in. Zorg er in Okta voor dat je geen Bearer-prefix hebt toegevoegd.
Gebruikers worden niet aangemaakt Bevestig dat provisioning is ingeschakeld en dat de gebruikers in je IdP aan de app zijn toegewezen, en dat hun e-mailadres op een geverifieerd domein staat.
Fout van het type "Gebruiker moet op een geverifieerd domein bestaan" De userName/e-mail van de gebruiker staat op een domein dat niet voor deze organisatie is geverifieerd. Voeg het domein toe en verifieer het, of beperk het provisioningbereik tot geverifieerde domeinen.
Verwijderde gebruikers hebben nog steeds toegang Deprovisioning gebeurt wanneer de IdP active=false verstuurt. Zorg ervoor dat Deactivate Users (of het equivalent van je IdP) is ingeschakeld en dat de gebruiker is opgeheven, niet alleen verborgen.

Hulp krijgen

Als SCIM-provisioning zich niet gedraagt zoals verwacht, neem dan contact op met CalendarBridge-support met het domein van je organisatie, je identity provider en een beschrijving van wat er werd toegewezen versus wat er werd gesynchroniseerd.