--- title: "Configureer JWT in Document360" slug: "configuring-the-jwt-sso" tags: ["JWT"] updated: 2026-10-12T08:21:29Z published: 2026-10-12T08:21:29Z canonical: "docs.document360.com/configuring-the-jwt-sso" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.document360.com/llms.txt > Use this file to discover all available pages before exploring further. # Configureer JWT in Document360 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. OPMERKING 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**. ![JWT configuration page in Document360 settings.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/SSO-configurations.png) ### Nieuw bij JWT op Document360 Als er geen JWT-configuratie in uw project bestaat, voltooi dan de volgende stappen in volgorde: 1. [JWT-login configureren](/docs/nl/configuring-the-jwt-sso#step-1-configure-jwt-login): instellingen op gedeeld projectniveau configureren. 2. [Maak een JWT-configuratie](/docs/nl/configuring-the-jwt-sso#step-2-create-a-jwt-configuration): voeg je eerste JWT-configuratie toe. 3. [Stel je applicatie in](/docs/nl/configuring-the-jwt-sso#step-3-set-up-your-application): 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](/docs/nl/configuring-the-jwt-sso#step-1-configure-jwt-login) en [Stap 2](/docs/nl/configuring-the-jwt-sso#step-2-create-a-jwt-configuration) 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](https://docs.document360.com/docs/nl/managing-jwt-configurations) 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. OPMERKING 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](/docs/nl/configuring-the-jwt-sso#). **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. OPMERKING 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 ![Login settings dialog in Document360.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/JWT-Step1.png) **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** BELANGRIJK 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 ![Create SSO - JWT modal, Authentication tab, in Document360.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/JWT-Step2.png) | 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.com` en `example.com` zijn aparte domeinen en kunnen aan verschillende configuraties worden toegewezen. - Wildcard-domeinen zoals deze `*.example.com` worden 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. OPMERKING 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](/docs/nl/configuring-the-jwt-sso#). 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. OPMERKING 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](https://docs.document360.com/docs/nl/implement-jwt-in-your-application) 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](https://docs.document360.com/docs/nl/managing-jwt-configurations).