Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Token-Ansprüche verstehen
Wenn du den anrufst GetWebIdentityToken API, AWS Der Security Token Service gibt ein signiertes JSON Web Token (JWT) zurück, das eine Reihe von Ansprüchen enthält, die die Identität des IAM-Prinzipals darstellen. Diese Token sind konform mit RFC 7519
Das JWT beinhaltet standardmäßige OpenID Connect (OIDC) -Angaben wie Betreff („Sub“), Zielgruppe („aud“) und Issuer („iss“), um die Interoperabilität zwischen verschiedenen externen Diensten zu erleichtern. AWS STS füllt das Token mit AWS identitätsspezifische Ansprüche (wie die AWS Konto-ID und Principal-Tags) und Sitzungskontextansprüche (wie EC2-Instance-ARNs), sofern zutreffend. Sie können dem Token auch benutzerdefinierte Ansprüche hinzufügen, indem Sie sie als Anforderungs-Tags an das übergeben GetWebIdentityToken API. Das AWS identitätsspezifische Ansprüche, Sitzungskontextansprüche und benutzerdefinierte Ansprüche sind unter dem“ verschachtelthttps://sts.amazonaws.com/„-Namespace im Token.
Im folgenden Beispiel-Token finden Sie eine Liste der im Token enthaltenen Ansprüche. Bitte beachten Sie, dass möglicherweise nicht alle diese Ansprüche gleichzeitig in einem Token enthalten sind.
{ "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" } } }
Standardansprüche
Die in den Tokens enthaltenen OIDC-Standardansprüche erleichtern die Interoperabilität mit einer Vielzahl externer Dienste. Diese Behauptungen können mit den meisten JWT-Bibliotheken validiert werden.
| Antrag | Name | Description | Beispielwert |
|---|---|---|---|
| küssen | Aussteller | Ihre kontospezifische Aussteller-URL. Externe Dienste überprüfen diese Angabe, um sicherzustellen, dass sie mit ihrem vertrauenswürdigen Aussteller übereinstimmt. | https://abc123-def456-ghi789-jkl012.tokens.sts.global.api.aws |
| aud | Zielgruppe | Der beabsichtigte Empfänger für das Token, angegeben in GetWebIdentityToken Anfrage. | https://api.example.com |
| sub | Betreff | Der ARN des IAM-Prinzipals, der das Token angefordert hat. | arn:aws:iam: :123456789012:role/DataProcessingRole |
| iat | Ausgestellt am | NumericDate Wert, der den Zeitpunkt identifiziert, zu dem das JWT ausgegeben wurde. | 1700000000 |
| exp | Ablauf | NumericDate Wert, der die Ablaufzeit angibt, an oder nach der das JWT NICHT zur Verarbeitung akzeptiert werden DARF. | 1700000900 |
| jti | JWT IST | Eindeutiger Bezeichner für diese Token-Instanz. | xyz123-def456-ghi789-jkl012 |
Benutzerdefinierte Ansprüche
Zusätzlich zu den OIDC-Standardansprüchen AWS STS fügt gegebenenfalls Angaben zur Identität und zum Sitzungskontext hinzu. Sie können dem Token auch Ihre eigenen Ansprüche hinzufügen, indem Sie sie als Anforderungs-Tags übergeben. Benutzerdefinierte Ansprüche sind verschachtelt unter https://sts.amazonaws.com/ Namespace.
Die Bedingungsschlüssel in den folgenden Tabellen identifizieren den Quellanforderungskontext, der zum Ausfüllen der Ansprüche verwendet wurde. Informationen zu den Bedingungsschlüsseln, die bei der partitionsübergreifenden Rollenübernahme verwendet werden, und zu ihrer Verfügbarkeit in der Zielsitzung finden Sie in der AWS STS Tab unter Verfügbare Schlüssel für AWS OIDC-Verband.
AWS Identitätsansprüche
Diese Ansprüche enthalten detaillierte Informationen über Ihre AWS Konto, Organisationsstruktur und IAM-Principal.
| Antrag | Description | Quelle, Bedingungsschlüssel | Beispielwert |
|---|---|---|---|
| aws_account | Ihr AWS Konto-ID | als:PrincipalAccount | 123456789012 |
| source_region | Das AWS Region, in der das Token angefordert wurde | war:RequestedRegion | us-east-1 |
| prinzipal_id | Der ARN des IAM-Prinzipals, der das Token angefordert hat. | war:PrincipalArn | arn: aws: iam: 123456789012:role/DataProcessingRole |
| org_id | Dein AWS Organisations-ID (wenn Ihr Konto Teil einer Organisation ist) | als:PrincipalOrgID | o-abc1234567 |
| ou_path | Der AWS Organisationspfade für das Quellkonto als Array. Ist vorhanden, wenn Organisationspfade im Quellanforderungskontext verfügbar sind. | als:PrincipalOrgPaths | ["o-a1b2c3d4e5/r-ab12/ou-ab12-11111111/ou-ab12-22222222/ "] |
| hauptsächliche_Schlagworte | Tags, die an die IAM-Principal- oder übernommene Rollensitzung angehängt sind. Wenn ein Token angefordert wird, bei dem der anfordernde IAM-Prinzipal sowohl Prinzipal-Tags als auch Sitzungs-Tags hat, sind die Sitzungs-Tags im JWT vorhanden. | als:PrincipalTag/<tag-key> | {"Umgebung“: „Produktion“, „Team“: „Datenentwicklung“, „Kostenstelle“ :"Technik "} |
Der Sitzungskontext behauptet
Diese Behauptungen enthalten Informationen über die Rechenumgebung und die Sitzung, aus der die Token-Anfrage stammt. AWS STS schließt diese Ansprüche automatisch ein, sofern zutreffend, basierend auf dem Sitzungskontext des anfragenden Prinzipals.
| Antrag | Description | Quelle, Bedingungsschlüssel | Beispielwert |
|---|---|---|---|
| original_session_exp | Wann die ursprünglichen Anmeldeinformationen für die Rollensitzung ablaufen (für angenommene Rollen) | N/A | 15.01.2020T10:00:00Z |
| aufgerufen_von | Das AWS Dienst, der im Namen des Kunden handelt, indem er die Quellrolle übernimmt, oder der letzte Dienst in einem Zugriffssitzung weiterleiten. Dieser Anspruch besteht nur, wenn die Quellsitzung die Identität dieses Dienstes enthält. | N/A | ec2.amazonaws.com |
| mfa_präsent | Zeigt an, dass der IAM-Prinzipal bei MFA authentifiziert wurde. Nur vorhanden, wenn MFA verwendet wurde, mit dem Zeichenfolgenwert "true". Ist es nie "false". |
sägen:MultiFactorAuthPresent | „true“ |
| mfa_age | Die Anzahl der Sekunden seit der Authentifizierung des IAM-Prinzipals bei MFA, codiert als Zeichenfolge. Nur vorhanden, wenn MFA verwendet wurde und das Authentifizierungsalter verfügbar ist. | Gesetze:MultiFactorAuthAge | „1800" |
| verbundener Anbieter | Der Name des Identitätsanbieters für Verbundsitzungen | AWS:FederatedProvider | arn:aws:iam:111122223333:oidc-provider/your_oidc_provider |
| identity_store_user_id | IAM Identity Center-Benutzer-ID | Identitätsspeicher:UserId | user-abc123def456 |
| identity_store_arn | ARN des Identity Center-Identitätsspeichers | Identitätsspeicher:IdentityStoreArn | arn:aws: identitystore: :123456789012:identitystore/d-abc1234567 |
| ec2_source_instance_arn | ARN der anfordernden EC2-Instanz | ec2:SourceInstanceArn | arn:aws:ec2:us-east- 1:123456789012:instance/i-abc123def456 |
| ec2_instance_source_vpc | VPC-ID, an die die Anmeldeinformationen für die EC2-Rolle übermittelt wurden | war:Ec2InstanceSourceVpc | vpc-abc123def456 |
| ec2_instance_source_private_ipv4 | Private IPv4-Adresse der EC2-Instanz | war:Ec2InstanceSourcePrivateIPv4 | 10.0.1.25 |
| ec2_role_delivery | Die IMDS-Version (Instance Metadata Service), die die Anmeldeinformationen für die Quellrolle bereitgestellt hat: 1.0 für IMDSv1 oder 2.0 für IMDSv2. |
ec2:RoleDelivery | 2.0 |
| Quelle/Identität | Vom Principal festgelegte Quellidentität | war:SourceIdentity | Admin-Benutzer |
| lambda_source_function_arn | ARN der aufrufenden Lambda-Funktion | Lambda:SourceFunctionArn | arn: aws: lambda: us-east- 1:123456789012: Funktion: my-function |
| glue_credentials _issuing_service | AWS Glue-Dienst-ID für Glue-Jobs | kleben:CredentialIssuingService | glue.amazonaws.com |
Schlagworte anfordern
Sie können benutzerdefinierte Ansprüche zu Tokens hinzufügen, indem Sie Tags in der GetWebIdentityToken API-Anfrage. Diese Ansprüche werden im Feld request_tags im Token angezeigt und ermöglichen es Ihnen, spezifische Informationen weiterzugeben, die externe Dienste für detaillierte Autorisierungsentscheidungen verwenden können. Sie können bis zu 50 Tags pro Anfrage angeben.
Beispielanforderung:
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'} ] )
Daraus resultierende Ansprüche in Form von Token:
{ "request_tags": { "team": "data-engineering", "cost-center": "analytics", "environment": "production" } }