View a markdown version of this page

Configuration d'une fédération d'identité entre partitions - 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.

Configuration d'une fédération d'identité entre partitions

Cross-partition la fédération d'identités fonctionne comme un échange en deux étapes : vos appels de charge de travail sts:GetWebIdentityToken pour obtenir un JWT auprès de AWS STS dans la partition source, puis échange ce jeton contre des informations d'identification temporaires provenant de AWS STS dans la partition de destination en appelant sts:AssumeRoleWithWebIdentity.

L'établissement de ce flux implique une phase de configuration unique et une phase d'exécution qui se répète chaque fois que la charge de travail nécessite des informations d'identification dans la partition de destination. Cette page explique comment configurer les comptes source et de destination.

Phase de configuration

  1. Dans la partition source, activez la fédération d'identité sortante pour votre compte. Pour obtenir des instructions, consultez Activez la fédération des identités sortantes pour votre compte.

  2. Dans la partition source, créez un principal IAM ou choisissez-en un existant et accordez-lui l'autorisation d'appeler sts:GetWebIdentityToken. Utilisez les conditions de la politique IAM pour restreindre les audiences autorisées, la durée des jetons et les algorithmes de signature. Pour obtenir des instructions, consultez Contrôler l'accès à l'aide de politiques IAM.

  3. Dans la partition de destination, créez un fournisseur d'identité OpenID Connect (OIDC) à l'aide de l'URL de l'émetteur du compte source. Assurez-vous que la liste d'identification des clients du fournisseur inclut le public auquel votre charge de travail sera destinée GetWebIdentityToken. Pour obtenir des instructions, consultez Création d’un fournisseur d’identité OpenID Connect (OIDC) dans IAM.

  4. Dans la partition de destination, créez un rôle IAM ou choisissez-en un existant que le principal IAM source devra assumer. Configurez la politique de confiance du rôle pour qu'elle fasse confiance au fournisseur d'identité OIDC que vous avez créé et que vous autorisez sts:AssumeRoleWithWebIdentity. Pour obtenir des instructions, consultez Qui peut assumer un rôle.

Phase d'exécution

  1. À l'aide des informations d'identification du principal IAM dans la partition source, appelez ensembles :GetWebIdentityToken avec l'audience que vous avez configurée dans le fournisseur d'identité OIDC du compte de destination.

    Note

    Pour la fédération d'identité entre partitions, spécifiez exactement un public lors de l'appel GetWebIdentityToken. Les jetons demandés auprès de plusieurs publics ne peuvent pas être échangés contre des informations d'identification temporaires à l'aide AssumeRoleWithWebIdentity.

  2. AWS STS dans la partition source renvoie un JWT de courte durée qui représente l'identité du principal IAM source.

  3. Appel ensembles :AssumeRoleWithWebIdentity sur le AWS STS point de terminaison dans la partition de destination, en transmettant le JWT, l'ARN du rôle de destination que vous avez configuré lors de l'installation et un nom de session de rôle (RoleSessionName).

  4. AWS STS dans la partition de destination valide le JWT et évalue la politique de confiance du rôle de destination. Si la demande est acceptée, AWS STS renvoie des informations d'identification temporaires pour ce rôle.

  5. Utilisez les informations d'identification temporaires pour accéder AWS ressources ou communiquez avec un AWS service dans la partition de destination.

Les suivants AWS L'exemple CLI montre la phase d'exécution, en utilisant us-east-1 dans le aws partitionner en tant que région source et cn-north-1 dans le aws-cn partition en tant que région de destination. Utiliser les informations d'identification pour que le principal IAM source puisse appeler GetWebIdentityToken. Le AssumeRoleWithWebIdentity l'appel s'authentifie à l'aide du JWT renvoyé par GetWebIdentityToken et ne nécessite pas AWS informations d'identification.

# Source partition (aws): get a short-lived JWT TOKEN=$(aws sts get-web-identity-token \ --region us-east-1 \ --endpoint-url https://sts.us-east-1.amazonaws.com \ --audience "your-audience" \ --signing-algorithm ES384 \ --duration-seconds 300 \ --query WebIdentityToken --output text) # Destination partition (aws-cn): exchange it for temporary credentials aws sts assume-role-with-web-identity \ --region cn-north-1 \ --role-arn arn:aws-cn:iam::111122223333:role/DestinationWorkloadRole \ --role-session-name cross-partition-session \ --web-identity-token "$TOKEN" \ --no-sign-request

L'exemple suivant montre le même flux à l'aide du AWS SDK pour Python (Boto3).

import boto3 from botocore import UNSIGNED from botocore.config import Config # Source partition (aws): get a short-lived JWT from the Regional STS endpoint source_sts = boto3.client( 'sts', region_name='us-east-1', endpoint_url='https://sts.us-east-1.amazonaws.com' ) token = source_sts.get_web_identity_token( Audience=['your-audience'], SigningAlgorithm='ES384', DurationSeconds=300 )['WebIdentityToken'] # Destination partition (aws-cn): exchange it for temporary credentials. # AssumeRoleWithWebIdentity doesn't require AWS credentials. destination_sts = boto3.client( 'sts', region_name='cn-north-1', config=Config(signature_version=UNSIGNED) ) credentials = destination_sts.assume_role_with_web_identity( RoleArn='arn:aws-cn:iam::111122223333:role/DestinationWorkloadRole', RoleSessionName='cross-partition-session', WebIdentityToken=token )['Credentials']