Firma JWT non valida: perché la verifica fallisce
La verifica della firma è fallita: la libreria l’ha calcolata con la chiave disponibile, ma il risultato non corrisponde alla firma nel token. La chiave potrebbe essere errata, il token modificato oppure l’algoritmo o il formato della chiave inatteso. Rispondi alle domande per individuare la causa. Non risolvere mai disattivando la verifica.
Individua la causa
Tutte le cause e le soluzioni
Esamina prima l’header
- Decodifica il token con l’ispettore JWT (decodifica soltanto, non verifica). I claim alg e kid indicano quale degli altri casi si applica.
Il secret condiviso è diverso
- Con HS256 il verificatore deve usare lo stesso secret del firmatario. Confronta i valori della configurazione effettiva in esecuzione, non quelli nel repository.
- La causa più comune è un ambiente diverso (test o produzione) oppure un vecchio secret dopo la rotazione.
- Se devi confrontare i sistemi, confronta gli hash dei secret, mai i secret stessi.
Il secret viene interpretato in modo diverso
- Alcune librerie si aspettano il secret come testo semplice, altre come byte decodificati da base64. Se il firmatario e il verificatore lo interpretano diversamente, ottengono chiavi diverse anche se sembrano valide.
- Righe vuote finali, virgolette e spazi aggiunti dai file env o dai gestori di secret sono cause frequenti: rimuovili.
La chiave di firma è stata ruotata oppure JWKS è in cache
- Il token è stato firmato con una nuova chiave, ma il verificatore usa ancora quella vecchia. Cerca la chiave tramite il kid del token.
- Aggiorna JWKS quando trovi un kid sconosciuto, applicando un limite alle richieste per evitare recuperi continui, e rispetta gli header di cache.
- Mantieni le vecchie chiavi nel JWKS dell’issuer finché i token firmati con esse sono validi.
La chiave appartiene a un altro issuer o ambiente
- Controlla il claim iss e l’URL JWKS dell’issuer indicato nel documento di discovery. I provider multi-tenant hanno chiavi diverse per ogni tenant.
- I token di produzione non possono essere verificati con le chiavi di test, e viceversa.
Il token è stato modificato durante il trasferimento
- Copia e incolla può aggiungere spazi, ritorni a capo o virgolette; la codifica URL può alterare i caratteri. Il prefisso "Bearer " non deve far parte del token.
- I limiti di dimensione degli header nei proxy o nei server possono troncare i token lunghi: controlla che il token non termini bruscamente.
- Basta modificare un carattere dell’header o del payload perché la verifica della firma fallisca.
Formato della chiave o algoritmo non corrispondente
- La libreria può aspettarsi una chiave pubblica PEM ma ricevere un certificato, un JWK o una chiave diversa nel bundle. Converti la chiave nel formato previsto.
- Imposta gli algoritmi consentiti nel verificatore senza fidarti del claim alg nell’header del token.
- Le firme ES256 usano in JWT il formato raw (r||s), non DER: una conversione errata causa errori.
- RS256 e PS256 sono algoritmi diversi anche quando usano la stessa chiave.
Domande frequenti
Una firma non valida significa che il token è contraffatto?
Di solito no: più spesso dipende da una chiave errata o obsoleta, dal formato della chiave o da un token danneggiato durante il trasferimento. Se il token è inatteso e l’errore non ha spiegazione, consideralo comunque sospetto.
Posso disattivare la verifica della firma?
No. Senza verifica chiunque può creare token con claim arbitrari. Correggi la chiave.
Perché il problema si presenta solo a volte?
Spesso dipende dalla rotazione delle chiavi con JWKS in cache oppure da più issuer o ambienti dietro un bilanciatore.
Informazioni sulla pagina
Le risposte non vengono inviate: le domande funzionano nel browser. Se incolli dati negli strumenti collegati, leggi le note sulla privacy e usa dati di test. Consulta l’informativa sulla privacy.
Correlati: ispettore JWT · diagnostico errori OAuth2 · JWT scaduto · 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