Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Utilizzo del token di aggiornamento
Puoi utilizzare il token di aggiornamento per recuperare nuovi ID e token di accesso. Di default, il token di aggiornamento scade 30 giorni dopo l'accesso dell'utente dell'app al bacino d'utenza. Quando crei un'applicazione per il bacino d'utenza, puoi impostare la scadenza del token di aggiornamento dell'applicazione su qualsiasi valore compreso tra 60 minuti e 10 anni.
Mobile SDK per iOS, Mobile SDK for Android, Amplify per iOS, Android e Flutter aggiornano automaticamente l'ID e i token di accesso se è presente un token di aggiornamento valido (non scaduto). Gli ID e i token di accesso hanno una validità residua minima di 2 minuti. Se il token di aggiornamento è scaduto, l'utente dell'applicazione dovrà eseguire nuovamente l'autenticazione per accedere di nuovo al bacino d'utenza. Se il minimo per il token di accesso e il token ID è impostato su 5 minuti e si utilizza ilSDK, il token di aggiornamento verrà utilizzato continuamente per recuperare nuovi token di accesso e ID. Sarà possibile visualizzare il comportamento previsto impostando un valore minimo di 7 minuti anziché di 5.
L'account dell'utente di per sé non scade, a condizione che l'utente abbia effettuato l'accesso almeno una volta prima del limite di tempo di UnusedAccountValidityDays
per nuovi account.
Ottenere nuovi token di accesso e identità con un token di aggiornamento
Utilizza l'interfaccia utente API o ospitata per avviare l'autenticazione dei token di aggiornamento.
Per utilizzare il token di aggiornamento per ottenere un nuovo ID e accedere ai token con i pool di utentiAPI, usa le operazioni or. AdminInitiateAuthInitiateAuthAPI Invia REFRESH_TOKEN_AUTH
per il parametro AuthFlow
. Nella proprietà AuthParameters
di AuthFlow
, passa il token di aggiornamento dell'utente come valore di "REFRESH_TOKEN"
. Amazon Cognito restituisce un nuovo ID e token di accesso dopo che la API richiesta ha superato tutte le sfide.
Nota
Per utilizzare i pool di utenti di Amazon Cognito API per aggiornare i token per un utente dell'interfaccia utente ospitato, genera una richiesta. InitiateAuth
Puoi anche inviare token di aggiornamento a Endpoint Token in un pool di utenti in cui hai configurato un dominio. Nel corpo della richiesta, includi un valore grant_type
di refresh_token
e un valore refresh_token
del token di aggiornamento dell'utente.
Revoca dei token di aggiornamento
È possibile revocare i token di aggiornamento che appartengono a un utente. Per ulteriori informazioni sulla revoca dei token, consulta Revoca dei token.
Nota
La revoca del token di aggiornamento comporta la revoca di tutti i token ID e di accesso emessi da Amazon Cognito a seguito delle richieste di aggiornamento con tale token.
Gli utenti possono disconnettersi da tutti i dispositivi a cui hanno attualmente effettuato l'accesso quando revochi tutti i token dell'utente utilizzando le operazioni and. GlobalSignOut
AdminUserGlobalSignOut
API Dopo che l'utente viene disconnesso, si verifica quanto segue.
-
Il token di aggiornamento dell'utente non può ottenere nuovi token per l'utente.
-
Il token di accesso dell'utente non può effettuare richieste autorizzate tramite token. API
-
L'utente deve effettuare nuovamente l'autenticazione per ottenere nuovi token. Poiché i cookie della sessione dell'interfaccia utente ospitata non scadono automaticamente, l'utente può eseguire nuovamente l'autenticazione con un cookie di sessione, senza richiedere credenziali aggiuntive. Dopo che gli utenti dell'interfaccia utente ospitata sono stati disconnessi, reindirizzali al Endpoint Logout, in cui Amazon Cognito cancellerà il relativo cookie di sessione.
Con i token di aggiornamento, puoi mantenere le sessioni degli utenti nella tua app a lungo. Nel tempo, i tuoi utenti potrebbero richiedere di rimuovere l'autorizzazione da alcuni dispositivi a cui hanno effettuato l'accesso, aggiornando continuamente la loro sessione. Per disconnettere l'utente da un singolo dispositivo, revoca il relativo token di aggiornamento. Quando l'utente desidera disconnettersi da tutte le sessioni autenticate, genera una richiesta. GlobalSignOutAPI La tua app può presentare all'utente una scelta come Esci da tutti i dispositivi. GlobalSignOut
accetta un token di accesso valido, inalterato, non scaduto e non revocato, di un utente. Poiché API si tratta di un token autorizzato, un utente non può utilizzarlo per avviare la disconnessione per un altro utente.
Tuttavia, puoi generare una AdminUserGlobalSignOutAPIrichiesta che autorizzi con le tue AWS credenziali per disconnettere qualsiasi utente da tutti i suoi dispositivi. L'applicazione di amministrazione deve richiamare questa API operazione con le credenziali AWS dello sviluppatore e passare l'ID del pool di utenti e il nome utente dell'utente come parametri. AdminUserGlobalSignOut
APIPossono disconnettere qualsiasi utente dal pool di utenti.
Per ulteriori informazioni sulle richieste che puoi autorizzare con AWS credenziali o con il token di accesso di un utente, consulta. Operazioni API autenticate e non autenticate per pool di utenti di Amazon Cognito