Decoder JWT

Come decodificare un JWT

1. Incolla il token nel campo JSON Web Token. Va bene anche un valore completo Authorization: Bearer …: il prefisso Bearer e gli eventuali a capo vengono rimossi.
2. Il token viene decodificato mentre scrivi (oppure premi Decodifica). Header e Payload compaiono come JSON formattato, ognuno con il proprio pulsante Copia.
3. Leggi la tabella Claim temporali: exp, nbf e iat sono mostrati con il valore grezzo, la data nel tuo fuso orario, un tempo relativo (“tra 3 ore”, “2 giorni fa”) e uno stato come Scaduto o Non ancora valido.
4. Controlla gli avvisi sopra i risultati, per esempio quando alg vale none o quando una data sembra espressa in millisecondi.
5. Per controllare la firma, inserisci la chiave nella sezione Verifica la firma e premi Verifica firma.

Decodificare non significa verificare

Un JWT è composto da tre parti in Base64url separate da punti: header.payload.signature. Header e payload sono solo codificati, non cifrati: chiunque abbia il token può leggerli, e questo strumento può decodificare qualsiasi token senza chiave. Proprio per questo un payload decodificato non dimostra nulla, perché qualcuno potrebbe averlo modificato. Solo una firma valida prova che il token è stato emesso da chi possiede la chiave e che non è stato alterato da allora. Per questo la riga di stato indica “Decodificato (firma non verificata)” finché non lo verifichi.

Un token con cinque parti è un JWE (JWT cifrato): il suo contenuto non si può leggere senza la chiave di decifratura, e lo strumento te lo segnala.

Verificare la firma

• HS256, HS384, HS512 (HMAC): inserisci il Segreto condiviso. Con Formato del segreto indichi se è testo semplice (UTF-8) o Base64/Base64url, visto che alcuni provider salvano i segreti in Base64. Puoi anche incollare una JWK di tipo oct. Se il segreto è più corto dell’output dell’hash (32 byte per HS256), lo strumento segnala che è sotto il minimo della RFC 7518.
• RS256/384/512, PS256/384/512, ES256/384/512 ed EdDSA: incolla la Chiave pubblica (PEM o JWK). I blocchi PEM accettati sono PUBLIC KEY, RSA PUBLIC KEY e CERTIFICATE (la chiave viene letta dal certificato X.509). Funziona anche una JWK o un intero JWK Set: viene usata la chiave il cui kid corrisponde a quello dell’header. Le chiavi private vengono rifiutate, perché per verificare non servono mai. EdDSA supporta Ed25519 nei browser la cui Web Crypto lo implementa.

La verifica usa la Web Crypto API del browser. Il risultato “Firma non valida” significa che la chiave è sbagliata o che il token è stato modificato. Tieni presente che l’algoritmo viene preso dall’header del token: un server reale deve invece fissare l’algoritmo atteso nella propria configurazione, altrimenti un attaccante può sceglierlo a piacere.

Note sulla sicurezza

• I token sono credenziali. Chi possiede un access token valido di solito può agire come il suo proprietario fino alla scadenza. Questo strumento decodifica e verifica tutto nel tuo browser e non invia mai né il token né la chiave. Evita comunque di incollare token di produzione in strumenti che non puoi ispezionare.
• alg: none significa che il token non è firmato. Chiunque può falsificarne uno e un server deve rifiutarlo. Lo strumento mostra un avviso e si rifiuta di “verificare” un token del genere.
• I controlli sull’orario usano l’orologio del tuo computer senza alcuna tolleranza; i server spesso concedono un minuto o due di sfasamento.
• Le date JWT (NumericDate) sono secondi dal 1° gennaio 1970 UTC. Un valore di 13 cifre è probabilmente in millisecondi, un bug molto comune.