Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Niveaux d'authentification avec les réclamations ACR et AMR
Amazon Cognito peut enregistrer le degré d'authentification d'un utilisateur et les méthodes qu'il a utilisées. Vous fournissez un niveau d'authentification cible en tant que saisie lorsqu'un utilisateur se connecte, et Amazon Cognito indique le niveau atteint par l'utilisateur et les méthodes qu'il a utilisées sous forme de réclamations dans les jetons qu'il émet. Ces réclamations s'appliquent à toute connexion, y compris la connexion initiale d'un utilisateur.
Vous demandez un niveau d'authentification avec le acr_values paramètre sur les points de terminaison d'autorisation de connexion et de connexion gérés, ou avec le TARGET_ACR_VALUES paramètre équivalent dans le flux d'USER_AUTHAPI. Les deux acceptent une liste ordonnée de niveaux d'authentification cibles. Vous pouvez ajouter le max_age paramètre facultatif (MAX_AGEdans l'API) pour exiger que l'utilisateur s'authentifie au cours d'une période récente. En réponse à ces informations, Amazon Cognito ajoute deux revendications aux jetons qu'il émet :
-
La
acrréclamation est une chaîne qui indique le niveau d'authentification que l'utilisateur a satisfait, par exempleurn:cognito:loa:3. -
La
amrréclamation est un tableau de chaînes qui indique les méthodes d'authentification utilisées par l'utilisateur, par exemple["pwd", "otp", "mfa"].
Les amr revendications acr et suivent les définitions de la spécification OpenID Connect Core. Amazon Cognito utilise ses propres URI de niveau ACR. Vous pouvez traduire les niveaux d'Amazon Cognito selon les normes requises par votre application.
Step-up l'authentification est un cas d'utilisation courant pour ces réclamations. Dans le cadre de l'authentification renforcée, votre application exige qu'un utilisateur s'authentifie à l'aide d'une méthode plus robuste avant d'effectuer une opération sensible. Pour décider si une demande doit être envoyée, votre application compare le acr niveau et le montant auth_time indiqué dans le jeton d'identification de l'utilisateur par rapport au niveau et à la fraîcheur requis par l'opération, et demande une augmentation uniquement lorsqu'ils ne sont pas déjà atteints. Lorsqu'une étape supplémentaire est nécessaire, redirigez l'utilisateur vers l'autorisation de connexion gérée ou le point de terminaison de connexion avecacr_values, ou appelez le flux d'USER_AUTHAPI avecTARGET_ACR_VALUES. Pour un exemple, consultez le scénario Step-up d'authentification.
Vous pouvez demander l'ACR et l'AMR depuis n'importe quel point d'entrée de connexion Amazon Cognito. Les mécanismes de chaque point d'entrée sont documentés avec ce point d'entrée.
-
Connexion au SDK et à l'API : demandez un niveau cible dans le
USER_AUTHflux avec les paramètresTARGET_ACR_VALUESetMAX_AGE. Pour les paramètres et le comportement d'accélération, voirStep-up authentification avec le flux USER_AUTH. -
Connexion gérée et interface utilisateur hébergée : transmettez les
max_ageparamètresacr_valueset aux points de terminaison d'autorisation et de connexion. Pour plus de détails, consultez le point de terminaison d'autorisation et le point de terminaison de connexion. -
Connexion fédérée : Amazon Cognito déduit les valeurs ACR et AMR d'un utilisateur fédéré à partir de la réponse du fournisseur d'identité (IdP) et les associe au champ.
AcrMappingPour les fournisseurs d'identité OIDC, voirStep-up authentification pour les utilisateurs fédérés.
La demande d'authentification renforcée nécessite le plan de fonctionnalités Essentials ou Plus. Pour plus d’informations, consultez Exigences relatives au plan de fonctionnalités.
Rubriques
Niveaux et méthodes d'authentification
Amazon Cognito évalue les facteurs d'authentification remplis par un utilisateur et exprime le résultat sous la forme d'un niveau d'authentification dans la acr réclamation et d'une liste de méthodes d'authentification dans la réclamation. amr
Niveaux d'authentification ACR
Amazon Cognito définit quatre niveaux d'authentification fixes. Les combinaisons de facteurs d'authentification qui répondent à chaque niveau sont fixes et vous ne pouvez pas les modifier. Vous pouvez uniquement personnaliser le nom d'URI de chaque niveau pour votre groupe d'utilisateurs. Pour plus d’informations, consultez Configuration des noms de niveaux ACR.
Amazon Cognito attribue le niveau d'authentification le plus élevé auquel les facteurs complétés par l'utilisateur satisfont pleinement.
| Niveau ACR | Valeur ACR par défaut | Combinaisons de facteurs satisfaisantes |
|---|---|---|
| 1 | urn:cognito:loa:1 |
Mot de passe uniquement |
| 2 | urn:cognito:loa:2 |
Un seul mot de passe à usage unique envoyé par SMS ou e-mail. Le niveau 2 n'inclut pas les clés d'accès |
| 3 | urn:cognito:loa:3 |
Une clé d'accès (plateforme ou itinérance) à elle seule ; ou un mot de passe avec un code à usage unique envoyé par SMS ; ou un mot de passe avec un code à usage unique envoyé par e-mail |
| 4 | urn:cognito:loa:4 |
Un mot de passe avec un mot de passe à usage unique basé sur le temps (TOTP) provenant d'une application d'authentification |
Le niveau 1 représente l'authentification par mot de passe uniquement. La fédération ne correspond à aucun niveau dans ce tableau. Amazon Cognito calcule plutôt le niveau d'authentification d'un utilisateur fédéré à partir de la réponse du fournisseur d'identité (IdP). Pour plus d’informations, consultez Step-up authentification pour les utilisateurs fédérés.
Valeurs AMR
La amr réclamation est une liste de chaînes. Chaque facteur d'authentification complété par l'utilisateur ajoute sa valeur à la liste. Amazon Cognito peut ajouter les valeurs suivantes.
| Méthode d’authentification | Valeur AMR | Remarques |
|---|---|---|
| Mot de passe | pwd |
Password-family connexion, y compris le mot de passe à distance sécurisé (SRP) |
| TOTP depuis une application d'authentification | otp |
Un mot de passe à usage unique basé sur le temps provenant d'une application telle qu'une application d'authentification |
| Code à usage unique par SMS | sms |
Un code à usage unique envoyé par SMS |
| Code à usage unique par e-mail | email_otp |
Un code à usage unique envoyé par e-mail |
| Clé d'accès avec authentificateur de plateforme | swk |
Une clé liée au logiciel, par exemple une clé d'accès sécurisée par la biométrie d'un appareil |
| Clé d'accès avec authentificateur itinérant | hwk |
Une clé liée au matériel, par exemple une clé de sécurité |
| Multi-factor combinaison | mfa |
Ajouté lorsque l'utilisateur complète deux ou plusieurs facteurs distincts |
| Connexion fédérée | fed |
Espace réservé par défaut ajouté par Amazon Cognito lorsqu'un utilisateur se fédère via un IdP qui ne prend pas en charge l'ACR et l'AMR, ou lorsqu'il ne renvoie aucune valeur reconnue par Amazon Cognito |
Réclamations relatives aux jetons ACR et AMR
Amazon Cognito ajoute les jetons d'accès acr et les jetons d'identification et amr prétend les autoriser. Votre application inspecte acr et amr revendique le jeton d'accès ou le jeton d'identification pour évaluer le niveau d'authentification. Lorsqu'un utilisateur actualise ses jetons, Amazon Cognito les conserve, amr ainsi que les valeurs acr des nouveaux jetons d'accès et d'identification, de sorte que l'utilisateur n'est pas invité à passer à la vitesse supérieure après chaque actualisation. Pour plus d'informations sur le contenu du jeton, consultez les sections Utilisation du jeton d'identification et Utilisation du jeton d'accès.
L'exemple suivant montre un jeton d'identification après qu'un utilisateur s'est authentifié à l'aide d'un mot de passe et d'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" }
Lorsqu'un utilisateur actualise ses jetons, Amazon Cognito définit les acr mêmes amr valeurs pour les nouveaux jetons d'accès et d'identification. Les valeurs sont reportées sans modification. Ce comportement permet une expérience plus fluide car les utilisateurs ne sont pas invités à passer à la vitesse supérieure après chaque actualisation.
L'actualisation d'un jeton ne réinitialise pas la auth_time réclamation. Si vous souhaitez forcer un utilisateur à s'authentifier à nouveau après un certain temps, utilisez le max_age paramètre, qui compare l'heure actuelle au nombre de auth_time fois où l'utilisateur a actualisé ses jetons.
Lorsqu'un utilisateur effectue l'authentification renforcée, Amazon Cognito émet de nouveaux jetons d'accès, d'identification et d'actualisation avec les acr mises à jour, les demandes amr et une nouvelle période de validité.
Configuration des noms de niveaux ACR
Vous pouvez personnaliser le nom d'URI de chaque niveau d'authentification pour votre groupe d'utilisateurs à l'aide du AcrConfiguration champ. Configurez ce champ lorsque vous créez ou mettez à jour un groupe d'utilisateurs avec l'UpdateUserPoolopération CreateUserPoolor. Les combinaisons de facteurs qui répondent à chaque niveau restent fixes. Vous personnalisez uniquement les noms.
La configuration de noms de niveau ACR personnalisés avec le AcrConfiguration champ nécessite le plan de fonctionnalités Essentials ou Plus. Pour plus d’informations, consultez Exigences relatives au plan de fonctionnalités.
Le AcrConfiguration champ est une carte avec les touches Level1 traverséesLevel4. Chaque valeur est un objet avec une seule AcrValue chaîne. Vous ne pouvez remplacer que les niveaux que vous souhaitez personnaliser. L'exemple de demande suivant personnalise les noms des niveaux 2 et 3.
{ "AcrConfiguration": { "Level2": { "AcrValue": "urn:my-standard:loa:2" }, "Level3": { "AcrValue": "urn:my-standard:loa:3" } } }
La réponse renvoie toujours la configuration effective, avec les noms par défaut fusionnés pour tous les niveaux que vous n'avez pas personnalisés.
{ "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" } } }
Les règles de validation suivantes s'appliquent à chacune d'entre ellesAcrValue.
-
Chacun
AcrValuedoit être unique dans les quatre niveaux. Cela inclut les noms par défaut qui renvoient aux niveaux que vous ne personnalisez pas. Une valeur qui entre en collision avec la valeur par défaut d'un niveau non personnalisé est rejetée. -
Chacune
AcrValueest une chaîne de 1 à 64 caractères. -
Chacune ne
AcrValuepeut pas contenir d'espaces, de guillemets doubles ou de barres obliques inversées.
Si vous modifiez les noms de vos niveaux ACR, un utilisateur peut présenter ultérieurement un jeton d'accès dont acr la valeur ne correspond plus à aucun niveau configuré. Amazon Cognito ne respecte pas la valeur périmée et la considère comme un niveau non reconnu, mais il ne s'agit pas d'une erreur. Amazon Cognito respecte toujours les amr valeurs du jeton et ne demande que les facteurs qui ne figurent pas déjà dans la amr réclamation, sans attribuer de niveau en particulier.
Exigences relatives au plan de fonctionnalités
Les fonctionnalités suivantes nécessitent le plan de fonctionnalités Essentials ou Plus.
-
Demande d'authentification renforcée. Cela s'applique au
TARGET_ACR_VALUESparamètre activéInitiateAuthet auacr_valuesparamètre relatif à la connexion gérée. -
Configuration de noms de niveaux ACR personnalisés avec le
AcrConfigurationchamp surCreateUserPoolouUpdateUserPool.
Le comportement lorsque vous demandez une authentification renforcée pour un plan de fonctionnalités insuffisant dépend du point d'entrée.
-
L'
InitiateAuthAPI renvoie unFeatureUnavailableInTierException. -
Le point de terminaison d'autorisation de connexion géré ignore silencieusement
acr_valueset procède à l'authentification normale, sans erreur.
Pour plus d'informations sur les plans de fonctionnalités, consultezForfait de fonctionnalités pour le groupe d’utilisateurs.
Vos responsabilités en matière d'authentification renforcée
Amazon Cognito émet des jetons avec le niveau d'authentification atteint par l'utilisateur. Votre application est responsable de ce qui suit.
-
Vérifiez le jeton d'identification actuel de l'utilisateur avant de le rediriger. Évaluez par
auth_timerapport à votremax_ageacrniveau et à celui du jeton d'identification par rapport au niveau requis par l'opération, avec les jetons déjà détenus par votre application. Redirigez l'utilisateur vers Amazon Cognito pour passer à la vitesse supérieure uniquement si le niveau ou la fraîcheur requis ne sont pas déjà atteints. -
Définissez le bon
TARGET_ACR_VALUESouacr_values, et le bonMAX_AGEoumax_age. Amazon Cognito agit uniquement sur la base de ce que vous fournissez. Cela ne permet pas de déduire le niveau ou la fraîcheur que vous souhaitez. Si vous demandez le mauvais niveau ou si vous omettez les paramètres, Amazon Cognito n'augmente pas le niveau d'utilisateur comme vous le souhaitiez. -
Validez la
acrréclamation dans votre demande. Une fois qu'Amazon Cognito a renvoyé des jetons, votre application doit vérifier que laacrréclamation correspond au niveau requis par l'opération avant d'autoriser l'accès. Amazon Cognito émet le jeton avec le niveau atteint. Il incombe à votre application de faire en sorte qu'une opération nécessite un niveau donné. -
Translate les niveaux d'Amazon Cognito selon d'autres normes autres que le jeton. Amazon Cognito calcule les
amrdemandesacret à partir du flux d'authentification. Vous ne pouvez pas personnaliser, annuler, ajouter ou supprimer ces revendications à l'aide d'un déclencheur Lambda antérieur à la génération de jetons ou de tout autre déclencheur Lambda. Si vous devez traduire les niveaux d'Amazon Cognito vers une autre norme, telle que le NIST ou eIDAS, faites-le dans votre couche d'application.