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à.
Livelli di autenticazione con attestazioni ACR e AMR
Amazon Cognito è in grado di registrare il livello di autenticazione di un utente e i metodi utilizzati. Fornisci un livello di autenticazione target come input quando un utente accede e Amazon Cognito riporta il livello raggiunto dall'utente e i metodi che ha completato come attestazioni nei token emessi. Queste affermazioni si applicano a qualsiasi accesso, incluso l'accesso iniziale di un utente.
Si richiede un livello di autenticazione con il acr_values parametro sugli endpoint di autorizzazione e accesso gestiti o con il TARGET_ACR_VALUES parametro equivalente nel flusso API. USER_AUTH Entrambi accettano un elenco ordinato di livelli di autenticazione di destinazione. Puoi aggiungere il max_age parametro opzionale (MAX_AGEnell'API) per richiedere che l'utente si sia autenticato entro una finestra temporale recente. In risposta a questi input, Amazon Cognito aggiunge due affermazioni ai token emessi:
-
L'
acrattestazione è una stringa che indica, ad esempio, il livello di autenticazione soddisfatto dall'utente.urn:cognito:loa:3 -
L'
amrattestazione è una matrice di stringhe che indica, ad esempio["pwd", "otp", "mfa"], i metodi di autenticazione completati dall'utente.
Le amr affermazioni acr and seguono le definizioni nella specifica OpenID Connect Core. Amazon Cognito utilizza i propri URI a livello ACR. Puoi tradurre i livelli di Amazon Cognito in qualsiasi standard richiesto dalla tua applicazione.
Step-up l'autenticazione è un caso d'uso comune per queste affermazioni. Nell'autenticazione step-up, l'applicazione richiede che l'utente si autentichi con un metodo più efficace prima di eseguire un'operazione sensibile. Per decidere se richiedere o meno l'autorizzazione, l'applicazione confronta il acr livello e l'auth_timeattestazione contenuti nel token ID dell'utente con il livello e l'aggiornamento richiesti dall'operazione e le richieste di step-up solo quando non sono già state soddisfatte. Quando è necessario eseguire l'installazione, reindirizza l'utente all'endpoint di autorizzazione all'accesso gestito o all'endpoint di accesso con, oppure chiama il flusso API con. acr_values USER_AUTH TARGET_ACR_VALUES Per un esempio, vedi lo scenario di autenticazione. Step-up
Puoi richiedere ACR e AMR da qualsiasi punto di accesso ad Amazon Cognito. I meccanismi di ogni punto di ingresso sono documentati con quel punto di ingresso.
-
Accesso a SDK e API: richiedi un livello target nel
USER_AUTHflusso con i parametri and.TARGET_ACR_VALUESMAX_AGEPer i parametri e il comportamento avanzato, consulta. Step-up autenticazione con il flusso USER_AUTH -
Accesso gestito e interfaccia utente ospitata: passa i
max_ageparametriacr_valuesand sugli endpoint di autorizzazione e accesso. Per i dettagli, consulta l'endpoint di autorizzazione e l'endpoint di accesso. -
Accesso federato: Amazon Cognito ricava i valori ACR e AMR di un utente federato dalla risposta del provider di identità (IdP) e li mappa con il campo.
AcrMappingPer i provider di identità OIDC, consulta. Step-up autenticazione per utenti federati
La richiesta dell'autenticazione avanzata richiede il piano di funzionalità Essentials o Plus. Per ulteriori informazioni, consulta Requisiti del piano di funzionalità.
Argomenti
Livelli e metodi di autenticazione
Amazon Cognito valuta i fattori di autenticazione completati da un utente ed esprime il risultato come un livello di autenticazione nell'attestazione e un elenco di acr metodi di autenticazione nell'attestazione. amr
Livelli di autenticazione ACR
Amazon Cognito definisce quattro livelli di autenticazione fissi. Le combinazioni di fattori di autenticazione che soddisfano ogni livello sono fisse e non è possibile modificarle. Puoi personalizzare solo il nome URI di ogni livello per il tuo pool di utenti. Per ulteriori informazioni, consulta Configurazione dei nomi dei livelli ACR.
Amazon Cognito assegna il livello di autenticazione più elevato che i fattori completati dell'utente soddisfano pienamente.
| Livello ACR | Valore ACR predefinito | Combinazioni di fattori soddisfacenti |
|---|---|---|
| 1 | urn:cognito:loa:1 |
Solo password |
| 2 | urn:cognito:loa:2 |
Un'unica password monouso inviata tramite SMS o e-mail. Il livello 2 non include le password |
| 3 | urn:cognito:loa:3 |
Una passkey (piattaforma o roaming) a sé stante; o una password con un codice monouso SMS; o una password con un codice monouso e-mail |
| 4 | urn:cognito:loa:4 |
Una password con una password monouso basata sul tempo (TOTP) fornita da un'app di autenticazione |
Il livello 1 rappresenta l'autenticazione tramite sola password. La federazione non soddisfa alcun livello indicato in questa tabella. Invece, Amazon Cognito ricava il livello di autenticazione di un utente federato dalla risposta del provider di identità (IdP). Per ulteriori informazioni, consulta Step-up autenticazione per utenti federati.
Valori AMR
L'amraffermazione è un elenco di stringhe. Ogni fattore di autenticazione completato dall'utente aggiunge il proprio valore all'elenco. Amazon Cognito può aggiungere i seguenti valori.
| Metodo di autenticazione | Valore AMR | Note |
|---|---|---|
| Password | pwd |
Password-family accesso, inclusa Secure Remote Password (SRP) |
| TOTP da un'app di autenticazione | otp |
Una password monouso basata sul tempo fornita da un'app, ad esempio un'app di autenticazione |
| Codice monouso SMS | sms |
Un codice monouso inviato tramite SMS |
| Codice monouso per e-mail | email_otp |
Un codice monouso inviato via e-mail |
| Passkey con un autenticatore di piattaforma | swk |
Una chiave associata al software, ad esempio una passkey protetta da un dispositivo biometrico |
| Passkey con un autenticatore di roaming | hwk |
Una chiave legata all'hardware, ad esempio una chiave di sicurezza |
| Multi-factor combinazione | mfa |
Aggiunto quando l'utente completa due o più fattori distinti |
| Accesso federato | fed |
Un segnaposto predefinito che Amazon Cognito aggiunge quando un utente esegue la federazione tramite un IdP che non supporta ACR e AMR o non restituisce valori riconosciuti da Amazon Cognito |
Dichiarazioni relative ai token ACR e AMR
Amazon Cognito aggiunge acr e amr dichiara di accedere a token e token ID. L'applicazione ispeziona acr e amr dichiara il token di accesso o il token ID per valutare il livello di autenticazione. Quando un utente aggiorna i propri token, Amazon Cognito conserva gli acr stessi valori dei nuovi token di accesso amr e ID, in modo che all'utente non venga chiesto di eseguire nuovamente l'operazione dopo ogni aggiornamento. Per ulteriori informazioni sui contenuti dei token, consulta Utilizzo del token ID e Utilizzo del token di accesso.
L'esempio seguente mostra un token ID dopo che un utente si è autenticato con una password e un TOTP.
{ "sub": "a1b2c3d4-5678-90ab-cdef-1234567890ab", "iss": "https://cognito-idp.us-east-1.amazonaws.com/us-east-1_ExAmPlE", "aud": "abc123def456", "exp": 1759348800, "iat": 1759345200, "auth_time": 1759345200, "token_use": "id", "acr": "urn:cognito:loa:4", "amr": ["pwd", "otp", "mfa"], "email": "user@example.com", "cognito:username": "a1b2c3d4-5678-90ab-cdef-1234567890ab" }
Quando un utente aggiorna i propri token, Amazon Cognito imposta gli acr stessi valori sui nuovi token di accesso amr e ID. I valori vengono trasferiti senza modifiche. Questo comportamento offre un'esperienza più fluida perché agli utenti non viene chiesto di intervenire nuovamente dopo ogni aggiornamento.
L'aggiornamento di un token non reimposta l'attestazione. auth_time Se desideri forzare un utente a eseguire nuovamente l'autenticazione dopo un certo periodo di tempo, utilizza il max_age parametro, che confronta l'ora corrente con quella a auth_time prescindere dal numero di volte in cui l'utente ha aggiornato i token.
Quando un utente completa l'autenticazione avanzata, Amazon Cognito emette nuovi token di accesso, ID e aggiornamento con le dichiarazioni aggiornate acr e amr un nuovo periodo di validità.
Configurazione dei nomi dei livelli ACR
Puoi personalizzare il nome URI di ogni livello di autenticazione per il tuo pool di utenti con il AcrConfiguration campo. Configura questo campo quando crei o aggiorni un pool di utenti con l'UpdateUserPooloperazione CreateUserPoolo. Le combinazioni di fattori che soddisfano ogni livello rimangono fisse. Puoi personalizzare solo i nomi.
La configurazione di nomi di livello ACR personalizzati con il AcrConfiguration campo richiede il piano di funzionalità Essentials o Plus. Per ulteriori informazioni, consulta Requisiti del piano di funzionalità.
Il AcrConfiguration campo è una mappa con i tasti premuti. Level1 Level4 Ogni valore è un oggetto con una singola AcrValue stringa. È possibile sovrascrivere solo i livelli che si desidera personalizzare. La seguente richiesta di esempio personalizza i nomi dei livelli 2 e 3.
{ "AcrConfiguration": { "Level2": { "AcrValue": "urn:my-standard:loa:2" }, "Level3": { "AcrValue": "urn:my-standard:loa:3" } } }
La risposta restituisce sempre la configurazione effettiva, con i nomi predefiniti uniti per tutti i livelli che non hai personalizzato.
{ "AcrConfiguration": { "Level1": { "AcrValue": "urn:cognito:loa:1" }, "Level2": { "AcrValue": "urn:my-standard:loa:2" }, "Level3": { "AcrValue": "urn:my-standard:loa:3" }, "Level4": { "AcrValue": "urn:cognito:loa:4" } } }
Le seguenti regole di convalida si applicano a ciascuno di essi. AcrValue
-
Ciascuno
AcrValuedeve essere unico in tutti e quattro i livelli. Sono inclusi i nomi predefiniti utilizzati per i livelli che non personalizzi. Un valore che non coincide con quello predefinito per un livello non personalizzato viene rifiutato. -
Ciascuna
AcrValueè una stringa da 1 a 64 caratteri. -
Ciascuno di essi non
AcrValuepuò contenere spazi, virgolette doppie o barre rovesciate.
Se modifichi i nomi dei livelli ACR, un utente potrebbe successivamente presentare un token di accesso il cui acr valore non corrisponde più a nessun livello configurato. Amazon Cognito non rispetta il valore obsoleto e lo considera un livello non riconosciuto, ma questo non è un errore. Amazon Cognito rispetta comunque i amr valori del token e richiede solo i fattori che non sono già elencati nella amr dichiarazione, senza accreditare alcun livello particolare.
Requisiti del piano di funzionalità
Le seguenti funzionalità richiedono il piano di funzionalità Essentials o Plus.
-
Richiesta di autenticazione avanzata. Questo vale per il
TARGET_ACR_VALUESparametro onInitiateAuthe ilacr_valuesparametro on managed login. -
Configurazione di nomi di livello ACR personalizzati con il
AcrConfigurationcampo attivo o.CreateUserPoolUpdateUserPool
Il comportamento quando si richiede l'autenticazione avanzata con un piano di funzionalità insufficiente dipende dal punto di ingresso.
-
L'
InitiateAuthAPI restituisce un.FeatureUnavailableInTierException -
L'endpoint di autorizzazione all'accesso gestito ignora silenziosamente
acr_valuese procede con la normale autenticazione, senza errori.
Per ulteriori informazioni sui piani di funzionalità, consulta. Piani di funzionalità del pool di utenti
Le tue responsabilità in materia di autenticazione avanzata
Amazon Cognito emette token con il livello di autenticazione raggiunto dall'utente. L'applicazione è responsabile di quanto segue.
-
Controlla il token ID corrente dell'utente prima di reindirizzare. Valuta
auth_timein base al tuomax_ageacrlivello e a quello del token ID rispetto al livello richiesto dall'operazione, con i token già presenti nell'applicazione. Reindirizza l'utente ad Amazon Cognito per l'installazione solo se il livello o la freschezza richiesti non sono già stati raggiunti. -
Imposta l'
TARGET_ACR_VALUESo corretto e l'oacr_valuescorretto.MAX_AGEmax_ageAmazon Cognito agisce solo in base a ciò che fornisci. Non deduce il livello o la freschezza che intendi. Se richiedi il livello sbagliato o ometti i parametri, Amazon Cognito non migliora l'utente come previsto. -
Convalida il
acrreclamo nella tua domanda. Dopo che Amazon Cognito ha restituito i token, l'applicazione deve verificare che l'acrattestazione corrisponda al livello richiesto dall'operazione prima di concedere l'accesso. Amazon Cognito emette il token con il livello raggiunto. Far sì che un'operazione richieda un determinato livello è responsabilità dell'applicazione. -
Traduci i livelli di Amazon Cognito in altri standard esterni al token. Amazon Cognito calcola le
amraffermazioniacre a partire dal flusso di autenticazione. Non puoi personalizzare, sovrascrivere, aggiungere o sopprimere queste attestazioni con un trigger Lambda precedente alla generazione del token o con qualsiasi altro trigger Lambda. Se devi tradurre i livelli di Amazon Cognito in un altro standard, come NIST o eIDAS, fallo a livello di applicazione.