View a markdown version of this page

Livelli di autenticazione con attestazioni ACR e AMR - Amazon Cognito

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.

La richiesta dell'autenticazione avanzata richiede il piano di funzionalità Essentials o Plus. Per ulteriori informazioni, consulta Requisiti del piano di funzionalità.

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.

Livelli ACR e combinazioni di fattori soddisfacenti
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.

Valori AMR
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 AcrValue deve 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 AcrValue può 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_VALUES parametro on InitiateAuth e il acr_values parametro on managed login.

  • Configurazione di nomi di livello ACR personalizzati con il AcrConfiguration campo attivo o. CreateUserPool UpdateUserPool

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_values e 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_time in base al tuo max_age acr livello 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'o acr_values corretto. MAX_AGE max_age Amazon 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 acr reclamo 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 amr affermazioni acr e 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.