La generazione di un JWT conforme agli standard nella JWS Compact Serialization (RFC 7515 Sezione 3.1) trasforma un header JOSE, un set di claim JSON e una chiave segreta simmetrica in una stringa composta da tre parti formattata come <header>.<payload>.<signature>.
1. Costruire l'Header JOSE e il Payload dei Claim API
Inizia con un header protetto HS256 e un payload JSON che combina i claim registrati RFC 7519 (iss, sub, aud, iat, exp) con i claim personalizzati dell'applicazione (role):
{
"alg": "HS256",
"typ": "JWT"
}
{
"iss": "https://auth.example.com",
"sub": "usr_9481",
"aud": "api.example.com",
"iat": 1767225600,
"exp": 1767229200,
"role": "admin"
}
Qui 1767225600 rappresenta 2026-01-01T00:00:00Z e 1767229200 rappresenta 2026-01-01T01:00:00Z (una durata del token di 1 ora).
2. Costruire l'Input di Firma Base64URL senza Padding
Ogni oggetto JSON viene minificato in byte UTF-8 senza spazi superflui, codificato con Base64URL (alfabeto - e _, padding = rimosso) e unito con un punto ASCII (.):
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJodHRwczovL2F1dGguZXhhbXBsZS5jb20iLCJzdWIiOiJ1c3JfOTQ4MSIsImF1ZCI6ImFwaS5leGFtcGxlLmNvbSIsImlhdCI6MTc2NzIyNTYwMCwiZXhwIjoxNzY3MjI5MjAwLCJyb2xlIjoiYWRtaW4ifQ
3. Vettore di Firma HMAC-SHA256 Riproducibile
Web Crypto importa i byte del tuo segreto tramite crypto.subtle.importKey("raw", secretBytes, { name: "HMAC", hash: "SHA-256" }, false, ["sign"]) e firma gli esatti byte ASCII <base64url-header>.<base64url-payload>. Puoi verificare la parità deterministica tra OpenSSL, crypto di Node.js, PyJWT di Python e questo generatore utilizzando il vettore di test canonico HS256 con il segreto UTF-8 your-256-bit-secret:
{
"sub": "1234567890",
"name": "John Doe",
"iat": 1516239022
}
La firma dell'header {"alg":"HS256","typ":"JWT"} e del payload soprastante con your-256-bit-secret produce sempre esattamente questo token di 147 caratteri, pronto per un header HTTP Authorization: Bearer <token> o per la verifica incrociata nel Decodificatore e Ispettore JWT:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c