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à.
Comprendere le dichiarazioni relative ai token
Quando chiami il GetWebIdentityToken API, AWS Security Token Service restituisce un JSON Web Token (JWT) firmato che contiene una serie di attestazioni che rappresentano l'identità del principale IAM. Questi token sono conformi a RFC 7519
Il JWT include dichiarazioni standard OpenID Connect (OIDC) come subject («sub»), audience («aud»), issuer («iss») per facilitare l'interoperabilità tra diversi servizi esterni. AWS STS compila il token con AWS affermazioni specifiche relative all'identità (come AWS ID dell'account e tag principale) e dichiarazioni relative al contesto della sessione (come gli ARN delle istanze EC2), se applicabili. Puoi anche aggiungere attestazioni personalizzate al token passandole come tag di richiesta al GetWebIdentityToken API. L' AWS le affermazioni specifiche dell'identità, le affermazioni relative al contesto della sessione e le attestazioni personalizzate sono annidate sotto»https://sts.amazonaws.com/«namespace nel token.
Fai riferimento al token di esempio riportato di seguito per un elenco dei claim inclusi nel token. Tieni presente che tutte queste affermazioni potrebbero non essere presenti in un token contemporaneamente.
{ "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" } } }
Reclami standard
I claim OIDC standard presenti nei token facilitano l'interoperabilità con un'ampia gamma di servizi esterni. Queste affermazioni possono essere convalidate utilizzando la maggior parte delle librerie JWT.
| Richiedi | Nome | Description | Valore di esempio |
|---|---|---|---|
| è | Emittente | L'URL dell'emittente specifico dell'account. I servizi esterni convalidano questa dichiarazione per assicurarsi che corrisponda all'emittente attendibile. | https://abc123-def456-ghi789-jkl012.tokens.sts.global.api.aws |
| aud | Destinatari | Il destinatario previsto del token specificato nel GetWebIdentityToken richiesta. | https://api.example.com |
| sub | Subject | L'ARN del principale IAM che ha richiesto il token. | arn:aws:iam: :123456789012:role/DataProcessingRole |
| iat | Emesso in | NumericDate valore che identifica l'ora in cui il JWT è stato emesso. | 1700000000 |
| exp | Scadenza | NumericDate valore che identifica l'ora di scadenza entro la quale il JWT NON DEVE essere accettato per l'elaborazione. | 1700000900 |
| kit | JWT È | Identificatore univoco per questa istanza di token. | xyz123-def456-ghi789-jkl012 |
Reclami personalizzati
Oltre alle dichiarazioni OIDC standard, AWS STS aggiunge affermazioni sull'identità e sul contesto della sessione, se applicabili. Puoi anche aggiungere le tue attestazioni al token passandole come tag di richiesta. I claim personalizzati sono annidati sotto https://sts.amazonaws.com/ namespace.
Le chiavi di condizione nelle tabelle seguenti identificano il contesto della richiesta di origine utilizzato per compilare le attestazioni. Per le chiavi di condizione utilizzate nell'assunzione dei ruoli tra le partizioni e la loro disponibilità nella sessione di destinazione, vedere AWS STS scheda sotto Tasti disponibili per AWS Federazione OIDC.
AWS rivendicazioni di identità
Queste affermazioni forniscono informazioni dettagliate sul tuo AWS account, struttura organizzativa e responsabile IAM.
| Richiedi | Description | Chiave della condizione di origine | Valore di esempio |
|---|---|---|---|
| aws_account | Il tuo AWS ID dell'account | era:PrincipalAccount | 123456789012 |
| source_region | Il AWS regione in cui è stato richiesto il token | era:RequestedRegion | us-east-1 |
| id_principale | L'ARN del principale IAM che ha richiesto il token. | era:PrincipalArn | arn:aws:iam: :123456789012:role/DataProcessingRole |
| org_id | Il tuo AWS ID dell'organizzazione (se il tuo account fa parte di un'organizzazione) | era:PrincipalOrgID | o-abc1234567 |
| ou_path | Il AWS Percorsi dell'organizzazione per l'account di origine, sotto forma di array. Presente quando i percorsi dell'organizzazione sono disponibili nel contesto della richiesta di origine. | era:PrincipalOrgPaths | ["o-a1b2c3d4e5/r-ab12/ou-ab12-11111111/ou-ab12/ "] |
| tag_principali | Tag allegati alla sessione con ruolo principale o presunto di IAM. Quando viene richiesto un token in cui il responsabile IAM richiedente ha sia tag principali che tag di sessione, i tag di sessione saranno presenti nel JWT. | era:PrincipalTag/<tag-key> | {"environment»: «produzione», «team»: «ingegneria dei dati», «cost-center» :"ingegneria "} |
Dichiarazioni relative al contesto della sessione
Queste dichiarazioni forniscono informazioni sull'ambiente di calcolo e sulla sessione da cui ha avuto origine la richiesta del token. AWS STS include automaticamente queste affermazioni, se applicabili, in base al contesto della sessione del principale richiedente.
| Richiedi | Description | Chiave della condizione di origine | Valore di esempio |
|---|---|---|---|
| original_session_exp | Quando scadranno le credenziali della sessione di ruolo originale (per i ruoli assunti) | N/A | 2024-01-15T10:00:00Z |
| invocato_da | Il AWS servizio che agisce per conto del cliente assumendo il ruolo di origine o l'ultimo servizio in un sessione di accesso diretto. Questa dichiarazione è presente solo quando la sessione di origine include l'identità di quel servizio. | N/A | ec2.amazonaws.com |
| mfa_present | Indica che il principale IAM è stato autenticato con MFA. Presente solo quando è stato utilizzato l'MFA, con il valore della stringa "true". Non lo è mai "false". |
era:MultiFactorAuthPresent | "true" |
| mfa_age | Il numero di secondi trascorsi dall'autenticazione del principale IAM con MFA, codificato come stringa. Presente solo quando è stato utilizzato l'MFA e l'età di autenticazione è disponibile. | era:MultiFactorAuthAge | «1800" |
| fornitore_federato | Il nome del provider di identità per le sessioni federate | era:FederatedProvider | arn:aws:iam: :111122223333:oidc-provider/your_oidc_provider |
| identity_store_user_id | ID utente IAM Identity Center | archivio di identità:UserId | utente abc123def456 |
| identity_store_arn | ARN dell'archivio di identità di Identity Center | archivio di identità:IdentityStoreArn | arn:aws:identitystore: :123456789012:identitystore/d- abc1234567 |
| ec2_source_instance_arn | ARN dell'istanza EC2 richiedente | ec2:SourceInstanceArn | arn:aws:ec2:us-east- 1:123456789012:instance/i- abc123def456 |
| ec2_instance_source_vpc | ID VPC in cui sono state fornite le credenziali del ruolo EC2 | era:Ec2InstanceSourceVpc | vpc-abc123def456 |
| ec2_instance_source_private_ipv4 | Indirizzo IPv4 privato dell'istanza EC2 | era:Ec2InstanceSourcePrivateIPv4 | 10.0.1.25 |
| ec2_role_delivery | La versione IMDS (Instance Metadata Service) che ha fornito le credenziali del ruolo di origine: 1.0 per IMDSv1 o 2.0 per IMDSv2. |
ec2:RoleDelivery | 2.0 |
| identità_origine | Identità di origine impostata dal principale | era:SourceIdentity | utente amministratore |
| lambda_source_function_arn | ARN della funzione Lambda chiamante | lambda:SourceFunctionArn | arn:aws:lambda:us-east- 1:123456789012:funzione:my-function |
| glue_credential_issuing_service | AWS Identificatore del servizio Glue per i lavori Glue | colla:CredentialIssuingService | colla.amazonaws.com |
Richiedi tag
Puoi aggiungere attestazioni personalizzate ai token specificando i tag nel GetWebIdentityToken Richiesta API. Queste dichiarazioni vengono visualizzate nel campo request_tags del token e consentono di trasmettere informazioni specifiche che i servizi esterni possono utilizzare per decisioni di autorizzazione dettagliate. Puoi specificare fino a 50 tag per richiesta.
Richiesta di esempio:
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'} ] )
Dichiarazioni risultanti in token:
{ "request_tags": { "team": "data-engineering", "cost-center": "analytics", "environment": "production" } }