View a markdown version of this page

Configurazione della federazione delle identità tra partizioni - AWS Identity and Access Management

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Configurazione della federazione delle identità tra partizioni

Cross-partition la federazione delle identità funziona come uno scambio in due fasi: il carico di lavoro chiama sts:GetWebIdentityToken per ottenere un JWT da AWS STS nella partizione di origine, quindi scambia quel token con credenziali temporanee da AWS STS nella partizione di destinazione chiamando sts:AssumeRoleWithWebIdentity.

La definizione di questo flusso prevede una sola fase di configurazione e una fase di runtime che si ripete ogni volta che il carico di lavoro richiede credenziali nella partizione di destinazione. Questa pagina spiega come configurare gli account di origine e di destinazione.

Fase di configurazione

  1. Nella partizione di origine, abilita la federazione delle identità in uscita per il tuo account. Per istruzioni, consulta l’argomento Abilita la federazione delle identità in uscita per il tuo account.

  2. Nella partizione di origine, crea un principal IAM o scegline uno esistente e concedigli il permesso di chiamare sts:GetWebIdentityToken. Utilizza le condizioni delle policy IAM per limitare il pubblico consentito, la durata dei token e gli algoritmi di firma. Per istruzioni, consulta l’argomento Controllo degli accessi con le policy IAM.

  3. Nella partizione di destinazione, crea un provider di identità OpenID Connect (OIDC) utilizzando l'URL dell'emittente dell'account di origine. Assicurati che l'elenco degli ID client del provider includa il pubblico con cui verrà utilizzato il carico di lavoro GetWebIdentityToken. Per istruzioni, consulta l’argomento Creare un provider di identità OpenID Connect (OIDC) in IAM.

  4. Nella partizione di destinazione, crea un ruolo IAM o scegline uno esistente che il principale IAM di origine assuma. Configura la politica di fiducia del ruolo per considerare attendibile il provider di identità OIDC che hai creato e autorizzato sts:AssumeRoleWithWebIdentity. Per istruzioni, consulta l’argomento Chi può assumere un ruolo.

Fase di runtime

  1. Utilizzando le credenziali per l'entità IAM nella partizione di origine, chiama set:GetWebIdentityToken con il pubblico che hai configurato nel provider di identità OIDC dell'account di destinazione.

    Nota

    Per la federazione delle identità tra più partizioni, specifica esattamente un pubblico al momento della chiamata GetWebIdentityToken. I token richiesti con più destinatari non possono essere scambiati con credenziali temporanee utilizzando AssumeRoleWithWebIdentity.

  2. AWS STS nella partizione di origine restituisce un JWT di breve durata che rappresenta l'identità del principale IAM di origine.

  3. Chiama set:AssumeRoleWithWebIdentity sul AWS STS endpoint nella partizione di destinazione, passando il JWT, l'ARN del ruolo di destinazione configurato durante l'installazione e il nome della sessione di ruolo (RoleSessionName).

  4. AWS STS nella partizione di destinazione convalida il JWT e valuta la politica di fiducia del ruolo di destinazione. Se la richiesta è consentita, AWS STS restituisce le credenziali temporanee per quel ruolo.

  5. Usa le credenziali temporanee per accedere AWS risorse o comunica con un AWS servizio nella partizione di destinazione.

Quanto segue AWS L'esempio CLI mostra la fase di runtime, utilizzando us-east-1 nel aws partizione come regione di origine e cn-north-1 nella aws-cn partizione come regione di destinazione. Usa le credenziali per il principale IAM di origine da chiamare GetWebIdentityToken. Il AssumeRoleWithWebIdentity la chiamata si autentica utilizzando il JWT restituito da GetWebIdentityToken e non richiede AWS credenziali.

# 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'esempio seguente mostra lo stesso flusso utilizzando AWS SDK per 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']