View a markdown version of this page

Niveaux d'authentification avec les réclamations ACR et AMR - Amazon Cognito

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 acr réclamation est une chaîne qui indique le niveau d'authentification que l'utilisateur a satisfait, par exempleurn:cognito:loa:3.

  • La amr ré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_AUTH flux avec les paramètres TARGET_ACR_VALUES etMAX_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_age paramètres acr_values et 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. AcrMapping Pour 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.

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.

Niveaux d'ACR et combinaisons de facteurs satisfaisantes
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.

Valeurs AMR
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 AcrValue doit ê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 AcrValue est une chaîne de 1 à 64 caractères.

  • Chacune ne AcrValue peut 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_VALUES paramètre activé InitiateAuth et au acr_values paramètre relatif à la connexion gérée.

  • Configuration de noms de niveaux ACR personnalisés avec le AcrConfiguration champ sur CreateUserPool ouUpdateUserPool.

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_values et 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_time rapport à votre max_age acr niveau 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_VALUES ouacr_values, et le bon MAX_AGE oumax_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 acr réclamation dans votre demande. Une fois qu'Amazon Cognito a renvoyé des jetons, votre application doit vérifier que la acr ré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 amr demandes acr et à 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.