View a markdown version of this page

Comprendre les revendications relatives aux jetons - AWS Gestion de l’identité et des accès

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 les revendications relatives aux jetons

Lorsque vous appelez le GetWebIdentityToken API, AWS Security Token Service renvoie un jeton Web JSON (JWT) signé qui contient un ensemble de revendications représentant l'identité du principal IAM. Ces jetons sont conformes à RFC 7519. Comprendre la structure et le contenu de ces jetons vous permet de mettre en œuvre des flux d'authentification sécurisés, de configurer des validations de revendications appropriées dans des services externes et d'utiliser efficacement des revendications personnalisées pour un contrôle d'accès précis.

Le JWT inclut des déclarations OpenID Connect (OIDC) standard telles que sujet (« sub »), audience (« aud »), émetteur (« iss ») afin de faciliter l'interopérabilité entre différents services externes. AWS STS remplit le jeton avec AWS les allégations spécifiques à l'identité (comme le AWS Identifiant du compte et balises principales) et déclarations relatives au contexte de session (comme les ARN des instances EC2), le cas échéant. Vous pouvez également ajouter des revendications personnalisées au jeton en les transmettant sous forme de balises de demande au GetWebIdentityToken API. Le AWS les revendications spécifiques à l'identité, les revendications contextuelles de session et les revendications personnalisées sont imbriquées sous le »https://sts.amazonaws.com/« espace de noms » dans le jeton.

Reportez-vous à l'exemple de jeton ci-dessous pour obtenir la liste des réclamations incluses dans le jeton. Veuillez noter que toutes ces revendications peuvent ne pas figurer simultanément dans un jeton.

{ "iss": "https://abc123-def456-ghi789-jkl012.tokens.sts.global.api.aws", "aud": "https://api.example.com", "sub": "arn:aws:iam::123456789012:role/DataProcessingRole", "iat": 1700000000, "exp": 1700000900, "jti": "xyz123-def456-ghi789-jkl012", "https://sts.amazonaws.com/": { "aws_account": "123456789012", "source_region": "us-east-1", "principal_id": "arn:aws:iam::123456789012:role/DataProcessingRole", "org_id": "o-abc1234567", "ou_path": [ "o-a1b2c3d4e5/r-ab12/ou-ab12-11111111/ou-ab12-22222222/" ], "principal_tags": { "environment": "production", "team": "data-engineering", "cost-center": "engineering" }, "lambda_source_function_arn": "arn:aws:lambda:us-east-1:123456789012:function:process-data", "request_tags": { "job-id": "job-2024-001", "priority": "high", "data-classification": "sensitive" } } }

Réclamations standard

Les revendications OIDC standard présentes dans les jetons facilitent l'interopérabilité avec un large éventail de services externes. Ces affirmations peuvent être validées à l'aide de la plupart des bibliothèques JWT.

Demander Nom Description Exemple de valeur
bise Emetteur URL de l'émetteur spécifique à votre compte. Des services externes valident cette affirmation pour s'assurer qu'elle correspond à leur émetteur de confiance. https://abc123-def456-ghi789-jkl012.tokens.sts.global.api.aws
aud Public ciblé Le destinataire prévu pour le jeton spécifié dans le GetWebIdentityToken demande. https://api.example.com
sub Sujet L'ARN du principal IAM qui a demandé le jeton. arn:aws:iam : :123456789012 :role/DataProcessingRole
iat Publié à NumericDate valeur qui identifie l'heure à laquelle le JWT a été émis. 1700000000
exp Expiration NumericDate valeur qui identifie le délai d'expiration à partir duquel le JWT NE DOIT PAS être accepté pour traitement. 1700000900
jti IDENTIFIANT JET Identifiant unique pour cette instance de jeton. xyz123-def456-ghi789-jkl012

Réclamations personnalisées

Outre les allégations standard de l'OIDC, AWS STS ajoute des déclarations concernant l'identité et le contexte de session, le cas échéant. Vous pouvez également ajouter vos propres revendications au jeton en les transmettant sous forme de balises de demande. Les revendications personnalisées sont imbriquées dans https://sts.amazonaws.com/ espace de noms.

Les clés de condition figurant dans les tableaux suivants identifient le contexte de demande source utilisé pour remplir les revendications. Pour les clés de condition utilisées dans l'hypothèse de rôles entre partitions et leur disponibilité dans la session de destination, consultez le AWS STS onglet sous Clés disponibles pour AWS Fédération OIDC.

AWS demandes d'identité

Ces réclamations fournissent des informations détaillées sur votre AWS compte, structure de l'organisation et responsable IAM.

Demander Description Clé de condition source Exemple de valeur
compte_aws Votre AWS ID de compte aws :PrincipalAccount 123456789012
source_region Le AWS région où le jeton a été demandé aws :RequestedRegion us-east-1
identifiant_principal L'ARN du principal IAM qui a demandé le jeton. aws :PrincipalArn arn:aws:iam : :123456789012 :role/DataProcessingRole
id_org Votre AWS Identifiant de l'organisation (si votre compte fait partie d'une organisation) aws :PrincipalOrgIDENTIFIANT o-abc1234567
ou_path Le AWS Chemins d'organisation pour le compte source, sous forme de tableau. Présent lorsque les chemins d'organisation sont disponibles dans le contexte de la demande source. aws :PrincipalOrgPaths [« ou...a1b2c3d4e5/r-ab12/ou-ab12-11111111/ou-ab12-22222222/ "]
tags_principaux Tags attachés à la session IAM principale ou à la session de rôle assumé. Lorsqu'un jeton est demandé alors que le principal IAM demandeur possède à la fois des balises principales et des balises de session, les balises de session seront présentes dans le JWT. aws :PrincipalTag/<tag-key> {"environnement » : « production », « équipe » : « ingénierie des données », « centre de coûts » :"ingénierie "}

Déclarations relatives au contexte de session

Ces allégations fournissent des informations sur l'environnement informatique et la session d'où provient la demande de jeton. AWS STS inclut automatiquement ces réclamations, le cas échéant, en fonction du contexte de session du principal demandeur.

Demander Description Clé de condition source Exemple de valeur
exp de session d'origine Date à laquelle les informations d'identification de session de rôle d'origine expireront (pour les rôles supposés) N/A 15/01/2024T10:00:00Z
invoqué_par Le AWS service agissant pour le compte du client en assumant le rôle de source, ou le dernier service d'un session d'accès direct. Cette réclamation n'est présente que lorsque la session source inclut l'identité de ce service. N/A ec2.amazonaws.com
mfa_present Indique que le principal IAM s'est authentifié auprès de MFA. Présent uniquement lorsque MFA a été utilisé, avec la valeur de chaîne "true". Ce n'est jamais "false". aws :MultiFactorAuthPresent "true"
mfa_age Nombre de secondes écoulées depuis que le principal IAM s'est authentifié auprès de MFA, sous forme de chaîne. Présent uniquement lorsque le MFA a été utilisé et que l'âge d'authentification est disponible. aws :MultiFactorAuthAge « 1800 »
fournisseur_fédéré Le nom du fournisseur d'identité pour les sessions fédérées aws :FederatedProvider arn:aws:iam : :111122223333:oidc-provider/your_oidc_provider
identity_store_user_id ID utilisateur IAM Identity Center boutique d'identité :UserId utilisateur-abc123def456
identity_store_arn ARN de la boutique d'identités Identity Center boutique d'identité :IdentityStoreArn arn:aws:identity store : :123456789012 :identitystore/d-abc1234567
ec2_source_instance_arn ARN de l'instance EC2 demandeuse EC2 :SourceInstanceArn arn:aws:ec2:us-east- 1:123456789012 :instance/i-abc123def456
ec2_instance_source_vpc ID VPC où les informations d'identification du rôle EC2 ont été fournies aws :Ec2InstanceSourceVpc vpc-abc123def456
ec2_instance_source_privé_ipv4 Adresse IPv4 privée de l'instance EC2 aws :Ec2InstanceSourcePrivateIPv4 10,0.1,25
ec2_role_delivery Version du service de métadonnées d'instance (IMDS) qui a fourni les informations d'identification du rôle source : 1.0 pour IMDSv1 ou 2.0 pour IMDSv2. EC2 :RoleDelivery 2.0
identité_source Identité de source définie par le principal aws :SourceIdentity administrateur-utilisateur
lambda_source_function_arn ARN de la fonction Lambda appelante lambda :SourceFunctionArn arn:aws:lambda:us-east- 1:123456789012:function:my-function
service d'émission d'informations d'identification de la colle AWS Identifiant du service Glue pour les tâches Glue colle :CredentialIssuingService glue.amazonaws.com

Tags de demande

Vous pouvez ajouter des revendications personnalisées aux jetons en spécifiant des balises dans le GetWebIdentityToken Demande d'API. Ces revendications apparaissent dans le champ request_tags du jeton et vous permettent de transmettre des informations spécifiques que les services externes peuvent utiliser pour prendre des décisions d'autorisation précises. Vous pouvez spécifier jusqu'à 50 balises par demande.

Exemple de demande :

response = sts_client.get_web_identity_token( Audience=['https://api.example.com'], SigningAlgorithm='ES384', Tags=[ {'Key': 'team', 'Value': 'data-engineering'}, {'Key': 'cost-center', 'Value': 'analytics'}, {'Key': 'environment', 'Value': 'production'} ] )

Réclamations résultantes sous forme de jeton :

{ "request_tags": { "team": "data-engineering", "cost-center": "analytics", "environment": "production" } }