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.
Commencer à utiliser la fédération des identités sortantes
Ce guide explique comment activer la fédération des identités sortantes pour votre AWS compte et obtenez votre premier jeton Web JSON (JWT) (à l'aide du GetWebIdentityToken API). Vous allez activer la fonctionnalité, établir une relation de confiance avec un service externe, configurer les autorisations IAM et demander un jeton en utilisant soit AWS CLI ou AWS SDK pour Python (Boto3).
Conditions préalables
Avant de commencer, assurez-vous d'avoir :
-
La dernière version du AWS CLI ou Python 3.8 (ou version ultérieure) et Boto3 installés (pour AWS (exemples de SDK)
-
Un compte de service externe dans lequel vous pouvez configurer des relations de confiance (comme un fournisseur de cloud externe, un fournisseur SaaS ou une application de test)
Le
GetWebIdentityTokenL'API n'est pas disponible sur le terminal STS Global.Assumer un rôle dans un autre AWS partition, échangez le JWT renvoyé par GetWebIdentityToken pour obtenir des informations d'identification temporaires en appelant AssumeRoleWithWebIdentity. Cet échange est pris en charge uniquement au-delà des limites des partitions. Pour plus d’informations, consultez Fédérer AWS identités à travers AWS des cloisons. Pour l'hypothèse d'un rôle de partition identique, utilisez le AssumeRole API à la place.
Activez la fédération des identités sortantes pour votre compte
Vous devez activer la fédération des identités sortantes avant de pouvoir demander des jetons. Vous pouvez activer cette fonctionnalité à l'aide du AWS Console de gestion ou par programmation à l'aide du EnableOutboundWebIdentityFederation API.
Utilisation de AWS INTERFACE DE LIGNE DE COMMANDE (CLI)
aws iam enable-outbound-web-identity-federation
Utilisation AWS SDK pour Python
import boto3 # Create IAM client iam_client = boto3.client('iam') # Enable outbound identity federation response = iam_client.enable_outbound_web_identity_federation() print(f"Feature enabled. Issuer URL: {response['IssuerUrl']}") print(f"Status: {response['Status']}")
Utilisation de AWS Console
Accédez à IAM et sélectionnez Paramètres du compte dans le cadre de Gestion des accès section du menu de navigation de gauche
Une fois la fonctionnalité activée, notez l'URL de l'émetteur spécifique à votre compte. Vous utiliserez cette URL lors de la configuration des relations de confiance dans les services externes. Vous pouvez également récupérer l'URL de cet émetteur si nécessaire à l'aide du GetOutboundWebIdentityFederationInfo API.
Etablir une relation de confiance dans le service externe
Configurez le service externe pour qu'il fasse confiance et accepte les jetons émis par votre AWS compte. Les étapes spécifiques varient selon le service, mais impliquent généralement :
-
Enregistrement de votre AWS URL de l'émetteur du compte en tant que fournisseur d'identité de confiance
-
Configuration des allégations à valider (public, modèles de sujets)
-
Associer les revendications de jetons aux autorisations du service externe
Reportez-vous à la documentation du service externe pour obtenir des instructions de configuration détaillées. Si la partie utilisatrice est AWS dans une autre partition, voir Fédérer AWS identités à travers AWS des cloisons.
Configuration des autorisations IAM
Créez une politique IAM qui autorise à appeler le GetWebIdentityToken API et associez la politique à un rôle IAM qui doit générer des jetons.
Cet exemple de politique accorde l'accès à la génération de jetons avec des restrictions spécifiques. Il permet de demander des jetons uniquement pour »https://api.example.com« en tant que public et impose une durée de vie symbolique maximale de 5 minutes (300 secondes). Reportez-vous à IAM et AWS STS clés de contexte de condition pour obtenir la liste des clés de condition que vous pouvez utiliser pour appliquer les propriétés des jetons.
Exemple de politique IAM
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "sts:GetWebIdentityToken", "Resource": "*", "Condition": { "ForAllValues:StringEquals": { "sts:IdentityTokenAudience": "https://api.example.com" }, "Null": { "sts:IdentityTokenAudience": "false" }, "NumericLessThanEquals": { "sts:DurationSeconds": 300 } } } ] }
Demandez votre premier jeton Web JSON (JWT)
Vous pouvez demander un jeton Web JSON à l'aide du GetWebIdentityToken API. Vous pouvez spécifier les paramètres suivants lorsque vous appelez l'API :
-
Public (obligatoire) : Destinataire prévu du jeton. Cette valeur renseigne la valeur « aud » dans le JWT. Des services externes valident cette affirmation pour s'assurer que le jeton leur était destiné.
-
SigningAlgorithm (obligatoire) : Algorithme cryptographique utilisé pour signer le jeton. Les valeurs valides sont ES384 et RS256. Utilisez l'ES384 pour une sécurité et des performances optimales, ou le RS256 pour une compatibilité accrue avec les systèmes qui ne prennent pas en charge l'ECDSA.
-
DurationSeconds (facultatif) : Durée de vie du jeton en secondes. Les valeurs valides sont comprises entre 60 et 3 600. La valeur par défaut est 300 (5 minutes). Nous recommandons de raccourcir la durée de vie des jetons pour une sécurité accrue.
-
Tags (facultatif) : Une liste de paires clé-valeur à inclure en tant que revendications personnalisées dans le jeton. Les services externes peuvent utiliser ces allégations pour une autorisation précise.
L'API renvoie les champs suivants :
-
WebIdentityToken: Le JWT signé sous forme de chaîne codée en base64url. Incluez ce jeton dans les demandes adressées à des services externes.
-
Date d'expiration : Horodatage UTC de l'expiration du jeton.
Utilisation de AWS INTERFACE DE LIGNE DE COMMANDE (CLI)
aws sts get-web-identity-token \ --region us-east-1 \ --endpoint-url https://sts.us-east-1.amazonaws.com \ --audience "https://api.example.com" \ --signing-algorithm ES384 \ --duration-seconds 300 \ --tags Key=team,Value=data-engineering \ Key=environment,Value=production \ Key=cost-center,Value=analytics
Utilisation AWS SDK pour Python
import boto3 # GetWebIdentityToken requires a Regional STS endpoint. sts_client = boto3.client( 'sts', region_name='us-east-1', endpoint_url='https://sts.us-east-1.amazonaws.com' ) response = sts_client.get_web_identity_token( Audience=['https://api.example.com'], DurationSeconds=300, SigningAlgorithm='ES384', Tags=[ {'Key': 'team', 'Value': 'data-engineering'}, {'Key': 'environment', 'Value': 'production'}, {'Key': 'cost-center', 'Value': 'analytics'} ] ) token = response['WebIdentityToken']
Vous pouvez également décoder le JWT pour inspecter son contenu à l'aide de bibliothèques JWT standard telles que PyJWT, Python-jose pour Python, Nimbus JOSE+JWT pour Java ou des débogueurs comme jwt.io. Reportez-vous à Comprendre les revendications relatives aux jetons pour plus d'informations sur les réclamations incluses dans le jeton.
Utiliser le jeton avec un service externe
Après avoir reçu le jeton, incluez-le dans les demandes adressées au service externe. La méthode varie selon les services, mais la plupart des services acceptent les jetons dans l'en-tête Authorization. Le service externe doit implémenter une logique de validation des jetons qui récupère les clés JWKS depuis le point de terminaison bien connu de votre émetteur, vérifie la signature du jeton et valide les revendications essentielles avant d'accorder l'accès à votre AWS charges de travail.
Récupérez les clés de vérification et les métadonnées depuis les points de terminaison OpenID Connect (OIDC)
L'URL unique de l'émetteur pour votre AWS Le compte héberge les points de terminaison de découverte OpenID Connect (OIDC) qui contiennent les clés de vérification et les métadonnées nécessaires à la vérification des jetons.
L'URL du point de terminaison de découverte OIDC contient des métadonnées que certains fournisseurs utilisent pour vérifier les jetons. Il est disponible à l'adresse suivante :
{issuer_url}/.well-known/openid-configuration
Le point de terminaison JWKS (JSON Web Key Set) contient des clés utilisées pour vérifier les signatures de jetons. Il est disponible à l'adresse suivante :
{issuer_url}/.well-known/jwks.json
Récupérez JWKS à l'aide de curl
curl https://{issuer_url}/.well-known/jwks.json
Réponse :
{ "keys": [ { "kty": "EC", "use": "sig", "kid": "key-id-1", "alg": "ES384", "crv": "P-384", "x": "base64-encoded-x-coordinate", "y": "base64-encoded-y-coordinate" }, { "kty": "RSA", "use": "sig", "kid": "key-id-2", "n": "base64-encoded-modulus", "e": "AQAB" } ] }
Utilisation AWS SDK pour Python
import requests # Fetch Openid Configuration open_id_config_response = requests.get("https://{issuer_url}/.well-known/openid-configuration") open_id_config = open_id_config_response.json() # Fetch JWKS jwks_response = requests.get("https://{issuer_url}/.well-known/jwks.json") jwks = jwks_response.json()
Nous vous recommandons de mettre ces clés en cache pour éviter de les récupérer à chaque vérification de jeton.
Validations essentielles des allégations
-
Sujet (sous) : Vérifiez que l'objet de la réclamation contient le modèle d'ARN principal IAM attendu.
-
Date d'expiration (exp) : Assurez-vous que le jeton n'a pas expiré. Les bibliothèques JWT gèrent généralement cela automatiquement.
-
Public (en AUD) : Vérifiez que l'audience correspond à la valeur que vous attendez. Cela empêche l'utilisation de jetons destinés à d'autres services avec le vôtre.
-
Emetteur (s) : Vérifiez que l'émetteur correspond aux AWS compte (s) auquel vous faites confiance. Tenez à jour une liste d'URL d'émetteurs fiables.
Dans la mesure du possible, vous devez valider d'autres AWS-des revendications spécifiques pour mettre en œuvre un contrôle d'accès précis dans votre service externe. Par exemple, validez la réclamation org_id pour restreindre l'accès aux principaux composants IAM dans votre AWS Organization, vérifiez principal_tags pour appliquer le contrôle d'accès basé sur les attributs (par exemple, autoriser uniquement les environnements de production ou des équipes spécifiques), ou vérifiez les déclarations de contexte de session telles que lambda_source_function_arn ou ec2_instance_source_vpc pour restreindre l'accès en fonction de la ressource de calcul. Reportez-vous à Comprendre les revendications relatives aux jetons pour obtenir la liste complète des réclamations incluses dans le jeton.