Het genereren van een standaardconforme JWT in JWS Compact Serialization (RFC 7515 Sectie 3.1) zet een JOSE-header, een JSON-claimset en een symmetrische geheime sleutel om in een driedelige string met het formaat <header>.<payload>.<signature>.
1. Stel de JOSE-header en API-claims-payload samen
Begin met een beveiligde HS256-header en een JSON-payload die geregistreerde RFC 7519-claims (iss, sub, aud, iat, exp) combineert met aangepaste applicatie-claims (role):
{
"alg": "HS256",
"typ": "JWT"
}
{
"iss": "https://auth.example.com",
"sub": "usr_9481",
"aud": "api.example.com",
"iat": 1767225600,
"exp": 1767229200,
"role": "admin"
}
Hier staat 1767225600 voor 2026-01-01T00:00:00Z en 1767229200 voor 2026-01-01T01:00:00Z (een tokenlevensduur van 1 uur).
2. Bouw de Base64URL-signing-input zonder padding
Elk JSON-object wordt geminificeerd naar UTF-8-bytes zonder extra witruimte, gecodeerd met Base64URL (-- en _-alfabet, =-padding verwijderd) en samengevoegd met een ASCII-punt (.):
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJodHRwczovL2F1dGguZXhhbXBsZS5jb20iLCJzdWIiOiJ1c3JfOTQ4MSIsImF1ZCI6ImFwaS5leGFtcGxlLmNvbSIsImlhdCI6MTc2NzIyNTYwMCwiZXhwIjoxNzY3MjI5MjAwLCJyb2xlIjoiYWRtaW4ifQ
3. Reproduceerbare HMAC-SHA256-testvector
Web Crypto importeert je secret-bytes via crypto.subtle.importKey("raw", secretBytes, { name: "HMAC", hash: "SHA-256" }, false, ["sign"]) en ondertekent de exacte ASCII-bytes van <base64url-header>.<base64url-payload>. Je kunt de deterministische gelijkheid tussen OpenSSL, Node.js crypto, Python PyJWT en deze generator verifiëren met de canonieke HS256-testvector en het UTF-8-secret your-256-bit-secret:
{
"sub": "1234567890",
"name": "John Doe",
"iat": 1516239022
}
Het ondertekenen van de {"alg":"HS256","typ":"JWT"}-header en bovenstaande payload met your-256-bit-secret levert altijd exact dit token van 147 tekens op, direct klaar voor een HTTP Authorization: Bearer <token>-header of round-trip verificatie in de JWT-decoder & -inspecteur:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c