OIDC SSO instellen
OIDC is een alternatief voor SAML om uw identiteitsprovider te koppelen. Met beide kan uw team inloggen met de bestaande bedrijfsaccounts; OIDC is een moderner protocol waar sommige providers de voorkeur aan geven. Weet u niet zeker welke u moet gebruiken, kies dan SAML: dat is de standaard en werkt met elke ondersteunde provider. Kies OIDC als uw provider het aanbeveelt of als SAML voor u geen optie is.
De installatie verloopt in dezelfde stappen als bij SAML (configureren, uw domein verifiëren, testen, inschakelen), met een paar details die specifiek zijn voor OIDC.
Voordat u begint
- Een beheerdersaccount met de bevoegdheid om single sign-on te beheren.
- Toegang tot de beheerconsole van uw identiteitsprovider.
- Een domein dat u kunt verifiëren (het e-maildomein waarmee uw team inlogt).
De installatiewizard openen
- Ga naar Gebruikersbeheer → Single Sign-On.
- Kies Single sign-on instellen.
- Kies uw provider en zet het protocol daarna op OIDC.
Instellingen uitwisselen met uw identiteitsprovider
-
Maak in de console van uw provider een nieuwe OIDC-applicatie (of "OpenID Connect") aan. Kliv toont de redirect-URL die u daar moet plakken.
-
Uw provider geeft u een client-ID, een client secret en een issuer-URL (het webadres dat de inlogdienst van uw provider aanduidt). Plak alle drie in Kliv.
-
De issuer-URL moet exact, teken voor teken, overeenkomen met uw provider. Dit gaat het vaakst mis:
- Issuers van Microsoft Entra zijn specifiek voor uw tenant en bevatten een lange identificatie. Kopieer die uit uw eigen app en gebruik niet die uit een handleiding.
- Google publiceert zijn issuer in meer dan één vorm; gebruik precies de vorm die uw console toont.
Wijkt de issuer ook maar een beetje af, dan worden geldige aanmeldingen geweigerd. De teststap hieronder laat zien of dat het probleem is.
Kliv slaat dit op als concept: geconfigureerd maar niet live. Uw team blijft inloggen zoals nu, totdat u klaar bent.
Uw domein verifiëren
Net als bij SAML maakt Kliv geen accounts aan vanuit uw provider voordat u hebt aangetoond dat u het e-maildomein beheert. Volg Uw domein verifiëren en kom hier terug zodra Geverifieerd wordt getoond.
Testen met een echte aanmelding
- Kies Aanmelding testen.
- Log in bij uw provider, precies zoals uw team dat zal doen.
- Lukt het, dan legt Kliv de test vast en ontgrendelt Inschakelen.
- Mislukt het, dan toont Kliv wat het verwachtte en wat het ontving, zodat u de issuer, het secret of de redirect kunt herstellen; zie Een mislukte SSO-aanmelding oplossen.
Inschakelen
Zodra een testaanmelding is geslaagd, kiest u Inschakelen. Mensen op uw geverifieerde domein worden vanaf dat moment doorgestuurd naar uw provider om in te loggen en bij de eerste aanmelding wordt automatisch een standaardaccount voor leden aangemaakt.
Nieuwe leden krijgen alleen toegang als lid, zonder verhoogde rol, tenzij u groepskoppeling instelt.
Een opmerking over de identiteit van de gebruiker
OIDC identificeert elke persoon aan de hand van een vast waardepaar van uw provider, niet aan de hand van het e-mailadres. Dat is bewust: iemand houdt zo hetzelfde Kliv-account, ook als het e-mailadres verandert, en Kliv is er niet van afhankelijk dat uw provider een e-mailadres als "geverifieerd" markeert (sommige providers doen dat niet voor werkaccounts). U hoeft hiervoor niets in te stellen; het is alleen handig om te weten waarom een gewijzigd e-mailadres geen dubbel account oplevert.