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à.
L'endpoint di accesso gestito: /login
L'endpoint di accesso è un server di autenticazione e una destinazione di reindirizzamento da. Endpoint Authorize È il punto di accesso all'accesso gestito quando non si specifica un provider di identità. Quando generi un reindirizzamento all'endpoint di accesso, la pagina di accesso viene caricata e vengono presentate le opzioni di autenticazione configurate per il client all'utente.
Nota
L'endpoint di accesso è un componente dell'accesso gestito. Nell'app, richiama le pagine di federazione e di accesso gestito che reindirizzano all'endpoint di accesso. L'accesso diretto da parte degli utenti all'endpoint di accesso non è una best practice.
GET /login
L'endpoint /login supporta solo HTTPS GET per la richiesta iniziale dell'utente. L'app richiama la pagina in un browser come Chrome o Firefox. Quando esegui il reindirizzamento /login da aEndpoint Authorize, vengono trasmessi tutti i parametri che hai fornito nella richiesta iniziale. L'endpoint di accesso supporta tutti i parametri di richiesta dell'endpoint Authorize. Puoi anche accedere direttamente all'endpoint di accesso. Come best practice, crea tutte le sessioni degli utenti in /oauth2/authorize.
Esempio: richiedere all'utente di accedere
In questo esempio viene visualizzata la schermata di accesso.
GET https://mydomain.auth.us-east-1.amazoncognito.com/login? response_type=code& client_id=1example23456789& redirect_uri=https://YOUR_APP/redirect_uri& state=STATE& scope=openid+profile+aws.cognito.signin.user.admin
Esempio: risposta
Il server di autenticazione reindirizza all'app con lo stato e il codice di autorizzazione. IL server deve restituire il codice e lo stato nei parametri della stringa di query e non nel frammento.
HTTP/1.1 302 Found
Location: https://YOUR_APP/redirect_uri?code=AUTHORIZATION_CODE&state=STATE
User-initiated richiesta di accesso
Dopo aver caricato l'endpoint /login, l'utente può inserire un nome utente e una password e scegliere Accedi. Quando lo fanno, generano una richiesta HTTPS POST con gli stessi parametri di richiesta di intestazione come richiesta GET e un corpo della richiesta con il nome utente, la password e l'impronta digitale del dispositivo.
Step-up richiesta di autenticazione
L'/loginendpoint accetta i seguenti parametri URL per l'autenticazione avanzata. Questi parametri hanno lo stesso comportamento dell'endpoint di autorizzazione. Per ulteriori informazioni sui livelli ACR e sui valori AMR, vedere. Livelli di autenticazione con attestazioni ACR e AMR
acr_values-
Un URL-encoded elenco separato da spazi degli URI del livello di autenticazione ACR di destinazione, dal più alto al più basso. Amazon Cognito valuta l'elenco da sinistra a destra, applica il primo livello valido che l'utente può soddisfare e ignora i valori che non riconosce. Questo parametro si comporta come il parametro API.
TARGET_ACR_VALUESRichiede il piano di funzionalità Essentials o Plus. max_age-
Un numero intero non negativo che specifica il numero massimo di secondi trascorsi dall'ultima autenticazione dell'utente. Se il valore dell'ora corrente in meno
auth_timeè maggiore dimax_age, l'utente deve eseguire nuovamente l'autenticazione da zero anziché limitarsi a procedere. Questo comportamento è identico al parametro API.MAX_AGE
Per una richiesta di esempio che utilizza questi parametri, consulta l'endpoint di autorizzazione.
Combina acr_values con max_age per richiedere un livello di autenticazione specifico con l'autenticazione recente per un'operazione sensibile.
Il comportamento di un piano di funzionalità insufficiente è diverso da quello dell'API. L'/loginendpoint di accesso gestito ignora silenziosamente l'autenticazione acr_values e procede con la normale autenticazione, senza errori. L'API restituisce un. FeatureUnavailableInTierException Per ulteriori informazioni, consulta Requisiti del piano di funzionalità.
