Stel Single Sign-On (SSO) in zodat je gebruikers en lezers inloggen op Document360 met een account dat ze al hebben, in plaats van een apart Document360-wachtwoord. Dit artikel helpt je de juiste SSO-methode te kiezen, te begrijpen wat mensen zien bij het inloggen en de setup te starten.
Document360 ondersteunt drie methoden:
- SAML 2.0 en OpenID Connect (OIDC): Mensen loggen in via hun identiteitsprovider, zoals Okta, Microsoft Entra ID of Google Workspace.
- JWT (JSON Web Token): Uw eigen applicatie meldt lezers aan en geeft een geverifieerd token door aan Document360, zonder dat identiteitsprovider betrokken is.
Hoe SSO-aanmelden werkt
SSO omvat twee partijen:
- Identiteitsprovider (IdP): De dienst die inloggegevens opslaat en controleert, zoals Okta, Microsoft Entra ID, Google Workspace, ADFS of OneLogin.
- Dienstverlener (SP): Document360. Het vertrouwt op de IdP om te bevestigen wie er inlogt.
Met SAML of OpenID Connect werkt inloggen op dezelfde manier voor gebruikers en lezers:
- Een gebruiker opent het kennisbankportaal, of een lezer opent je kennisbanksite. Ze voeren hun e-mailadres in op de aanmeldpagina of kiezen eerst op de SSO-knop.
- Document360 vindt de bijbehorende SSO-configuratie en stuurt deze naar de aanmeldpagina van je IdP.
- Ze loggen in met hun IDP-inloggegevens. Ze voeren nooit een wachtwoord in in Document360.
- De IdP bevestigt zijn identiteit en stuurt een ondertekend token terug naar Document360.
- Document360 controleert de token en geeft hen toegang op basis van hun rol en rechten.
Als ze al zijn ingelogd bij je IdP voor een andere applicatie, hoeven ze niet opnieuw in te loggen. Met SAML kun je mensen ook toestaan Document360 direct te openen vanaf het dashboard van je IdP. Om te leren hoe, lees IdP-geïnitieerde aanmelding.
Met JWT is er geen IdP en geen redirect. Je applicatie maakt het token aan en ondertekent het, en Document360 controleert het direct.
Kies een SSO-methode
| SAML 2.0 | OpenID Connect | JWT | |
|---|---|---|---|
| Kies het als | Je gebruikt een enterprise- of on-premises IdP, zoals ADFS, of Okta, Microsoft Entra ID, Google Workspace of OneLogin | Je gebruikt een cloudgebaseerde IdP, zoals Okta of Auth0, of ADFS met OpenID Connect | Je beheert het inloggen in je eigen applicatie en wilt de lezers van daaruit inloggen |
| Wie kan zich aanmelden | Gebruikers en lezers | Gebruikers en lezers | Alleen lezers |
| Heeft een IdP nodig | Ja | Ja | Nee |
| Opzetpoging | Medium | Medium | Hoger: vereist aangepaste ontwikkeling |
| SCIM-provisioning | Okta en Microsoft Entra ID; OneLogin alleen voor lezers; ADFS via tools van derden; andere IDP's die SCIM ondersteunen. Niet beschikbaar met Google Workspace. | Okta; ADFS via tools van derden; andere IdP's die SCIM ondersteunen. Niet beschikbaar met Auth0. | Niet beschikbaar |
Combinatiemethoden
- Je kunt meerdere SAML-configuraties tegelijk actief hebben, of meerdere OpenID Connect-configuraties, bijvoorbeeld één IdP voor je gebruikers en een andere voor je lezers.
- SAML en OpenID Connect kunnen niet allebei tegelijk actief zijn. Om van de ene naar de andere te schakelen, schakel je de configuratie uit die je niet meer wilt gebruiken.
- Je kunt tot vijf JWT-configuraties toevoegen naast je SAML- of OpenID Connect-configuraties.
Zet SSO op
Voordat je begint
- Je hebt de rol Eigenaar of Beheerder nodig in je Document360-project.
- Zorg dat je beheerdersrechten hebt voor je IdP, of, voor JWT, een ontwikkelaar die de aanmeldcode van je applicatie kan bijwerken.
- Bepaal welke methode je gaat gebruiken. Zie Kies een SSO-methode.
Elke SSO-configuratie begint op dezelfde plek in Document360:
- Ga naar Instellingen > Gebruikers & Rechten > Enterprise SSO.
- Selecteer Create SSO.
- Selecteer SAML, OpenID Connect of JWT.
- Als je SAML of OpenID Connect hebt geselecteerd, kies dan je identiteitsprovider. De setup-wizard opent.
- Voltooi de wizard met behulp van de gids voor jouw methode.
Als je klaar bent, verschijnt de configuratie in de Enterprise SSO-lijst samen met al je andere SSO-configuraties. Je kunt het daar bewerken, herschikken of verwijderen.
Gebruikers en lezers die via SSO inloggen gebruiken hun IdP-inloggegevens, niet een Document360-wachtwoord. Je kunt jezelf niet buitensluiten: een beheerder kan zijn eigen toegang niet verwijderen, alleen die van een andere beheerder.
Nadat je SSO hebt ingesteld
Wanneer je SSO-configuratie werkt, stel je automatische provisioning in en beheer wie kan inloggen. SCIM is alleen beschikbaar voor SAML en OpenID Connect.
SCIM-provisioning instellen
Voeg gebruikers en lezers toe in je IdP, update en deactiveer ze, en Document360 werkt automatisch bij.
Lees meer →Beheer SSO-toegang
Voeg gebruikers toe, beheer lezers, kaart projecten in kaart en beheer de aanmeldinstellingen.
Lees meer →FAQ
Kan ik SAML en OpenID Connect tegelijk gebruiken?
Nee. Een project kan SAML of OpenID Connect actief hebben, maar niet allebei. Om te schakelen, zet je de configuratie uit die je niet meer wilt gebruiken. Beide kunnen samen met JWT draaien.
Kan ik SSO instellen voor zowel gebruikers als lezers?
Ja. SAML en OpenID Connect werken voor gebruikers die inloggen op het kennisbankportaal en lezers die inloggen op de kennisbanksite. JWT werkt alleen voor lezers en kan niet worden gebruikt om in te loggen op het portaal.
Kan ik meer dan één SSO-configuratie in een project hebben?
Ja. Je kunt meerdere SAML-configuraties of meerdere OpenID Connect-configuraties tegelijk actief hebben, bijvoorbeeld één IdP voor je gebruikers en een andere voor je lezers. Je kunt ook tot vijf JWT-configuraties daarnaast toevoegen.