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.
Comprendre le jeton d'identité (ID)
Le jeton d'identification est un jeton JWT (JSON Web Token)name, email et phone_number. Vous pouvez utiliser ces informations d'identité dans votre application. Le jeton d'identification peut aussi servir à authentifier des utilisateurs auprès de vos serveurs de ressources ou applications de serveur. Vous pouvez également utiliser un jeton d'identification en dehors de l'application avec vos opérations d'API web. Dans ce cas, vous devez vérifier la signature du jeton d'identification avant de pouvoir approuver les revendications qu'il contient. Consultez Vérification des jetons Web JSON.
Vous pouvez définir l'expiration d'un jeton d'identification sur toute valeur comprise entre 5 minutes et 1 jour. Vous pouvez définir cette valeur par client d'application.
Le jeton d'identification inclut les amr revendications acr et, qui décrivent le niveau d'authentification satisfait par l'utilisateur et les méthodes qu'il a utilisées. Pour plus d’informations, consultez Réclamations relatives aux jetons ACR et AMR.
Lorsque votre utilisateur se connecte avec un identifiant géré, Amazon Cognito définit des cookies de session valides pendant 1 heure. Si vous utilisez la connexion gérée pour l'authentification dans votre application et que vous spécifiez une durée minimale de moins d'une heure pour votre accès et vos jetons d'identification, vos utilisateurs auront toujours une session valide jusqu'à l'expiration du cookie. Si l'utilisateur a des jetons qui expirent pendant la session d'une heure, l'utilisateur peut actualiser ses jetons sans avoir besoin de se réauthentifier.
en-tête du jeton d'identification
L'en-tête contient deux éléments d'information : l'ID de clé (kid) et l'algorithme (alg).
{ "kid" : "1234example=", "alg" : "RS256" }
kid-
ID de la clé . Sa valeur indique quelle clé a été utilisée pour sécuriser la signature web JSON (JWS) du jeton. Vous pouvez consulter les identifiants de clé de signature de votre groupe d'utilisateurs sur le point de terminaison
jwks_uri.Pour plus d'informations sur le paramètre
kid, consultez Paramètre d'en-tête Key identifier (kid). alg-
Algorithme de chiffrement utilisé par Amazon Cognito pour sécuriser le jeton d'accès. Les groupes d'utilisateurs utilisent un algorithme cryptographique RS256, qui est une signature RSA avec. SHA-256
Pour plus d'informations sur le paramètre
alg, consultez Paramètre d'en-tête Algorithme (alg).
Charge utile par défaut du jeton d'identification
Il s'agit d'un exemple de charge utile provenant d'un jeton d'identification. Il contient les demandes sur l'utilisateur authentifié. Pour plus d'informations sur les revendications standard OpenID Connect (OIDC), consultez la liste des revendications standard OIDC
Cette charge utile est représentative et non exhaustive. L'ensemble des réclamations contenues dans un jeton d'identification Amazon Cognito augmente au fil du temps à mesure que de nouvelles fonctionnalités ajoutent de nouvelles réclamations. Les allégations associées à vos jetons peuvent donc différer de celles contenues dans cet exemple. Traitez cet exemple comme un instantané des revendications courantes plutôt que comme une liste complète et fixe, et lisez-le Comment analyser ce jeton en toute sécurité avant d'écrire le code qui analyse les jetons Amazon Cognito.
<header>.{ "sub": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee", "cognito:groups": [ "test-group-a", "test-group-b", "test-group-c" ], "email_verified": true, "cognito:preferred_role": "arn:aws:iam::111122223333:role/my-test-role", "iss": "https://cognito-idp.us-west-2.amazonaws.com/us-west-2_example", "cognito:username": "my-test-user", "middle_name": "Jane", "nonce": "abcdefg", "origin_jti": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee", "cognito:roles": [ "arn:aws:iam::111122223333:role/my-test-role" ], "aud": "xxxxxxxxxxxxexample", "identities": [ { "userId": "amzn1.account.EXAMPLE", "providerName": "LoginWithAmazon", "providerType": "LoginWithAmazon", "issuer": null, "primary": "true", "dateCreated": "1642699117273" } ], "event_id": "64f513be-32db-42b0-b78e-b02127b4f463", "token_use": "id", "auth_time": 1676312777, "exp": 1676316377, "iat": 1676312777, "jti": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee", "email": "my-test-user@example.com" } .<token signature>
sub-
Identifiant unique (UUID), ou sujet, pour l'utilisateur authentifié. Le nom d'utilisateur n'est peut-être pas unique dans votre groupe d'utilisateurs. Le champ standard
subest le meilleur moyen d'identifier un utilisateur donné.ImportantAmazon Cognito génère des données
subdans un Cognito-specific format Amazon qui n'est pas conforme à un format UUID spécifique, y compris l'UUID RFC. Vous ne devez pas valider strictement le format desub. Plus généralement, comme décrit dans le guide sur l'analyse sécurisée des demandes de jetons, interprétez chaque réclamation comme le type documenté sur cette page et n'imposez pas de format plus strict que celui indiqué dans la documentation. cognito:groups-
Tableau de chaînes. Chaque chaîne est le nom d'un groupe d'utilisateurs dont votre utilisateur est membre. Les groupes peuvent être un identifiant que vous présentez à votre application ou ils peuvent générer une demande pour un rôle IAM préféré à partir d'une réserve d'identités. Cette réclamation est toujours un tableau, même lorsque l'utilisateur appartient à un seul groupe.
cognito:preferred_role-
ARN du rôle IAM que vous avez associé au groupe de groupes d'utilisateurs de plus haute priorité de l'utilisateur. Pour plus d'informations sur la manière dont votre groupe d'utilisateurs sélectionne la demande de rôle, consultezAffectation de valeurs de priorité à des groupes.
iss-
Une seule chaîne. Émetteur du jeton. Cette réclamation identifie le groupe d'utilisateurs qui a généré le jeton. Votre application doit vérifier que cette valeur correspond à l'URL de l'émetteur attendu par votre groupe d'utilisateurs. Le champ standard a le format suivant :
https://cognito-idp.<Region>.amazonaws.com/<your user pool ID>Votre groupe d'utilisateurs peut utiliser un émetteur original ou mis à jour. Les émetteurs mis à jour hébergent le même contenu JWKS dans plusieurs régions, ce qui améliore la résilience et l’efficacité. Pour plus d’informations, consultez Groupes d'utilisateurs Amazon Cognito en tant qu'émetteur OIDC.
cognito:username-
Nom d'utilisateur de l'utilisateur dans votre groupe d'utilisateurs.
nonce-
La revendication
nonceprovient d'un paramètre du même nom que vous pouvez ajouter aux requêtes de votre point de terminaisonauthorizeOAuth 2.0. Lorsque vous ajoutez le paramètre, la revendicationnonceest incluse dans le jeton d'identification émis par Amazon Cognito, et vous pouvez l'utiliser pour vous protéger contre les attaques de relecture. Si vous ne fournissez pas de valeurnoncedans votre demande, Amazon Cognito génère et valide automatiquement un nonce lorsque vous vous authentifiez via un fournisseur d'identité tiers, puis l'ajoute en tant que réclamationnonceau jeton d'identification. L'implémentation de la revendicationnoncedans Amazon Cognito est basée sur les normes OIDC. origin_jti-
Un identifiant de révocation de jeton associé au jeton d'actualisation de votre utilisateur. Amazon Cognito fait référence à la
origin_jtiréclamation lorsqu'il vérifie si vous avez révoqué le jeton de votre utilisateur lors de l'opération Point de terminaison de révocation ou de l'RevokeTokenAPI. Lorsque vous révoquez un jeton, Amazon Cognito invalide tous les jetons d'accès et d'identification ayant la même valeurorigin_jti. cognito:roles-
Tableau de chaînes. Chaque chaîne est l'ARN d'un rôle IAM associé à l'un des groupes de vos utilisateurs. Un rôle IAM peut être associé à chaque groupe de groupes d'utilisateurs. Ce tableau représente tous les rôles IAM pour les groupes de vos utilisateurs, quelle que soit leur priorité, et il s'agit toujours d'un tableau, même s'il ne contient qu'un seul rôle. Pour plus d’informations, consultez Ajout de groupes à un groupe d'utilisateurs.
aud-
Une seule chaîne. Client d'application du groupe d'utilisateurs qui a authentifié l'utilisateur. Amazon Cognito affiche la même valeur dans le champ standard
client_iddu jeton d'accès. identities-
Tableau d’objets . Chaque objet décrit un profil de fournisseur d'identité tiers que vous avez lié à l'utilisateur, soit par connexion fédérée, soit en liant un utilisateur fédéré à un profil local. Chaque objet contient les champs
userId(l'identifiant unique de l'utilisateur chez le fournisseur)providerName,providerType,issuer,primary, etdateCreated. Tous ces champs sont des chaînes, avec deux détails de sérialisation à analyser avec soin : s'primaryagit-il d'une chaîne"true"ou non d'un booléen JSON"false", etdateCreatedd'une chaîne contenant l'heure Unix en millisecondes (par exemple), et non d'un nombre."1642699117273"Leissuerterrain peut l'êtrenull. Cette réclamation prend toujours la forme d'un tableau, même lorsque l'utilisateur possède une identité liée. token_use-
Objectif prévu du jeton. Dans un jeton d'identification, sa valeur est
id. auth_time-
Nombre . Heure d'authentification, au format Unix, à laquelle votre utilisateur a terminé l'authentification.
exp-
Nombre . Date d'expiration, au format Unix, à laquelle le jeton de votre utilisateur expire.
iat-
Nombre . Heure d'émission, au format Unix, à laquelle Amazon Cognito a émis le jeton de votre utilisateur.
jti-
Identifiant unique du jeton JWT.
email-
Une seule chaîne. L'adresse e-mail de votre utilisateur, lorsque l'
emailattribut est présent et lisible par le client de l'application.
Le jeton d'identification peut contenir des revendications standard OIDC définies dans les Revendications standard OIDC
Les attributs personnalisés du groupe d'utilisateurs sont toujours préfixés parcustom:.
Comment analyser ce jeton en toute sécurité
La réclamation définie dans un jeton d'identification Amazon Cognito n'est pas corrigée. Les allégations portées par un jeton varient en fonction du flux d'authentification, de l'appartenance au groupe de l'utilisateur et du fournisseur d'identité. Ils dépendent également des fonctionnalités activées sur votre groupe d'utilisateurs. La spécification OpenID Connect n'exige queiss,,, et sub aud expiat, et ceux-ci sont présents dans chaque jeton d'identification Amazon Cognito. Amazon Cognito ajoute token_use également toujours la valeurid, que vous devez vérifier pour confirmer que vous avez reçu un jeton d'identification plutôt qu'un jeton d'accès. Traitez toutes les autres demandes comme facultatives et conditionnelles à la manière dont l'utilisateur s'est authentifié.
Le jeton d'identification est l'un des nombreux types de jetons Amazon Cognito, et les mêmes règles d'analyse s'appliquent à tous. Pour plus d'informations sur l'analyse sécurisée des jetons, consultezAnalyser les jetons du pool d'utilisateurs en toute sécurité.
Exemples de jetons d'identification par scénario
Il Charge utile par défaut du jeton d'identification combine de nombreuses revendications facultatives en un seul exemple. Dans la pratique, les allégations associées à un jeton dépendent de la manière dont l'utilisateur s'est connecté. Les exemples suivants présentent les combinaisons de demandes émises par Amazon Cognito pour quatre scénarios courants. Chaque exemple est une charge utile décodée, et non un JWT signé et sérialisé : un véritable jeton est header.payload.signature codé en base64url et avec la clé de votre groupe d'utilisateurs. RS256-signed Les valeurssub, l'ID du groupe d'utilisateurs et l'horodatage sont des espaces réservés illustratifs.
Jeton d'identification du code d'autorisation de base
Le jeton d'identité que la plupart des applications consomment après avoir échangé un code d'autorisation au point de terminaison du jeton. La token_use valeur de le id distingue d'un jeton d'accès. La nonce réclamation est présente parce que le client a envoyé un nonce paramètre dans la demande d'autorisation pour empêcher les attaques par rediffusion.
{ "sub": "a1b2c3d4-5678-90ab-cdef-1234567890ab", "iss": "https://cognito-idp.us-east-1.amazonaws.com/us-east-1_ExAmPlE", "aud": "6o7h8i9jexampleclientid", "cognito:username": "my-test-user", "email": "my-test-user@example.com", "email_verified": true, "origin_jti": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee", "token_use": "id", "auth_time": 1759345200, "iat": 1759345200, "exp": 1759348800, "jti": "11112222-3333-4444-5555-666677778888", "nonce": "n-0S6_WzA2Mj" }
Appartenance aux groupes et aux rôles
Amazon Cognito ajoute les demandes d'autorisation de groupe et de rôle lorsque l'utilisateur appartient à un ou plusieurs groupes de groupes d'utilisateurs. Les cognito:roles revendications cognito:groups et sont des tableaux ; lisez-les comme des tableaux même s'ils contiennent un seul élément. cognito:preferred_roleest une chaîne unique.
{ "sub": "a1b2c3d4-5678-90ab-cdef-1234567890ab", "iss": "https://cognito-idp.us-east-1.amazonaws.com/us-east-1_ExAmPlE", "aud": "6o7h8i9jexampleclientid", "cognito:username": "my-test-user", "cognito:groups": ["admins", "beta-testers"], "cognito:roles": ["arn:aws:iam::111122223333:role/my-test-role"], "cognito:preferred_role": "arn:aws:iam::111122223333:role/my-test-role", "origin_jti": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee", "token_use": "id", "auth_time": 1759345200, "iat": 1759345200, "exp": 1759348800, "jti": "11112222-3333-4444-5555-666677778888" }
Connexion fédérée
Un utilisateur qui s'est connecté via un fournisseur d'identité externe, tel qu'un réseau social ou un SAML/OIDC fournisseur, est titulaire de la identities réclamation, qui décrit le lien du fournisseur externe.
{ "sub": "a1b2c3d4-5678-90ab-cdef-1234567890ab", "iss": "https://cognito-idp.us-east-1.amazonaws.com/us-east-1_ExAmPlE", "aud": "6o7h8i9jexampleclientid", "cognito:username": "LoginWithAmazon_amzn1.account.EXAMPLE", "identities": [ { "userId": "amzn1.account.EXAMPLE", "providerName": "LoginWithAmazon", "providerType": "LoginWithAmazon", "issuer": null, "primary": "true", "dateCreated": "1642699117273" } ], "origin_jti": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee", "token_use": "id", "auth_time": 1759345200, "iat": 1759345200, "exp": 1759348800, "jti": "11112222-3333-4444-5555-666677778888" }
À l'intérieur de chaque identities objet, primary et dateCreated sont sérialisés sous forme de chaînes ("true"et"1642699117273"), et non sous forme de booléen et de nombre JSON. Une comparaison telle que celle qui aboutit à une évaluation identity.primary === true silencieuse donne la valeur fausse. Lisez primary sous la forme de la chaîne "true" ou"false", et dateCreated sous la forme d'une chaîne contenant le temps Unix en millisecondes.
Force d'authentification (ACR et AMR)
Lorsque votre groupe d'utilisateurs indique le niveau d'authentification atteint par l'utilisateur, Amazon Cognito ajoute les revendications acr etamr. Le jeton suivant provient d'un utilisateur qui s'est authentifié à l'aide d'un mot de passe et d'un TOTP provenant d'une application d'authentification, qui est le niveau le plus élevé. Chaque jeton contient exactement l'un des acr niveaux possibles. Pour l'ensemble fixe de niveaux, les combinaisons de facteurs qui répondent à chacun d'entre eux et la liste complète des amr valeurs, voirNiveaux d'authentification avec les réclamations ACR et AMR.
{ "sub": "a1b2c3d4-5678-90ab-cdef-1234567890ab", "iss": "https://cognito-idp.us-east-1.amazonaws.com/us-east-1_ExAmPlE", "aud": "6o7h8i9jexampleclientid", "cognito:username": "my-test-user", "acr": "urn:cognito:loa:4", "amr": ["pwd", "otp", "mfa"], "origin_jti": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee", "token_use": "id", "auth_time": 1759345200, "iat": 1759345200, "exp": 1759348800, "jti": "11112222-3333-4444-5555-666677778888" }
La demande d'un niveau d'authentification nécessite le plan de fonctionnalités Essentials ou Plus. Les amr demandes acr et sont calculées par Amazon Cognito et ne peuvent pas être modifiées par un déclencheur Lambda antérieur à la génération du jeton. La traduction des niveaux d'Amazon Cognito vers une autre norme, telle que le NIST ou eIDAS, relève de la responsabilité de votre application.
Signature du jeton d'identification
La signature du jeton d'identification est calculée en fonction de l'en-tête et de la charge utile du jeton JWT. Avant d'accepter les champs standard figurant dans un jeton d'identification reçu par votre application, vérifiez la signature du jeton. Pour plus d'informations, consultez la section Vérification d'un jeton Web JSON. Vérification des jetons Web JSON.