View a markdown version of this page

Grundlegendes zum Identitätstoken (ID) - Amazon Cognito

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.

Grundlegendes zum Identitätstoken (ID)

Das ID-Token ist ein JSON-Web-Token (JWT), das Ansprüche bezüglich der Identität des authentifizierten Benutzers enthält, beispielsweise name, email und phone_number. Sie können diese Identitätsinformationen in Ihrer Anwendung verwenden. Das ID-Token kann ebenfalls verwendet werden, um Benutzer mithilfe Ihrer Ressourcenserver oder Serveranwendungen zu authentifizieren. Sie können auch ein ID-Token außerhalb der Anwendung mit Ihren Web-API-Operationen verwenden. In diesen Fällen müssen Sie die Signatur des ID-Tokens überprüfen, bevor Sie Ansprüchen innerhalb des ID-Tokens vertrauen können. Siehe Überprüfung von JSON-Web-Tokens.

Sie können den Ablauf des ID-Tokens auf einen beliebigen Wert zwischen 5 Minuten und 1 Tag festlegen. Sie können diesen Wert pro App-Client festlegen.

Das ID-Token umfasst die amr Ansprüche acr und, die die Authentifizierungsebene beschreiben, die der Benutzer erfüllt hat, und die Methoden, die er ausgeführt hat. Weitere Informationen finden Sie unter ACR- und AMR-Token-Ansprüche.

Wichtig

Wenn sich Ihr Benutzer mit verwaltetem Login anmeldet, setzt Amazon Cognito Sitzungscookies, die 1 Stunde lang gültig sind. Wenn Sie die verwaltete Anmeldung für die Authentifizierung in Ihrer Anwendung verwenden und eine Mindestdauer von weniger als 1 Stunde für Ihre Zugriffs- und ID-Token angeben, haben Ihre Benutzer weiterhin eine gültige Sitzung, bis das Cookie abläuft. Wenn der Benutzer Token hat, die in der einstündigen Sitzung ablaufen, kann der Benutzer seine Token aktualisieren, ohne sich erneut authentifizieren zu müssen.

Kopfzeile des ID-Tokens

Der Header enthält zwei verschiedene Informationen: die Schlüssel-ID (kid) und den Algorithmus (alg).

{ "kid" : "1234example=", "alg" : "RS256" }
kid

Die Schlüssel-ID. Ihr Wert ist ein Hinweis darauf, welcher Schlüssel verwendet wurde, um die JSON-Websignatur (JWS) des Tokens zu sichern. Sie können die Signaturschlüssel-IDs Ihres Benutzerpools am jwks_uri-Endpunkt einsehen.

Weitere Informationen über den kid-Parameter finden Sie unter dem Schlüssel-ID-(kid)-Header-Parameter.

alg

Der kryptografische Algorithmus, mit dem Amazon Cognito das Zugriffstoken sichert. Benutzerpools verwenden einen kryptografischen RS256-Algorithmus, bei dem es sich um eine RSA-Signatur mit handelt. SHA-256

Weitere Informationen über den alg-Parameter finden Sie unter dem Algorithmus-(alg)-Header-Parameter.

Standard-Payload für ID-Tokens

Dies ist ein Beispiel für eine Payload aus einem ID-Token. Es enthält Ansprüche bezüglich des authentifizierten Benutzers. Weitere Informationen zu OpenID Connect (OIDC) -Standardansprüchen finden Sie in der Liste der OIDC-Standardansprüche. Sie können Ansprüche Ihres eigenen Designs mit einem hinzufügen. Lambda-Auslöser für die Vorab-Generierung von Token

Diese Nutzdaten sind repräsentativ und nicht erschöpfend. Die Anzahl der Ansprüche in einem Amazon Cognito Cognito-ID-Token wächst mit der Zeit, da neue Funktionen neue Ansprüche hinzufügen. Daher können die Ansprüche, die Ihre Token enthalten, von diesem Beispiel abweichen. Behandeln Sie dieses Beispiel als eine Momentaufnahme gängiger Behauptungen und nicht als vollständige, feste Liste. Lesen Sie, Wie kann dieses Token sicher analysiert werden bevor Sie Code schreiben, der Amazon Cognito Cognito-Token analysiert.

<header>.{ "sub": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee", "cognito:groups": [ "test-group-a", "test-group-b", "test-group-c" ], "email_verified": true, "cognito:preferred_role": "arn:aws:iam::111122223333:role/my-test-role", "iss": "https://cognito-idp.us-west-2.amazonaws.com/us-west-2_example", "cognito:username": "my-test-user", "middle_name": "Jane", "nonce": "abcdefg", "origin_jti": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee", "cognito:roles": [ "arn:aws:iam::111122223333:role/my-test-role" ], "aud": "xxxxxxxxxxxxexample", "identities": [ { "userId": "amzn1.account.EXAMPLE", "providerName": "LoginWithAmazon", "providerType": "LoginWithAmazon", "issuer": null, "primary": "true", "dateCreated": "1642699117273" } ], "event_id": "64f513be-32db-42b0-b78e-b02127b4f463", "token_use": "id", "auth_time": 1676312777, "exp": 1676316377, "iat": 1676312777, "jti": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee", "email": "my-test-user@example.com" } .<token signature>
sub

Eine eindeutige Kennung (UUID) oder ein Betreff für den authentifizierten Benutzer. Möglicherweise ist der Benutzername in Ihrem Benutzerpool nicht eindeutig. Der sub-Anspruch ist der beste Weg, um einen bestimmten Benutzer zu identifizieren.

Wichtig

Amazon Cognito generiert sub in einem Cognito-specific Amazon-Format, das keinem bestimmten UUID-Format entspricht, einschließlich RFC-UUID. Sie sollten das Format von nicht strikt validieren. sub Allgemeiner gesagt, lesen Sie, wie in der Anleitung zur sicheren Analyse von Token-Ansprüchen beschrieben, jeden Anspruch als den Typ, den diese Seite dokumentiert, und legen Sie kein strengeres Format fest, als es in der Dokumentation angegeben ist.

cognito:groups

Ein Array von Zeichenfolgen. Jede Zeichenfolge ist der Name einer Benutzerpoolgruppe, der Ihr Benutzer als Mitglied angehört. Gruppen können eine Kennung sein, die Sie Ihrer App präsentieren, oder sie können eine Anfrage für eine bevorzugte IAM-Rolle aus einem Identitätspool generieren. Dieser Anspruch ist immer ein Array, auch wenn der Benutzer zu einer einzigen Gruppe gehört.

cognito:preferred_role

Der ARN der IAM-Rolle, die Sie der Benutzerpoolgruppe mit der höchsten Priorität Ihres Benutzers zugeordnet haben. Weitere Informationen darüber, wie Ihr Benutzerpool diesen Rollenanspruch auswählt, finden Sie unter Zuweisen von Prioritätswerten zu Gruppen.

iss

Eine einzelne Zeichenfolge. Der Aussteller des Tokens. Dieser Anspruch identifiziert den Benutzerpool, der das Token generiert hat. Ihre Anwendung sollte überprüfen, ob dieser Wert mit der erwarteten Aussteller-URL Ihres Benutzerpools übereinstimmt. Der Anspruch hat das folgende Format:

https://cognito-idp.<Region>.amazonaws.com/<your user pool ID>

Ihr Benutzerpool kann einen ursprünglichen oder einen aktualisierten Emittenten verwenden. Aktualisierte Aussteller hosten dieselben JWKS-Inhalte in mehreren Regionen, was zu einer verbesserten Resilienz und Effizienz führt. Weitere Informationen finden Sie unter Amazon Cognito Cognito-Benutzerpools als OIDC-Emittent.

cognito:username

Der Benutzername Ihres Benutzers in Ihrem Benutzerpool.

nonce

Der nonce-Anspruch stammt von einem gleichnamigen Parameter, den Sie Anforderungen an Ihren OAuth 2.0-Endpunkt authorize hinzufügen können. Wenn Sie den Parameter hinzufügen, wird der nonce-Anspruch in das ID-Token eingeschlossen, das Amazon Cognito ausgibt, und Sie können ihn zum Schutz vor Wiederholungsangriffen verwenden. Wenn Sie in Ihrer Anfrage keinen nonce-Wert angeben, generiert und validiert Amazon Cognito automatisch eine Nonce, wenn Sie sich über eine Drittanbieter-Identität authentifizieren, und fügt sie dann als nonce-Anspruch zum ID-Token hinzu. Die Implementierung des nonce-Anspruchs in Amazon Cognito basiert auf OIDC-Standards.

origin_jti

Eine Token-Widerrufs-ID, die dem Aktualisierungstoken Ihres Benutzers zugeordnet ist. Amazon Cognito verweist auf den origin_jti Anspruch, wenn geprüft wird, ob Sie das Token Ihres Benutzers mit der Widerrufen des Endpunkts oder der RevokeTokenAPI-Operation gesperrt haben. Wenn Sie ein Token widerrufen, macht Amazon Cognito alle Zugriffs- und ID-Token mit demselben origin_jti-Wert ungültig.

cognito:roles

Ein Array von Zeichenfolgen. Jede Zeichenfolge ist der ARN einer IAM-Rolle, die einer Ihrer Benutzergruppen zugeordnet ist. Jeder Benutzerpoolgruppe kann eine einzelne IAM-Rolle zugeordnet werden. Dieses Array stellt alle IAM-Rollen für die Gruppen Ihrer Benutzer dar, unabhängig von ihrer Rangfolge, und ist immer ein Array, auch wenn es eine einzelne Rolle enthält. Weitere Informationen finden Sie unter Hinzufügen von Gruppen zu einem Benutzerpool.

aud

Eine einzelne Zeichenfolge. Der Benutzerpool-App-Client, der Ihren Benutzer authentifiziert hat. Amazon Cognito gibt den gleichen Wert im Zugriffstoken-Anspruch client_id wieder.

identities

Ein Array von -Objekten. Jedes Objekt beschreibt ein Identitätsanbieter-Profil eines Drittanbieters, das Sie mit dem Benutzer verknüpft haben, entweder durch Verbundanmeldung oder durch Verknüpfen eines Verbundbenutzers mit einem lokalen Profil. Jedes Objekt enthält die Felder userId (die eindeutige ID des Benutzers beim Anbieter),, providerName providerTypeissuer, primary und. dateCreated All diese Felder sind Zeichenketten mit zwei Serialisierungsdetails, die sorgfältig analysiert werden müssen: primary ist die Zeichenfolge "true" oder"false", kein boolescher JSON-Wert, und dateCreated ist eine Zeichenfolge, die die Unix-Zeit in Millisekunden (zum Beispiel) angibt, keine Zahl. "1642699117273" Das Feld null kann sein. issuer Bei dieser Behauptung handelt es sich immer um ein Array, auch wenn der Benutzer über eine verknüpfte Identität verfügt.

token_use

Der vorgesehene Zweck des Tokens. In einem ID-Token ist der Wert id.

auth_time

Eine -Zahl. Die Authentifizierungszeit im Unix-Zeitformat, zu der Ihr Benutzer die Authentifizierung abgeschlossen hat.

exp

Eine -Zahl. Die Ablaufzeit im Unix-Zeitformat, zu der das Token Ihres Benutzers abläuft.

iat

Eine -Zahl. Der Ausstellungszeitpunkt im Unix-Zeitformat, zu dem Amazon Cognito das Token Ihres Benutzers ausgestellt hat.

jti

Die eindeutige Kennung des JWT.

email

Eine einzelne Zeichenfolge. Die E-Mail-Adresse Ihres Benutzers, wenn das email Attribut vorhanden und für den App-Client lesbar ist.

Das ID-Token kann OIDC-Standardansprüche enthalten, die in OIDC-Standardansprüchen definiert sind. Das ID-Token kann auch benutzerdefinierte Attribute enthalten, die Sie in Ihrem Benutzerpool definieren. Amazon Cognito schreibt benutzerdefinierte Attributwerte unabhängig vom Attributtyp als Strings in das ID-Token.

Anmerkung

Den benutzerdefinierten Attributen des Benutzerpools wird immer ein Präfix custom: vorangestellt.

Wie kann dieses Token sicher analysiert werden

Der in einem Amazon Cognito Cognito-ID-Token festgelegte Anspruch ist nicht behoben. Die Ansprüche, die ein Token mit sich bringt, variieren je nach Authentifizierungsablauf, Gruppenmitgliedschaft des Benutzers und Identitätsanbieter. Sie hängen auch von den Funktionen ab, die in Ihrem Benutzerpool aktiviert sind. Die OpenID Connect-Spezifikation erfordert nuriss,,sub, undaud, und expiat, und diese sind in jedem Amazon Cognito Cognito-ID-Token vorhanden. Amazon Cognito fügt token_use auch immer den Wert hinzuid, den Sie überprüfen sollten, um zu bestätigen, dass Sie ein ID-Token und kein Zugriffstoken erhalten haben. Behandeln Sie jeden anderen Anspruch als optional und abhängig davon, wie sich der Benutzer authentifiziert hat.

Das ID-Token ist einer von mehreren Amazon Cognito-Tokentypen, und für alle gelten dieselben Parsing-Regeln. Weitere Informationen zum sicheren Analysieren von Token finden Sie unter. Analysieren Sie Benutzerpool-Token sicher

Beispiel für ID-Token nach Szenario

Das Standard-Payload für ID-Tokens kombiniert viele optionale Ansprüche in einem einzigen Beispiel. In der Praxis hängen die Ansprüche, die ein Token mit sich bringt, davon ab, wie sich der Benutzer angemeldet hat. Die folgenden Beispiele zeigen die Anspruchskombinationen, die Amazon Cognito für vier gängige Szenarien ausgibt. Jedes Beispiel ist eine dekodierte Nutzlast, kein signiertes und serialisiertes JWT: Ein echtes Token ist base64url-codiert und enthält den header.payload.signature Schlüssel Ihres Benutzerpools. RS256-signed Die Wertesub, Benutzerpool-ID und Zeitstempel sind illustrative Platzhalter.

ID-Token für den Basisautorisierungscode

Das Identitätstoken, das die meisten Anwendungen verwenden, nachdem sie einen Autorisierungscode am Token-Endpunkt ausgetauscht haben. Der token_use Wert von id unterscheidet es von einem Zugriffstoken. Der nonce Anspruch liegt vor, weil der Client in der Autorisierungsanfrage einen nonce Parameter gesendet hat, um Replay-Angriffe zu verhindern.

{ "sub": "a1b2c3d4-5678-90ab-cdef-1234567890ab", "iss": "https://cognito-idp.us-east-1.amazonaws.com/us-east-1_ExAmPlE", "aud": "6o7h8i9jexampleclientid", "cognito:username": "my-test-user", "email": "my-test-user@example.com", "email_verified": true, "origin_jti": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee", "token_use": "id", "auth_time": 1759345200, "iat": 1759345200, "exp": 1759348800, "jti": "11112222-3333-4444-5555-666677778888", "nonce": "n-0S6_WzA2Mj" }

Gruppen- und Rollenmitgliedschaft

Amazon Cognito fügt die Gruppen- und Rollenautorisierungsansprüche hinzu, wenn der Benutzer zu einer oder mehreren Benutzerpoolgruppen gehört. Die cognito:roles Ansprüche cognito:groups und sind Arrays. Lesen Sie sie als Arrays, auch wenn sie ein einzelnes Element enthalten. cognito:preferred_roleist eine einzelne Zeichenfolge.

{ "sub": "a1b2c3d4-5678-90ab-cdef-1234567890ab", "iss": "https://cognito-idp.us-east-1.amazonaws.com/us-east-1_ExAmPlE", "aud": "6o7h8i9jexampleclientid", "cognito:username": "my-test-user", "cognito:groups": ["admins", "beta-testers"], "cognito:roles": ["arn:aws:iam::111122223333:role/my-test-role"], "cognito:preferred_role": "arn:aws:iam::111122223333:role/my-test-role", "origin_jti": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee", "token_use": "id", "auth_time": 1759345200, "iat": 1759345200, "exp": 1759348800, "jti": "11112222-3333-4444-5555-666677778888" }

Föderierte Anmeldung

Ein Benutzer, der sich über einen externen Identitätsanbieter angemeldet hat, z. B. ein soziales Netzwerk oder einen SAML/OIDC Anbieter, trägt den identities Anspruch, in dem der Link zum externen Anbieter beschrieben wird.

{ "sub": "a1b2c3d4-5678-90ab-cdef-1234567890ab", "iss": "https://cognito-idp.us-east-1.amazonaws.com/us-east-1_ExAmPlE", "aud": "6o7h8i9jexampleclientid", "cognito:username": "LoginWithAmazon_amzn1.account.EXAMPLE", "identities": [ { "userId": "amzn1.account.EXAMPLE", "providerName": "LoginWithAmazon", "providerType": "LoginWithAmazon", "issuer": null, "primary": "true", "dateCreated": "1642699117273" } ], "origin_jti": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee", "token_use": "id", "auth_time": 1759345200, "iat": 1759345200, "exp": 1759348800, "jti": "11112222-3333-4444-5555-666677778888" }
Anmerkung

Sie befinden sich in jedem identities Objekt primary und dateCreated werden als Zeichenketten ("true"und"1642699117273") serialisiert, nicht als JSON-Boolesche Werte und Zahlen. Ein Vergleich wie identity.primary === true stillschweigend ergibt „falsch“. Wird primary als Zeichenfolge "true" oder und dateCreated als Zeichenfolge gelesen"false", die die Unix-Zeit in Millisekunden angibt.

Stärke der Authentifizierung (ACR und AMR)

Wenn Ihr Benutzerpool die Authentifizierungsebene meldet, die der Benutzer erreicht hat, fügt Amazon Cognito die acr und amr -Ansprüche hinzu. Das folgende Token stammt von einem Benutzer, der sich mit einem Passwort und einem TOTP von einer Authenticator-App authentifiziert hat, was der höchsten Stufe entspricht. Jedes Token enthält genau eine der möglichen Stufen. acr Informationen zu den festen Stufen, zu den Faktorkombinationen, die jeder Stufe entsprechen, und zur vollständigen amr Werteliste finden Sie unterAuthentifizierungsstufen mit ACR- und AMR-Ansprüchen.

{ "sub": "a1b2c3d4-5678-90ab-cdef-1234567890ab", "iss": "https://cognito-idp.us-east-1.amazonaws.com/us-east-1_ExAmPlE", "aud": "6o7h8i9jexampleclientid", "cognito:username": "my-test-user", "acr": "urn:cognito:loa:4", "amr": ["pwd", "otp", "mfa"], "origin_jti": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee", "token_use": "id", "auth_time": 1759345200, "iat": 1759345200, "exp": 1759348800, "jti": "11112222-3333-4444-5555-666677778888" }

Für die Anforderung einer Authentifizierungsebene ist der Featureplan Essentials oder Plus erforderlich. Die amr Ansprüche acr und werden von Amazon Cognito berechnet und können nicht durch einen Lambda-Trigger vor der Token-Generierung geändert werden. Die Übersetzung der Amazon Cognito Cognito-Stufen in einen anderen Standard wie NIST oder eIDAS liegt in der Verantwortung Ihrer Anwendung.

ID-Token-Signatur

Die Signatur des ID-Tokens wird basierend auf dem Header und der Nutzlast des JWT-Tokens berechnet. Bevor Sie die Ansprüche in einem von Ihrer App empfangenen ID-Token akzeptieren, überprüfen Sie die Signatur des Tokens. Weitere Informationen finden Sie unter Überprüfen eines JSON-Web-Tokens. Überprüfung von JSON-Web-Tokens.