SCIM

Delen

Hebt u iets aan dit artikel?

Laatst bijgewerkt:

Gids voor SCIM-configuratie

Met de System for Cross-domain Identity Management (SCIM)-integratie van KnowBe4 kun je gegevens uit je SCIM-identiteitsprovider (IdP) gebruiken om gebruikers binnen je KSAT-console te beheren. Met deze integratie worden gebruikers automatisch toegevoegd, gewijzigd en gearchiveerd in je KSAT-console op basis van gegevens die vanuit je SCIM-IdP worden verzonden. Nadat je deze integratie hebt geconfigureerd en je gebruikers hebt geïmporteerd, kun je al je gebruikers op één centrale plek beheren.

Onthoud: beheerders worden niet gearchiveerd, tenzij hun machtigingen zijn verwijderd.

Je kunt er ook voor kiezen om gebruikers toe te voegen, te wijzigen en te archiveren met de Active Directory-integratie (ADI). Meer informatie over ADI vind je in onze Configuratiegids voor Active Directory-integratie (ADI).

Hoe SCIM werkt

Met SCIM kun je al je gebruikers op één plek beheren door gebruikersgegevens vanuit je IdP te synchroniseren met je KSAT-console.

Voordat je SCIM inschakelt, beheer je gebruikers in je KSAT-console door gebruikersgegevens rechtstreeks te bewerken of door deze gegevens met CSV-bestanden bij te werken. Nadat je SCIM hebt ingeschakeld en de eerste synchronisatie heeft plaatsgevonden, worden gebruikers beheerd via je SCIM-IdP en worden wijzigingen gesynchroniseerd met je KSAT-console.

Dit is een éénrichtingssynchronisatie. Wijzigingen die je in je KSAT-console aanbrengt, worden dus niet gesynchroniseerd met je SCIM-IdP. Als je wijzigingen in je KSAT-console aanbrengt, worden deze overschreven door de gegevens uit je SCIM-IdP. Bij een synchronisatie worden gebruikers automatisch gearchiveerd in je KSAT-console als ze niet in je SCIM-IdP voorkomen.

Vereisten

Controleer of je aan de volgende vereisten voldoet voordat je SCIM configureert:

  • Je hebt toegang tot je SCIM-token en Tenant-URL in je KSAT-accountinstellingen. In het gedeelte SCIM configureren hieronder staat meer informatie over waar je deze gegevens vindt.
  • Je weet welke gebruikers je vanuit je SCIM-IdP naar je KSAT-console wilt synchroniseren.
Opmerking: Je kunt voorkomen dat bepaalde gebruikers door SCIM worden beheerd. Als je wil voorkomen dat bepaalde gebruikers door SCIM worden beheerd, dan maak je een CSV-bestand aan met deze gebruikers. Voer voor hen 'false' in onder de kolom Beheerd via User Provisioning.

SCIM configureren

Je kunt je SCIM-IdP met je KSAT-console verbinden nadat je enkele instellingen in je accountinstellingen in KSAT hebt ingeschakeld. Voltooi daarna de configuratie in je SCIM-IdP.

Opmerking: Als je overstapt van ADI naar SCIM, houd er dan rekening mee dat de SCIM-integratie geen alias-e-mailadressen ondersteunt. Alle alias-e-mailadressen worden verwijderd nadat je Testmodus uitschakelt en een synchronisatie uitvoert.

Volg de onderstaande stappen om SCIM-instellingen in je KSAT-console te configureren:

  1. Klik in je KSAT-console rechtsboven op je e-mailadres.
  2. Selecteer Accountinstellingen.
  3. Ga naar Gebruikersbeheer > User Provisioning.

  4. Vink User provisioning (gebruikers synchroniseren) inschakelen aan. Nadat je dit selectievakje hebt geselecteerd, verschijnen aanvullende instellingen.

  5. Klik op SCIM.

  6. Klik dan op SCIM-token aanmaken. Er opent nu een nieuw browservenster met je SCIM-token. Kopieer dit token en bewaar het op een plek waar je het later gemakkelijk kunt terugvinden.

    Belangrijk: nadat je het venster sluit, kun je dit SCIM token niet opnieuw bekijken. Zodra je het SCIM-token hebt aangemaakt, verandert de knop SCIM-token aanmaken in SCIM-token opnieuw aanmaken. Meer informatie hierover vind je in het gedeelte SCIM-instellingen van dit artikel.
  7. Klik op OK om het venster te sluiten.

  8. Kopieer je Tenant-URL en bewaar deze op een plek waar je hem later gemakkelijk kunt terugvinden.

    Belangrijk: controleer voordat je doorgaat of je de Tenant-URL en je SCIM-token uit stap 7 goed hebt opgeslagen. Je hebt beide nodig wanneer je SCIM configureert in je IdP.

  9. Zorg dat Testmodus is aangevinkt.

    Belangrijk: We raden aan om Testmodus ingeschakeld te laten totdat je de SCIM-integratie volledig hebt geconfigureerd en een synchronisatie goed hebt uitgevoerd. Testmodus genereert een rapport van wat er gebeurt wanneer SCIM wordt ingeschakeld op basis van je huidige configuratie. Met Testmodus ingeschakeld, worden er geen wijzigingen aangebracht in je KSAT-console. Ben je klaar om te synchroniseren, dan kun je Testmodus uitschakelen via Accountinstellingen. Als je overstapt van ADI naar SCIM, wordt Testmodus automatisch ingeschakeld nadat je je accountinstellingen hebt opgeslagen.

  10. Klik op Wijzigingen opslaan onderaan de pagina Accountinstellingen.

Ondersteunde providers

Nu je SCIM in je KSAT-console hebt ingeschakeld, kun je de verbinding in je SCIM-IdP voltooien.

Opmerking: KnowBe4 ondersteunt alleen de configuraties in de onderstaande gidsen. Als je van de instructies in deze artikelen afwijkt, kun je problemen ervaren met user provisioning.

Raadpleeg een van de onderstaande artikelen om SCIM met jouw IdP te configureren:

SCIM-instellingen

Nadat je de SCIM-integratie hebt ingeschakeld, zie je drie knoppen in het onderdeel SCIM van je accountinstellingen. Met deze knoppen kun je SCIM-tokens opnieuw aanmaken of intrekken en handmatig een synchronisatie afdwingen. Zie de screenshot en lijst hieronder voor meer informatie over deze knoppen:

  1. SCIM-token opnieuw aanmaken: klik hierop om een nieuw SCIM-token aan te maken. Je kunt dit token maar één keer bekijken. Sla het dus op voordat je het browservenster sluit. De verbinding tussen je IdP en je KSAT-console wordt uitgeschakeld totdat je het nieuwe token opgeeft.
  2. SCIM-token intrekken: klik hierop om je huidige SCIM-token uit te schakelen. IdP's die dit token gebruiken, verliezen de verbinding met je KSAT-console.
  3. Nu synchroniseren afdwingen: klik hierop om op elk moment handmatig een SCIM-synchronisatie te starten zonder dat er een wijziging vanuit je IdP nodig is.

Veelgestelde vragen

Hieronder vind je een lijst met veelgestelde vragen over SCIM.

Welke kenmerken ondersteunt KnowBe4?

De kenmerken die we ondersteunen zijn afhankelijk van je IdP. Raadpleeg de documentatie voor je specifieke identiteitsprovider voor meer informatie hierover.

Kan ik SCIM en ADI tegelijkertijd gebruiken?

Nee, je kunt SCIM en ADI niet tegelijkertijd gebruiken. Je kunt wel via je accountinstellingen tussen deze twee verbindingen wisselen. Houd er rekening mee dat je gegevens kunnen worden overschreven of verloren kunnen gaan wanneer je tussen ADI en SCIM wisselt en de synchronisatie start terwijl Testmodus is uitgeschakeld.

Heeft KnowBe4 een limiet voor hoe vaak ik gebruikers via SCIM kan synchroniseren?

We hanteren een algemene synchronisatielimiet van 15 minuten om overbelasting van de servicewachtrij te voorkomen. Als er minder dan 15 minuten geleden al een synchronisatie is uitgevoerd, wordt een nieuw synchronisatieverzoek overgeslagen.

Had u iets aan dit artikel?

Aantal gebruikers dat dit nuttig vond: 29 van 37

Kunt u niet vinden wat u zoekt?

Contact met ondersteuning