JWT scaduto (exp): perché un token appena creato viene rifiutato
Il claim exp indica l'istante dopo il quale il token non deve più essere accettato, espresso in secondi dal 1° gennaio 1970 UTC. Un errore "token scaduto" significa che l'orologio di chi verifica ha superato quell'istante. Spesso il token è davvero vecchio; a volte sono sbagliati gli orologi o le unità di misura. Rispondi alle domande per scoprire quale caso è il tuo.
Individua la causa
Tutte le cause e le soluzioni
exp è espresso in millisecondi, non in secondi
- Le date numeriche JWT sono espresse in secondi dall’epoch. Un token creato con Date.now() (millisecondi) ha exp circa 1000 volte più grande del previsto; un verificatore che interpreta i millisecondi lo accetterà, mentre uno conforme agli standard potrebbe rifiutarlo (o viceversa).
- Durante la creazione, dividi per 1000:
Math.floor(Date.now()/1000) + lifetimeSeconds. - Controlla il numero di cifre: 10 indica i secondi, 13 i millisecondi. Il convertitore timestamp li distingue.
Il client usa un token scaduto
- I token di accesso hanno durata breve (spesso da 5 a 60 minuti). Il client deve rinnovare il token o autenticarsi di nuovo quando la scadenza è vicina, non dopo il rifiuto dell’API.
- Salva la scadenza insieme al token (da expires_in o dal claim exp) e rinnovalo in anticipo.
- Dopo un errore 401 per token scaduto, rinnovalo una volta e ripeti la richiesta una sola volta.
La durata è inferiore al tempo necessario
- Se l’operazione dura più del token, rinnovalo durante l’esecuzione oppure richiedi una durata maggiore, se la policy di sicurezza lo consente.
- Token più longevi aumentano i danni in caso di furto: preferisci il rinnovo.
Disallineamento degli orologi tra sistemi
- I token vengono convalidati usando l’orologio del verificatore. Se è indietro o avanti rispetto a quello dell’issuer, token validi sembrano scaduti o non ancora validi.
- Sincronizza tutte le macchine con NTP (container e VM ereditano l’orologio host; i portatili in sospensione possono sfasarsi).
- Confronta l’ora effettiva dei due sistemi con lo strumento timestamp e l’header Date della risposta dell’issuer.
Aggiungi una tolleranza ridotta per l’orologio
- Anche con NTP possono esserci differenze di pochi secondi. Molte librerie consentono una tolleranza di 30–60 secondi per exp e nbf: usala senza esagerare.
Token non ancora valido (nbf) o emesso nel futuro (iat)
- Se nbf o iat è successivo all’ora del verificatore, il token viene rifiutato come non ancora valido: probabilmente l’orologio del verificatore è indietro rispetto a quello dell’issuer.
- Sincronizza gli orologi e aggiungi una piccola tolleranza.
Il token non è scaduto: cerca altrove
- Il messaggio potrebbe dipendere da un altro controllo: audience (aud), issuer (iss), firma o un risultato «scaduto» in cache.
- Consulta la guida alla firma JWT non valida e decodifica il token con l’ispettore JWT per confrontare iss e aud con i valori attesi dall’API.
- Un gateway o una cache può conservare un vecchio risultato di convalida: svuotala o controlla il TTL.
Domande frequenti
Quanto dovrebbe durare un token JWT di accesso?
Non esiste una regola unica: i token di accesso hanno spesso durata breve (da pochi minuti a un’ora) e vengono rinnovati con refresh token. La durata corretta dipende dai danni che potrebbe causare la perdita del token.
I valori exp sono in secondi o millisecondi?
Secondi dal 01/01/1970 UTC (NumericDate RFC 7519). I millisecondi sono una causa frequente di errore.
Perché un token appena creato risulta già scaduto?
Di solito dipende da orologi non sincronizzati tra issuer e verificatore oppure da exp calcolato con unità o fuso orario errati.
Informazioni sulla pagina
Le risposte non vengono inviate: le domande funzionano nel browser. Se incolli dati negli strumenti collegati, leggi le rispettive note sulla privacy e usa dati di test. Consulta l’informativa sulla privacy.
Correlati: ispettore JWT · convertitore timestamp · firma JWT non valida · tutte le guide agli errori
Configuriamo e analizziamo OAuth2/OIDC e API gateway, inclusi WSO2 Identity Server e API Manager. Scopri i servizi WSO2 o la revisione di sicurezza.
Scrivici su LinkedIn