Guide agli errori API: OAuth2, JWT e CORS
Guide rapide agli errori che fanno perdere più tempo. Alcune domande aiutano a individuare la causa; seguono l’elenco delle possibili cause e le relative soluzioni.
OAuth2 "invalid_grant"
Errore invalid_grant sull’endpoint token: codice di autorizzazione o refresh token scaduto, già usato, revocato o non corrispondente alla richiesta.
JWT "invalid signature"
Firma JWT non valida: secret o chiave errati, rotazione delle chiavi, algoritmo sbagliato o token modificato/troncato.
JWT "expired" (exp)
JWT rifiutato perché scaduto: durata troppo breve, orologi non sincronizzati, exp in millisecondi invece che secondi o assenza di rinnovo.
OAuth2 "redirect_uri mismatch"
redirect_uri_mismatch o URI di redirect non valido: l’URI inviato non coincide esattamente con uno registrato per il client.
OAuth2 "invalid_client"
Errore invalid_client sull’endpoint token: ID o secret client errato, metodo di autenticazione sbagliato (Basic o body), tipo di client o ambiente non corretto.
CORS error
Il browser blocca una richiesta per un errore CORS: Access-Control-Allow-Origin mancante, preflight fallito, wildcard con credenziali o header mancanti.
Incolla un errore e consulta le cause nel diagnostico errori OAuth2, or decode a token in the ispettore JWT.