JWT

Contiene metadati sul token: l'algoritmo di firma (alg) e il tipo di token (typ). È sempre JSON codificato in Base64url. La scelta dell'algoritmo nell'intestazione influisce sulla sicurezza dell'intero token.

{
  "alg": "HS256",
  "typ": "JWT"
}

Contiene i claim: dichiarazioni sull'utente e metadati aggiuntivi. Anche questo è JSON codificato in Base64url. I dati del payload NON sono crittografati, solo firmati. Chiunque intercetti il token può decodificare e leggere il payload senza alcuna chiave.

{
  "sub": "user_123",
  "role": "admin",
  "exp": 1717200000
}

Una firma crittografica sull'intestazione e il payload codificati. La verifica garantisce che il token non sia stato manomesso. La chiave segreta (HMAC) o la chiave privata (RSA/ECDSA) non è mai inclusa nel token e non deve mai essere distribuita a parti non fidate.

HMACSHA256(
  base64url(header) + "." +
  base64url(payload),
  secret
)

Usa una chiave segreta condivisa per la firma e la verifica. Semplice da implementare, ma richiede che tutti i verificatori conoscano il segreto.

Usa una chiave privata per firmare e una pubblica per verificare. La chiave privata non lascia mai il server di autenticazione. Le chiavi pubbliche possono essere distribuite liberamente tramite un endpoint JWKS.

Come RSA ma con chiavi più piccole e firma più veloce. Offre sicurezza equivalente con prestazioni migliori.

Nessuna firma. Un token con alg:none non ha garanzie di integrità e può essere falsificato da chiunque.

Alcune librerie accettano token con alg:none (nessuna firma). Un attaccante può modificare il payload e impostare alg su none per falsificare qualsiasi JWT. Specifica e valida sempre esplicitamente l'algoritmo consentito.

Se una libreria deve verificare RS256 ma accetta HS256, un attaccante può firmare un token usando la chiave pubblica come segreto HMAC. La libreria lo verifica con successo. Fissa sempre l'algoritmo atteso nella configurazione della libreria.

Un JWT senza claim exp, o codice che non controlla exp, permette l'uso indefinito dei token anche dopo che un utente si è disconnesso o è stato disabilitato. Imposta sempre brevi tempi di scadenza e verifica il claim exp ad ogni richiesta.

I payload JWT sono codificati in Base64, non crittografati. Chiunque intercetti un JWT può decodificare e leggere il payload. Non memorizzare mai password, numeri di carta di credito o altri segreti nei claim JWT. Se è necessario trasmettere dati sensibili nel token, utilizzare JWE (JSON Web Encryption).

I JWT firmati con HMAC con segreti brevi o prevedibili possono essere violati offline con forza bruta. Un attaccante che ottiene un JWT può provare miliardi di chiavi al secondo. Usa segreti casuali crittograficamente sicuri di almeno 256 bit.

Accettare JWT senza verificare la firma si fida completamente del payload. Questo è un bug critico che consente a qualsiasi utente di creare claim arbitrari. Verifica sempre la firma prima di fidarti di qualsiasi claim.

I JWT standard (JWS — JSON Web Signature) sono firmati ma NON crittografati. Il payload è codificato in Base64url, facilmente reversibile. Chiunque ottenga un JWT può leggerne il contenuto. JWE (JSON Web Encryption) fornisce crittografia reale, ma è molto meno comune e aggiunge complessità operativa.

I token di accesso dovrebbero essere di breve durata: da 5 a 60 minuti è tipico. I token di lunga durata sono pericolosi perché non possono essere revocati senza una lista di blocco. Usa token di aggiornamento (a lunga durata, memorizzati in modo sicuro) per ottenere nuovi token di accesso. In contesti ad alta sicurezza, come operazioni finanziarie o accesso a dati sensibili, considera token di accesso con validità di soli 5-15 minuti.

I cookie HttpOnly sono l'opzione più sicura — inaccessibili a JavaScript, prevenendo il furto tramite XSS. localStorage è vulnerabile agli attacchi XSS ma evita il CSRF. La memoria (variabile JavaScript) è la più sicura ma non sopravvive al refresh della pagina. Non esiste un'opzione perfetta: la scelta dipende dal modello di minaccia dell'applicazione e dall'uso combinato di misure di mitigazione come Content Security Policy.

Non senza stato lato server. La natura stateless dei JWT significa che il server non può invalidarli. Soluzioni: brevi tempi di scadenza, una lista di blocco dei token (Redis), token di aggiornamento rotanti, oppure passare a token di sessione opachi per operazioni sensibili. Una lista di blocco basata sul claim jti (JWT ID) consente la revoca precisa di singoli token senza invalidare l'intera sessione utente.

I cookie di sessione memorizzano un ID di sessione casuale; il server cerca i dati di sessione nel database o nella cache. I JWT sono autonomi — il server valida la firma senza query al database. I JWT scalano meglio su più server ma non possono essere revocati senza infrastrutture aggiuntive. I cookie di sessione sono più semplici da revocare ma richiedono storage condiviso in ambienti distribuiti.

Il minimo: sub (ID utente), exp (scadenza) e iat (emesso il). Aggiungi iss (issuer) per configurazioni multi-servizio e aud (audience) per limitare l'uso del token a specifici servizi. Mantieni i payload piccoli — i JWT vengono inviati con ogni richiesta. Non includere dati sensibili né oggetti profilo di grandi dimensioni.

RS256 (asimmetrico) è migliore per la maggior parte dei sistemi di produzione perché solo il server di autenticazione ha bisogno della chiave privata. Più servizi possono verificare i token usando la chiave pubblica senza condividere un segreto. HS256 è più semplice ma richiede che tutti i verificatori conoscano il segreto condiviso, aumentando la superficie di attacco in architetture con molti servizi.

PKCE (Proof Key for Code Exchange) è un'estensione del flusso di codice di autorizzazione OAuth2 che previene gli attacchi di intercettazione del codice. È obbligatorio per i client pubblici (SPA, app mobile) che non possono memorizzare in modo sicuro un client secret. Funziona generando una coppia di valori casuali — code verifier e code challenge — che legano la richiesta di autorizzazione allo scambio del token, rendendo inutilizzabile un codice intercettato.