Risposte agli errori di federazione e dell'interfaccia utente ospitata

Un processo di accesso nell'interfaccia utente ospitata o l'accesso federato potrebbero restituire un errore. Di seguito sono riportate alcune condizioni che possono determinare un errore di autenticazione.

• Un utente esegue un'operazione che il pool di utenti non è in grado di eseguire.

• Un trigger Lambda non risponde con la sintassi prevista.

• Il gestore dell'identità digitale restituisce un errore.

• Amazon Cognito non è riuscito a convalidare le informazioni sugli attributi fornite dall'utente.

• L'IdP non ha inviato richieste che corrispondono agli attributi richiesti.

Quando Amazon Cognito rileva un errore, lo comunica in uno dei seguenti modi.

1. Amazon Cognito invia un reindirizzamento URL con l'errore nei parametri della richiesta.

2. Amazon Cognito visualizza un errore nell'interfaccia utente ospitata.

Gli errori aggiunti da Amazon Cognito ai parametri della richiesta hanno il seguente formato.

https://<Callback URL>/?error_description=error+description&error=error+name

Quando aiuti i tuoi utenti a inviare informazioni di errore quando non possono eseguire un'operazione, richiedi che acquisiscano il testo URL e lo screenshot della pagina.

Nota

Le descrizioni degli errori di Amazon Cognito non sono stringhe fisse e non devi usare una logica basata su un modello o un formato fisso.

OIDCe messaggi di errore del provider di identità sociale

Il provider di identità potrebbe restituire un errore. Quando un IdP OIDC o OAuth 2.0 restituisce un errore conforme agli standard, Amazon Cognito reindirizza l'utente alla callback URL e aggiunge la risposta di errore del provider ai parametri della richiesta di errore. Amazon Cognito aggiunge il nome del provider e il codice HTTP di errore alle stringhe di errore esistenti.

Di seguito URL è riportato un esempio di reindirizzamento da un IdP che ha restituito un errore ad Amazon Cognito.

https://www.amazon.com/?error_description=LoginWithAmazon+Error+-+400+invalid_request+The+request+is+missing+a+required+parameter+%3A+client_secret&error=invalid_request

Poiché Amazon Cognito restituisce solo ciò che riceve da un provider, l'utente potrebbe visualizzare un sottoinsieme di queste informazioni.

Quando l'utente rileva un problema con l'accesso iniziale tramite l'IdP, questo invia eventuali messaggi di errore direttamente all'utente. Amazon Cognito inoltra un messaggio di errore all'utente quando genera una richiesta all'IdP per convalidare la sessione dell'utente. Amazon Cognito inoltra e messaggi di errore OAuth OIDC IdP dai seguenti endpoint.

/token

Amazon Cognito scambia un codice di autorizzazione IdP per un token di accesso.

/.well-known/openid-configuration

Amazon Cognito rileva il percorso agli endpoint dell'emittente.

/.well-known/jwks.json

Per verificare i token JSON Web dell'utente (JWTs), Amazon Cognito rileva le chiavi Web JWKs () utilizzate JSON dal tuo IdP per firmare i token.

Poiché Amazon Cognito non avvia sessioni in uscita verso provider SAML 2.0 che potrebbero restituire HTTP errori, gli errori degli utenti durante una sessione con un SAML IdP 2.0 non includono questo tipo di messaggio di errore del provider.