Adamant Solutions

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

Hai ancora problemi o stai progettando il flusso della tua API?

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