Best practices voor veilige JWT-implementatie

JWT's zijn slechts zo veilig als hun implementatie. De specificatie is flexibel; die flexibiliteit leidt tot kwetsbaarheden. Volg deze aanbevolen werkwijzen om veelvoorkomende valkuilen te vermijden die in productiesystemen tot omzeiling van authenticatie hebben geleid.

Geef het verwachte algoritme altijd expliciet op: jwt.decode(token, key, algorithms=["RS256"]). Lees het algoritme nooit uit de tokenheader om de verificatiesleutel of het codepad te selecteren. Hiermee voorkom je alg=none- en sleutelverwarringsaanvallen.

Toegangstokens: 15-60 minuten. Vernieuwingstokens: 7-30 dagen, opgeslagen in httpOnly-cookies (niet in localStorage). Na het verlopen gebruikt de client het vernieuwingstoken om zonder opnieuw te authenticeren een nieuw toegangstoken op te halen bij de authenticatieserver.

Valideer aud (doelgroep) om te controleren of het token voor jouw service is uitgegeven en niet voor een andere. Valideer iss (uitgever) tegen de URL van jouw authenticatieserver. Zonder deze controles zou een token van een andere toepassing die met dezelfde sleutel is ondertekend, worden geaccepteerd.

Toegangstokens in het geheugen (JS-variabele) — gewist bij het sluiten van het tabblad. Vernieuwingstokens in httpOnly-, Secure-, SameSite=Strict-cookies — ontoegankelijk voor JavaScript. Sla JWT's nooit op in localStorage — XSS kan ze stelen.

JWT's zijn stateless — er is geen ingebouwde intrekking. Opties: houd een weigerlijst bij die bij elk verzoek wordt gecontroleerd; gebruik een zeer korte geldigheidsduur; gebruik ondoorzichtige tokens met een centrale opzoeking voor situaties met hoge beveiligingseisen.

Roteer ondertekeningssleutels regelmatig. Publiceer meerdere sleutels in JWKS met verschillende kid-waarden. Tijdens de rotatie: geef nieuwe tokens uit met de nieuwe kid, houd de oude sleutel actief totdat oude tokens verlopen en verwijder de oude sleutel daarna uit JWKS.

Zet nooit gevoelige gegevens (wachtwoorden, socialezekerheidsnummers, creditcardgegevens) in de JWT-payload — deze is base64url-gecodeerd, niet versleuteld. Gebruik JWE (JSON Web Encryption) als je versleutelde claims nodig hebt, of houd gevoelige gegevens aan de serverkant.

Verstuur JWT's alleen via HTTPS. Een JWT die via HTTP wordt onderschept, maakt volledige omzeiling van authenticatie mogelijk. Stel de Secure-vlag in op cookies. Gebruik HSTS om een protocolverlaging te voorkomen. Schrijf volledige JWT-tekenreeksen nooit naar serverlogboeken.

Gebruik goed onderhouden bibliotheken: PyJWT 2+, python-jose, auth0/node-jsonwebtoken 9+, Nimbus JOSE + JWT (Java). Implementeer JWT-verificatie niet zelf vanaf nul. Controleer regelmatig CVE-databases op kwetsbaarheden in bibliotheken.

Test alle aanvalsvectoren: dien een alg=none-token in, een token met RS256→HS256-verwarring, een verlopen token, een token met de verkeerde doelgroep en een gemanipuleerde payload. Gebruik jwt.io om testtokens samen te stellen. Voeg integratietests toe die bevestigen dat deze met 401 worden afgewezen.

Veilig gebruik van JWT vereist vastgelegde algoritmen, een korte geldigheidsduur van toegangstokens, opslag van vernieuwingstokens in httpOnly-cookies, validatie van doelgroep en uitgever en sleutelrotatie. Volgende: cryptografische schema's voor geheimdeling.