SAML SSO instellen
Met single sign-on (SSO) kan uw team inloggen bij Kliv met de accounts die ze al voor hun werk gebruiken, via de identiteitsprovider van uw bedrijf (de dienst die de logins van uw medewerkers beheert, zoals Okta of Microsoft Entra). Geen apart Kliv-wachtwoord om te beheren, en als iemand vertrekt, verwijdert u die persoon op één plek en vervalt ook de toegang hier.
SAML is de meest ondersteunde manier om een identiteitsprovider te koppelen. Deze pagina leidt u door het instellen, het testen met een echte aanmelding en het inschakelen, in die volgorde, zodat er voor uw team niets stukgaat.
U configureert dit allemaal zelf. U hebt geen supportticket of gesprek met een leverancier nodig.
Voordat u begint
- U hebt een beheerdersaccount nodig met de bevoegdheid om single sign-on voor uw organisatie te beheren.
- U hebt toegang nodig tot de beheerconsole van uw identiteitsprovider (Okta, Entra, Google Workspace, OneLogin of een andere SAML-provider).
- Zorg voor een domein dat u kunt verifiëren: het e-maildomein waarmee uw team inlogt (bijvoorbeeld
yourcompany.com).
De installatiewizard openen
- Ga naar Gebruikersbeheer → Single Sign-On.
- Kies Single sign-on instellen.
- Kies uw provider: Okta, Microsoft Entra, Google, OneLogin of Other. Kiest u een bekende provider, dan worden de juiste instellingen vooraf ingevuld en hoeft u minder met de hand over te nemen.
- Laat het protocol op SAML staan (de standaardwaarde). OIDC is een geavanceerd alternatief; zie OIDC SSO instellen.
Instellingen uitwisselen met uw identiteitsprovider
SSO werkt doordat uw identiteitsprovider en Kliv elkaar vertrouwen. U geeft beide een paar gegevens over de ander:
- Kliv toont de waarden die uw provider nodig heeft (zoals de aanmeld-URL waarop Kliv luistert). Kopieer die naar een nieuwe SAML-applicatie in de beheerconsole van uw provider.
- Uw provider geeft u zijn eigen gegevens terug, meestal een metadata-URL of een XML-bestand, plus een ondertekeningscertificaat. Plak de metadata in Kliv (of upload het bestand).
- Zorg dat uw provider voor elke gebruiker een stabiele identificatie meestuurt, niet alleen een e-mailadres. (Het exacte kenmerk verschilt per provider: de voorinstelling noemt het kenmerk dat u moet gebruiken; controleer de benaming in uw console.) Dit is de waarde waarmee Kliv een terugkerende gebruiker herkent, ook als het e-mailadres verandert.
Kliv slaat dit op als concept. Een concept is geconfigureerd maar nog niet live: uw team logt nog steeds in zoals nu, totdat u klaar bent.
Uw domein verifiëren
Voordat Kliv accounts aanmaakt vanuit uw provider, moet u aantonen dat u het e-maildomein beheert dat uw team gebruikt. Zo kan niemand een domein claimen dat niet van hem is.
Volg Uw domein verifiëren om een DNS-record of een bestand aan uw website toe te voegen. Kom hier terug zodra Geverifieerd wordt getoond.
Testen met een echte aanmelding
Deze stap maakt SSO veilig om in te schakelen: u laat zien dat de hele route werkt voordat iemand er last van heeft.
- Kies in de wizard Aanmelding testen.
- U wordt naar uw identiteitsprovider gestuurd om in te loggen, precies zoals uw team dat zal doen.
- Lukt het, dan legt Kliv de geslaagde test vast en ontgrendelt het de knop Inschakelen.
- Mislukt het, dan toont Kliv wat het verwachtte en wat uw provider daadwerkelijk heeft gestuurd; zie Een mislukte SSO-aanmelding oplossen. Herstel het in uw provider en test opnieuw.
U kunt SSO pas inschakelen nadat een testaanmelding is geslaagd met precies de configuratie die u gaat activeren. Alleen opslaan is nooit genoeg.
Inschakelen
Zodra de test is geslaagd, kiest u Inschakelen. Vanaf dat moment stuurt Kliv iedereen die een e-mailadres op uw geverifieerde domein invoert door naar uw identiteitsprovider om in te loggen. Wie voor het eerst inlogt, krijgt automatisch een Kliv-account met standaardtoegang voor leden.
Nieuwe leden komen alleen in uw groep Iedereen terecht. Ze krijgen geen beheerdersrol of andere verhoogde rol van uw identiteitsprovider, tenzij u dat bewust instelt; zie IdP-groepen koppelen aan Kliv-rollen.
Na de installatie
Op uw pagina Single Sign-On ziet u nu een statuskaart in plaats van de wizard: uw provider, uw geverifieerde domein, de laatste geslaagde aanmelding en een waarschuwing als uw ondertekeningscertificaat bijna verloopt. Let op die waarschuwing: een verlopen certificaat blokkeert aanmeldingen totdat u een nieuw certificaat uploadt.
Wilt u dat iedereen op uw domein SSO gebruikt, en een veilige achterdeur houden voor als het ooit misgaat? Zie SSO verplichten en break-glass-beheerders instellen.