Dottore degli errori OAuth2 e OIDC
Incolla l’errore che hai ricevuto e scopri cosa significa di solito, le cause nell’ordine in cui più spesso si rivelano quelle vere e cosa controllare. Un secondo strumento confronta il redirect URI che hai inviato con quello registrato ed elenca ogni differenza. Tutto avviene nel tuo browser.
Incolla solo l’errore, non i segreti. Non serve includere token, client secret o authorization code. Contiamo solo le visite anonime (niente cookie, niente IP).
1. Cosa significa questo errore?
2. Confronta i redirect URI
Come si usa questa pagina
- Copia l’errore dal corpo della risposta, dalla barra degli indirizzi del browser (dopo un login fallito) o dal log dell’API.
- Incollalo al passo 1. Va bene uno qualsiasi di questi:
invalid_grant, un corpo JSON, un URL di redirect che contieneerror=o un headerWWW-Authenticate. - Leggi le cause partendo dall’alto: sono ordinate in base a quanto spesso sono il vero motivo. Esegui i controlli indicati.
- Se l’errore parla del redirect URI, usa il passo 2 con le stringhe esatte della tua app e della registrazione del client sul server.
Esempi
invalid_grantsulla richiesta del token di solito significa che il code è stato usato due volte o è scaduto, oppure che ilredirect_urio ilcode_verifierPKCE sono diversi da quelli della richiesta di autorizzazione. Esempio: l’app ha registratohttps://app.example.com/callbacke nella richiesta del token ha inviatohttps://app.example.com/callback/. Il passo 2 segnala "Il percorso differisce solo per una barra finale".invalid_clientspesso significa che il secret viene inviato in un modo che il server non accetta (HTTP Basic invece del corpo del form, o viceversa) oppure appartiene a un altro ambiente.invalid_tokenda una API indica un token scaduto o con l’audience sbagliata: decodificalo con l’ispettore JWT.
Cosa non fa questo strumento
Spiega gli errori standard definiti in RFC 6749, RFC 6750, RFC 7636, RFC 8628 e OpenID Connect Core. I provider aggiungono codici e messaggi propri: per quelli leggi la documentazione del provider e l’error_description. Non può vedere la configurazione del tuo server, quindi le cause sono motivi probabili, non una diagnosi.
Privacy e sicurezza di ciò che incolli
Il testo che incolli viene elaborato nel tuo browser. Non viene inviato a noi né salvato. Evita comunque di incollare segreti attivi: un authorization code, un access token o un client secret sono credenziali, e per errori e redirect URI non servono. Se ne hai incollato uno per sbaglio, revocalo o sostituiscilo. Vedi l’informativa sulla privacy.
Strumenti collegati: tester di flussi OAuth2 · ricevitore di callback (in inglese) · ispettore JWT · tester di richieste HTTP.
Configuriamo e rivediamo OAuth2/OIDC con WSO2 Identity Server e API Manager. Vedi i servizi WSO2 o la revisione di sicurezza (in inglese).
Scrivici su LinkedIn