View a markdown version of this page

Erste Schritte mit dem ausgehenden Identitätsverbund - AWS Identitäts- und Zugriffsverwaltung

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.

Erste Schritte mit dem ausgehenden Identitätsverbund

In diesem Handbuch erfahren Sie, wie Sie den ausgehenden Identitätsverbund für Ihr Gerät aktivieren AWS Konto und beziehen Sie Ihr erstes JSON Web Token (JWT) (mit dem GetWebIdentityToken API). Sie aktivieren die Funktion, stellen eine Vertrauensbeziehung zu einem externen Dienst her, konfigurieren IAM-Berechtigungen und fordern ein Token mit einer der folgenden Methoden an AWS CLI oder AWS SDK für Python (Boto3).

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie:

  • Aktuelle Version von AWS CLI oder Python 3.8 (oder höher) und Boto3 installiert (für AWS SDK-Beispiele)

  • Ein externes Dienstkonto, in dem Sie Vertrauensbeziehungen konfigurieren können (z. B. ein externer Cloud-Anbieter, SaaS-Anbieter oder eine Testanwendung)

Anmerkung

Aktivieren Sie den ausgehenden Identitätsverbund für Ihr Konto

Sie müssen den ausgehenden Identitätsverbund aktivieren, bevor Sie Token anfordern können. Sie können die Funktion mit dem aktivieren AWS Managementkonsole oder programmgesteuert mithilfe der EnableOutboundWebIdentityFederation API.

Verwendung der AWS CLI

aws iam enable-outbound-web-identity-federation

Verwenden AWS SDK für 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']}")

Verwendung der AWS Konsole

Navigieren Sie zu IAM und wählen Sie Konto-Einstellungen unter dem Verwaltung des Zugriffs Abschnitt des linken Navigationsmenüs

Der Menüpunkt Kontoeinstellungen ist in der linken Navigationsleiste im Bereich Zugriffsverwaltung hervorgehoben.

Sobald Sie die Funktion aktiviert haben, notieren Sie sich Ihre kontospezifische Aussteller-URL. Sie werden diese URL verwenden, wenn Sie Vertrauensbeziehungen in externen Diensten konfigurieren. Sie können diese Aussteller-URL bei Bedarf auch mit der GetOutboundWebIdentityFederationInfo API.

Die Outbound Identity Federation-Schnittstelle zeigt den Status Aktiviert mit der Schaltfläche „Deaktivieren“ und der URL des Token-Ausstellers an.

Stellen Sie eine Vertrauensbeziehung zum externen Dienst her

Konfigurieren Sie den externen Dienst so, dass er von Ihrem ausgestellten Token vertraut und diese akzeptiert AWS Konto. Die spezifischen Schritte variieren je nach Service, beinhalten aber im Allgemeinen:

  • Registrierung Ihres AWS URL des Kontoausstellers als vertrauenswürdiger Identitätsanbieter

  • Konfiguration, welche Angaben überprüft werden sollen (Zielgruppe, Betreffmuster)

  • Zuordnung von Token-Ansprüchen zu Berechtigungen im externen Dienst

Detaillierte Konfigurationsanweisungen finden Sie in der Dokumentation zum externen Dienst. Wenn die vertrauende Partei AWS in einer anderen Partition, siehe Föderieren AWS Identitäten quer AWS Partitionen.

Konfigurieren Sie die IAM-Berechtigungen.

Erstellen Sie eine IAM-Richtlinie, die die Erlaubnis zum Aufrufen des GetWebIdentityToken Erstellen Sie eine API und fügen Sie die Richtlinie einer IAM-Rolle hinzu, die Token generieren muss.

Diese Beispielrichtlinie gewährt Zugriff auf die Token-Generierung mit bestimmten Einschränkungen. Sie erlaubt das Anfordern von Tokens nur für“https://api.example.com"als Publikum und erzwingt eine maximale Token-Lebensdauer von 5 Minuten (300 Sekunden). Beziehen Sie sich auf IAM und AWS STS Bedingungskontextschlüssel eine Liste von Bedingungsschlüsseln, die Sie verwenden können, um Token-Eigenschaften durchzusetzen.

Beispiel für eine IAM-Richtlinie

{ "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 } } } ] }

Fordern Sie Ihr erstes JSON Web Token (JWT) an

Sie können ein JSON-Web-Token mit dem anfordern GetWebIdentityToken API. Sie können beim Aufrufen der API die folgenden Parameter angeben:

  • Zielgruppe (erforderlich): Der beabsichtigte Empfänger des Tokens. Dieser Wert füllt die Angabe „aud“ im JWT aus. Externe Dienste überprüfen diese Behauptung, um sicherzustellen, dass das Token für sie bestimmt war.

  • SigningAlgorithm (erforderlich): Der kryptografische Algorithmus, der zum Signieren des Tokens verwendet wurde. Gültige Werte sind ES384 und RS256. Verwenden Sie ES384 für optimale Sicherheit und Leistung oder RS256 für eine umfassendere Kompatibilität mit Systemen, die ECDSA nicht unterstützen.

  • DurationSeconds (fakultativ): Die Lebensdauer des Tokens in Sekunden. Gültige Werte liegen im Bereich von 60 bis 3600. Der Standardwert ist 300 (5 Minuten). Für eine erhöhte Sicherheit empfehlen wir eine kürzere Token-Lebensdauer.

  • Schlagworte (optional): Eine Liste von Schlüssel-Wert-Paaren, die als benutzerdefinierte Ansprüche in das Token aufgenommen werden sollen. Externe Dienste können diese Ansprüche für eine detaillierte Autorisierung verwenden.

Die API gibt die folgenden Felder zurück:

  • WebIdentityToken: Das signierte JWT als Base64url-kodierte Zeichenfolge. Schließen Sie dieses Token in Anfragen an externe Dienste ein.

  • Ablauf: Der UTC-Zeitstempel für den Zeitpunkt, an dem das Token abläuft.

Verwendung der AWS 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

Verwenden AWS SDK für 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']

Sie können das JWT auch dekodieren, um seinen Inhalt mithilfe von Standard-JWT-Bibliotheken wie PyJWT zu überprüfen. Python-jose für Python, Nimbus JOSE+JWT für Java oder Debugger wie jwt.io. Beziehen Sie sich auf Token-Ansprüche verstehen weitere Informationen zu den im Token enthaltenen Ansprüchen.

Verwenden Sie das Token mit einem externen Dienst

Nachdem Sie das Token erhalten haben, fügen Sie es in Anfragen an den externen Dienst ein. Die Methode ist je nach Dienst unterschiedlich, aber die meisten Dienste akzeptieren Token im Authorization-Header. Der externe Dienst sollte eine Token-Validierungslogik implementieren, die die JWKS-Schlüssel vom bekannten Endpunkt Ihres Ausstellers abruft, die Signatur des Tokens verifiziert und wichtige Ansprüche validiert, bevor der Zugriff auf Ihre AWS Arbeitslasten.

Rufen Sie Bestätigungsschlüssel und Metadaten von den OpenID Connect (OIDC) -Endpunkten ab

Die eindeutige Aussteller-URL für Ihre AWS Das Konto hostet die OpenID Connect (OIDC) -Discovery-Endpunkte, die Bestätigungsschlüssel und Metadaten enthalten, die für die Token-Verifizierung erforderlich sind.

Die URL des OIDC-Discovery-Endpunkts enthält Metadaten, die einige Anbieter zur Überprüfung von Token verwenden. Sie ist verfügbar unter:

{issuer_url}/.well-known/openid-configuration

Der JWKS-Endpunkt (JSON Web Key Set) enthält Schlüssel, die zur Überprüfung von Token-Signaturen verwendet werden. Er ist verfügbar unter:

{issuer_url}/.well-known/jwks.json

Holen Sie sich JWKS mit curl

curl https://{issuer_url}/.well-known/jwks.json

Antwort:

{ "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" } ] }

Verwenden AWS SDK für 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()

Wir empfehlen, diese Schlüssel zwischenzuspeichern, um zu vermeiden, dass sie bei jeder Token-Überprüfung abgerufen werden.

Unverzichtbare Validierungen von Ansprüchen

  • Betreff (Sub): Stellen Sie sicher, dass der betreffende Anspruch das erwartete IAM-Prinzipal-ARN-Muster enthält.

  • Ablauf (gültig bis): Stellen Sie sicher, dass das Token nicht abgelaufen ist. JWT-Bibliotheken handhaben dies normalerweise automatisch.

  • Publikum (aud): Stellen Sie sicher, dass die Zielgruppe Ihrem erwarteten Wert entspricht. Dadurch wird verhindert, dass Token, die für andere Dienste bestimmt sind, zusammen mit Ihren verwendet werden.

  • Emittent (in): Stellen Sie sicher, dass der Emittent dem entspricht AWS Konten, denen Sie vertrauen. Pflegen Sie eine Liste vertrauenswürdiger Aussteller-URLs.

Wann immer möglich, sollten Sie zusätzliche validieren AWS-spezifische Ansprüche zur Implementierung einer detaillierten Zugriffskontrolle in Ihrem externen Dienst. Überprüfen Sie beispielsweise den org_id-Anspruch, um den Zugriff auf IAM-Prinzipale in Ihrem System einzuschränken AWS Organisation, überprüfen Sie principal_tags, um eine attributbasierte Zugriffskontrolle durchzusetzen (z. B. nur Produktionsumgebungen oder bestimmte Teams zuzulassen), oder überprüfen Sie Sitzungskontextansprüche wie lambda_source_function_arn oder ec2_instance_source_vpc, um den Zugriff auf der Grundlage der Rechenressource einzuschränken. Weitere Informationen finden Sie unter Grundlegendes zu Token-Ansprüchen für eine vollständige Liste der im Token enthaltenen Ansprüche.