Configureer JSON Web Token (JWT)-authenticatie zodat lezers veilig kunnen inloggen met tokens van je applicatie of identiteitsprovider. Dit artikel behandelt de installatiestappen die je uitvoert in Document360 voordat je je applicatie verbindt.
Alleen gebruikers met de rol Eigenaar of Beheerder kunnen JWT configureren in Document360.
Voordat je begint
Dit is het pad om toegang te krijgen tot de configuratie-instellingen () > Gebruikers en rechten > Enterprise SSO > Create SSO > JWT.
Nieuw bij JWT op Document360
Als er geen JWT-configuratie in uw project bestaat, voltooi dan de volgende stappen in volgorde:
- JWT-login configureren: instellingen op gedeeld projectniveau configureren.
- Maak een JWT-configuratie: voeg je eerste JWT-configuratie toe.
- Stel je applicatie in: koppel je applicatie aan Document360.
Extra JWT-configuraties en SSO-providers (SAML of OpenID) kunnen op elk moment aan hetzelfde project worden toegevoegd zonder dat bestaande configuraties worden beïnvloed.
Bestaande JWT-configuratie
Als je JWT vóór oktober 2026 hebt ingesteld, verschijnt je bestaande configuratie nu samen met andere SSO-configuraties op dezelfde Enterprise SSO-pagina onder Instellingen () > Gebruikers & rechten > Enterprise SSO. Je huidige JWT-configuratie blijft actief en lezers kunnen zonder onderbreking blijven inloggen.
Vanuit de SSO-configuratielijst kun je:
- Blijf de configuratie gebruiken: geen wijzigingen nodig.
- Bewerk de configuratie: klik op het Bewerken-icoon om de instellingen bij te werken.
- Verwijder de configuratie: klik op het Verwijderen-icoon om het te verwijderen.
Om een andere JWT-configuratie toe te voegen, klik je op Create SSO, selecteer je JWT en volg je Stap 1 en Stap 2 hieronder. Een project kan tot 5 JWT-configuraties hebben. Je bestaande configuratie blijft ongewijzigd.
Om SSO naast JWT te configureren, klik je op SSO aanmaken uit dezelfde lijst en kies je SAML of OpenID Connect. Je JWT-configuratie wordt niet beïnvloed. Beide zijn tegelijkertijd actief en lezers zien beide opties op de inlogpagina. Zie JWT-configuraties beheren voor details over hoe de inlogpagina eruitziet.
Stap 1: Configureer JWT-login
Klik rechtsboven op de Enterprise SSO-pagina op de instellingenknop om het venster Logininstellingen te openen. Dit is een eenmalige projectinstelling die geldt voor alle aanmeldopties, niet iets wat je per JWT-configuratie configureert.
Om de volgorde te wijzigen waarin de JWT-inlogknop verschijnt naast andere aanmeldopties op uw kennisbanksite, gebruik slepen en neerzetten of herschikken direct in de SSO-configuratielijst. Lees voor meer informatie de inlogopties Herordenen.
Direct JWT-login
Standaard: AAN
- Wanneer ingeschakeld, worden lezers direct doorgestuurd naar JWT-aanmelding zonder dat er een inlogselectiescherm wordt getoond. Dit is passend wanneer JWT de enige authenticatiemethode is voor uw kennisbank.
- Wanneer uitgeschakeld, krijgen lezers een inlogselectiescherm te zien met alle geconfigureerde aanmeldopties (JWT, SSO en de standaard Document360-login). Schakel deze instelling uit wanneer meerdere authenticatiemethoden actief zijn en lezers hun aanmeldmethode moeten kiezen. Een bevestiging is vereist voordat deze wijziging wordt toegepast.
- Wanneer meerdere JWT-configuraties en SSO zijn ingesteld, maar de projecteigenaar wil dat lezers alleen via JWT-authenticatie inloggen, kunnen ze Direct JWT-login inschakelen.
Schakel de standaard inlogpagina uit
Standaard: UIT
- Wanneer ingeschakeld, is de standaard Document360-e-mail- en wachtwoordlogin verborgen. Lezers kunnen alleen authenticeren via geconfigureerde JWT- of SSO-providers. Dit wordt doorgaans gebruikt in bedrijfsomgevingen waar alle toegang tot lezers moet worden beheerd via een gecentraliseerd identiteitssysteem.
Schakel deze instelling pas in nadat JWT- of SSO-authenticatie volledig is geconfigureerd en getest. Als de externe authenticatieprovider verkeerd is geconfigureerd, kunnen lezers geen toegang krijgen tot de kennisbank.
Klik op Sluiten om het dialoogvenster te sluiten. Wijzigingen worden onmiddellijk toegepast.
Stap 2: Maak een JWT-configuratie aan
Klik in de SSO-configuratielijst op Create SSO en selecteer vervolgens JWT. De Create SSO - JWT modal opent met twee tabbladen: Authenticatie en Serverinstellingen.
Tabblad Authenticatie
Naam
Voer een beschrijvende naam in om deze configuratie te identificeren, bijvoorbeeld "Customer Portal SSO". Deze naam verschijnt in de SSO configuratielijst. Als de inlogknop is ingeschakeld, wordt deze naam ook aan lezers op de inlogpagina weergegeven, dus het zou betekenisvol moeten zijn voor het publiek dat inlogt.
Authenticatie
Dit zijn alleen-lezen waarden die door Document360 worden gegenereerd. Kopieer ze met de knop Kopiëren en configureer ze in je identiteitsprovider of clientapplicatie.
| Veld | Beschrijving |
|---|---|
| Callback-URL | De redirect-URL waar de identiteitsprovider lezers naartoe stuurt na succesvolle authenticatie. Registreer dit in je IdP om het aanmeldproces te voltooien. |
| Code generatie URL | Het eindpunt Document360 roept aan om het token op te halen dat wordt gebruikt om lezers in te loggen. |
| Klant-ID | Automatisch gegenereerd door Document360. Dit is de unieke identificatie voor deze JWT-configuratie. Kopieer deze en voeg hem toe aan je clientapplicatie. |
JWT-sleutels
Geheime tokens worden slechts één keer getoond op het moment van aanmaken. Kopieer en sla ze veilig op voordat je de modal sluit. Als ze verloren gaan, moeten ze opnieuw worden gegenereerd, wat de vorige tokens onmiddellijk ongeldig maakt.
Document360 genereert automatisch twee geheime tokens wanneer de modal opent. Deze tokens zijn alleen in platte tekst zichtbaar tijdens deze sessie. Zodra de modal is gesloten, worden ze gemaskeerd en kunnen ze niet worden opgehaald.
| Token | Doel |
|---|---|
| Primaire geheime token | Ondertekent en verifieert JWT-authenticatieverzoeken tussen uw applicatie en Document360. Dit token moet vertrouwelijk worden behandeld. Als het gecompromitteerd is, genereer het onmiddellijk opnieuw en werk uw applicatie bij om ongeautoriseerde toegang te voorkomen. |
| Secundair geheim token | Dient als back-up ondertekeningssleutel ter ondersteuning van inlogrotatie zonder serviceonderbreking. Tijdens de rotatie maakt het secundaire token het mogelijk dat authenticatie doorgaat terwijl het primaire token wordt bijgewerkt. |
Gebruik het Kopiëren-icoon naast elk veld en token om de waarde te kopiëren. Klik op Volgende om door te gaan naar het tabblad Serverinstellingen .
Tabblad Serverinstellingen
| Veld | Verplicht | Beschrijving |
|---|---|---|
| Login-URL | Ja | De URL in je applicatie waar lezers naartoe worden gestuurd om te authenticeren (bijvoorbeeld, https://app.example.com/login). |
| Uitlog-URL | Nee | De URL waarnaar lezers worden doorgestuurd na het uitloggen (bijvoorbeeld https://app.example.com/logout). Indien niet gespecificeerd, worden lezers doorgestuurd naar de standaard JWT-uitlogpagina van Document360. |
| Domeinnaam | — | Automatisch afgeleid van de Login-URL. Dit is het domein dat aan deze JWT-configuratie is gekoppeld. Wanneer een lezer dit domein invoert op de inlogpagina, wordt hij doorgestuurd naar de Login-URL van deze configuratie. Het domein moet uniek zijn over alle JWT-configuraties in het project. |
Regels voor domeinnaamvalidatie:
- Subdomeinen worden behandeld als afzonderlijke elementen.
portal.example.comenexample.comzijn aparte domeinen en kunnen aan verschillende configuraties worden toegewezen. - Wildcard-domeinen zoals deze
*.example.comworden niet ondersteund. Elk domein moet een exacte waarde hebben. - Een domein dat al is toegewezen aan een andere JWT-configuratie in hetzelfde project, kan niet opnieuw worden gebruikt. Een inline validatiefout wordt getoond bij het opslaan.
Geavanceerde instellingen
Vouw de Geavanceerde instellingen uit om de volgende opties te configureren.
Schakel JWT-authenticatie in
Standaard: AAN
Wanneer ingeschakeld, is deze configuratie actief en kunnen lezers deze gebruiken om in te loggen. Het uitschakelen hiervan deactiveert de configuratie zonder deze te verwijderen, wat handig is om een configuratie tijdelijk op te schorten zonder de instellingen te verliezen.
Toon inlogknop
Standaard: UIT
Wanneer ingeschakeld, verschijnt er een merk-loginknop voor deze configuratie op de kennisbank-inlogpagina. Dit geeft lezers een directe aanmeldoptie zonder dat ze een domeinnaam hoeven in te voeren.
Maximaal 3 JWT-inlogknoppen kunnen gelijktijdig op de inlogpagina worden weergegeven. Wanneer deze limiet is bereikt, wordt de schakelaar automatisch uitgeschakeld voor extra configuraties. Lezers die zijn toegewezen aan configuraties zonder zichtbare knop kunnen zich nog steeds authenticeren door hun domeinnaam in te voeren in het domeinnaamveld op de inlogpagina. Om de volgorde te bepalen waarin JWT- en SSO-knoppen op de inlogpagina verschijnen, zie Inlogopties Herschikken.
Wanneer de knop Inlogknop Weergeven is ingeschakeld, zijn de volgende extra velden beschikbaar:
- Tekst van de inlogknop: het label dat op de knop wordt weergegeven. Dit zou duidelijk de authenticatiebron voor lezers moeten identificeren.
- Logo-logo van de inlogknop: een afbeelding geüpload om de knop te merken. Geaccepteerde formaten: JPG, PNG, SVG. Maximale bestandsgrootte: 512 KB.
Klik op Aanmaken om de configuratie op te slaan.
Stap 3: Stel je aanvraag in
Kopieer de volgende waarden uit de JWT-configuratie en voeg ze toe aan de bijbehorende velden in je clientapplicatie:
- Klant-ID
- Callback-URL
- Code generatie URL
- Primaire geheime token
- Secundair geheim token
Klik op Aanmaken. De knop blijft inactief totdat alle vereiste velden geldige waarden bevatten. Bij succes sluit de modal en verschijnt de nieuwe configuratie in de SSO-configuratielijst.
Lezers hebben geen apart Document360-account nodig. Authenticatie wordt volledig via uw applicatie afgehandeld. Een account in uw applicatie is voldoende voor een lezer om toegang te krijgen tot de kennisbank.
Zodra je de configuratie hebt opgeslagen, ga je door met Implement JWT in je applicatie om de backend-redirectlogica op te zetten.
Om een configuratie in of uit te schakelen, geheime tokens te hergenereren, domeinroutering te beheren of auditlogboeken na live te bekijken, zie JWT-configuraties beheren.