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)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.
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
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.WichtigAmazon Cognito generiert
subin einem Cognito-specific Amazon-Format, das keinem bestimmten UUID-Format entspricht, einschließlich RFC-UUID. Sie sollten das Format von nicht strikt validieren.subAllgemeiner 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-Endpunktauthorizehinzufügen können. Wenn Sie den Parameter hinzufügen, wird dernonce-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 keinennonce-Wert angeben, generiert und validiert Amazon Cognito automatisch eine Nonce, wenn Sie sich über eine Drittanbieter-Identität authentifizieren, und fügt sie dann alsnonce-Anspruch zum ID-Token hinzu. Die Implementierung desnonce-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_jtiAnspruch, 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 demselbenorigin_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_idwieder. 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),,providerNameproviderTypeissuer,primaryund.dateCreatedAll diese Felder sind Zeichenketten mit zwei Serialisierungsdetails, die sorgfältig analysiert werden müssen:primaryist die Zeichenfolge"true"oder"false", kein boolescher JSON-Wert, unddateCreatedist eine Zeichenfolge, die die Unix-Zeit in Millisekunden (zum Beispiel) angibt, keine Zahl."1642699117273"Das Feldnullkann sein.issuerBei 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
emailAttribut vorhanden und für den App-Client lesbar ist.
Das ID-Token kann OIDC-Standardansprüche enthalten, die in OIDC-Standardansprüchen
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" }
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.