Adamant Solutions

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

  1. Copia l’errore dal corpo della risposta, dalla barra degli indirizzi del browser (dopo un login fallito) o dal log dell’API.
  2. Incollalo al passo 1. Va bene uno qualsiasi di questi: invalid_grant, un corpo JSON, un URL di redirect che contiene error= o un header WWW-Authenticate.
  3. Leggi le cause partendo dall’alto: sono ordinate in base a quanto spesso sono il vero motivo. Esegui i controlli indicati.
  4. 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_grant sulla richiesta del token di solito significa che il code è stato usato due volte o è scaduto, oppure che il redirect_uri o il code_verifier PKCE sono diversi da quelli della richiesta di autorizzazione. Esempio: l’app ha registrato https://app.example.com/callback e nella richiesta del token ha inviato https://app.example.com/callback/. Il passo 2 segnala "Il percorso differisce solo per una barra finale".
  • invalid_client spesso 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_token da 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.

I flussi di login continuano a fallire, o stai progettando OAuth2 per la tua API?

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