Arten von Tokens

Cloud de Confiance by S3NS verwendet mehrere Arten von Tokens für die Authentifizierung. Sie können diese Arten von Tokens nach ihrem Zweck und den Parteien kategorisieren, zwischen denen sie ausgetauscht werden.

Tokenkategorie Kommunikationspfad Zweck
Zugriffstokens Autorisierungsserver ⭢ Client ⭢ Google API Ermöglicht Clients, Cloud de Confiance by S3NS -APIs aufzurufen.
Token-Granting-Tokens Autorisierungsserver ⭤ Client Ermöglicht es Clients, neue oder andere Tokens zu erhalten, möglicherweise zu einem späteren Zeitpunkt.
Identitätstokens Autorisierungsserver ⭢ Client Ermöglicht es Clients, den Nutzer zu identifizieren, mit dem sie interagieren.

Die meisten Zugriffs- und Identitätstokens sind Inhabertokens. Inhabertokens gewähren der Partei, die im Besitz des Tokens ist, Zugriff, unabhängig davon, wie sie das Token erhalten hat. Wenn ein böswilliger Akteur ein Inhabertoken abfängt, kann er es verwenden, um unbefugten Zugriff zu erhalten.

Gebundene Tokens gewähren Zugriff auf einen bestimmten Client. Um ein gebundenes Token zu verwenden, muss ein Client einen zusätzlichen Nachweis erbringen, dass er der rechtmäßige Inhaber des Tokens ist. Gebundene Tokens sind daher restriktiver als Inhabertokens und können dazu beitragen, das Risiko eines Tokendiebstahls zu verringern.

Zugriffstokens

Mit Zugriffstokens können Clients authentifizierte Aufrufe an Cloud de Confiance by S3NS APIs senden.Cloud de Confiance by S3NS unterstützt mehrere verschiedene Arten von Zugriffstokens, die die folgenden Eigenschaften gemeinsam haben:

  • Sie authentifizieren ein Hauptkonto, das ein Nutzer oder eine Arbeitslast sein kann.

  • Sie werden für einen bestimmten Kunden ausgestellt.

  • Sie sind kurzlebig und laufen nach höchstens einigen Stunden ab.

  • Sie sind auf bestimmte OAuth-Bereiche, Endpunkte oder Ressourcen beschränkt. Das bedeutet, dass ein Zugriffstoken in der Regel nicht Zugriff auf alle Ressourcen eines Nutzers gewährt, sondern nur auf eine bestimmte Teilmenge davon.

Zugriffstokens können sich in folgenden Punkten unterscheiden:

  • Aussteller: Die Partei, die das Token ausstellt.

  • Hauptkonto: Der Typ des Hauptkontos, das das Token authentifizieren kann.

  • Einschränkungen: Die Einschränkungen, die für das Token gelten können.

In der folgenden Tabelle sind die verschiedenen Arten von Zugriffstokens aufgeführt:

Tokentyp Aussteller Hauptkonten Beschränkungen
Dienstkonto-Zugriffstoken Cloud de Confiance by S3NS IAM-Autorisierungsserver Dienstkonto OAuth-Bereich
JSON Web Token (JWT) für Dienstkonto Kunde Dienstkonto OAuth-Bereich oder API
Föderiertes Zugriffstoken Cloud de Confiance by S3NS IAM-Autorisierungsserver
  • Hauptkonto des Mitarbeiteridentitätspools
  • Workload Identity-Pool-Hauptkonto
OAuth-Bereich
Zugriffstoken für die Identität des KI-Agenten Cloud de Confiance by S3NS IAM-Autorisierungsserver Prinzipal der KI-Agentenidentität OAuth-Bereich
Token für Zugriffsbeschränkung für Anmeldedaten Cloud de Confiance by S3NS IAM-Autorisierungsserver
  • Nutzer (verwalteter Nutzer)
  • Nutzer (Privatnutzerkonto)
  • Dienstkonto
Bestimmte Cloud Storage-Objekte
Vom Client ausgestelltes Zugriffsgrenzen-Token für Anmeldedaten Kunde Dienstkonto Bestimmte Cloud Storage-Objekte

Die verschiedenen Arten von Zugriffstokens weisen auch unterschiedliche Sicherheitseigenschaften auf:

  • Format: Einige Zugriffstokens sind intransparent, d. h. sie haben ein proprietäres Format und können nicht geprüft werden. Andere Tokens sind als JSON Web Token codiert, die vom Client decodiert werden können.
  • Gültigkeitsdauer: Tokens unterscheiden sich in ihrer Gültigkeitsdauer und darin, inwieweit sie geändert werden können.
  • Widerrufbarkeit: Einige Tokens können widerrufen werden. Andere Tokens bleiben bis zum Ablauf gültig.
  • Bindung: Einige Tokens können optional an zusätzliche Anmeldedaten gebunden werden, wodurch sie zu gebundenen Tokens werden.

In der folgenden Tabelle sind die Unterschiede zwischen den Zugriffstokentypen zusammengefasst.

Tokentyp Format Introspektierbar Lebensdauer Widerruflich Bindung
Dienstkonto-Zugriffstoken Undurchsichtig Nein 5 Minuten bis 12 Stunden Nein
JSON Web Token (JWT) für Dienstkonto JWT – 5 Minuten bis 1 Stunde Nein
Föderiertes Zugriffstoken Undurchsichtig Nein Siehe Föderierte Zugriffstokens Nein
Zugriffstoken für die Identität des KI-Agenten Undurchsichtig Nein Siehe Zugriffstokens für die Agentenidentität Nein X.509-Clientzertifikat
Token für die Zugriffsgrenze für Anmeldedaten Undurchsichtig Nein Weitere Informationen finden Sie unter Tokens für Anmeldedaten-Zugriffsgrenzen. Nein
Vom Client ausgestelltes Zugriffsgrenzen-Token für Anmeldedaten Undurchsichtig Nein – Nein

Dienstkonto-Zugriffstokens

Dienstkonto-Zugriffstokens sind Inhabertokens, die ein Dienstkonto authentifizieren. Die Tokens sind intransparentgeprüft werden.

Für ein Dienstkonto-Zugriffstoken gibt die API eine Ausgabe ähnlich dem folgenden Beispiel zurück:

{
  "azp": "000000000000000000000",
  "aud": "000000000000000000000",
  "scope": "https://www.googleapis.com/auth/userinfo.email",
  "exp": "1744687132",
  "expires_in": "3568",
  "email": "service-account@example.s3ns.iam.gserviceaccount.com",
  "email_verified": "true",
  "access_type": "online"
}

Ein Dienstkonto-Token enthält die folgenden Felder:

Feld Name Beschreibung
aud Zielgruppe Das Dienstkonto, für das das Token gilt, entspricht der autorisierten Partei.
azp Bevollmächtigter Das Dienstkonto, das das Token angefordert hat, identifiziert durch seine eindeutige ID.
email Primäre E-Mail-Adresse

Die E-Mail-Adresse des Dienstkontos.

Dieses Feld ist nur vorhanden, wenn das Token den Bereich https://www.googleapis.com/auth/userinfo.email enthält.

exp Ablaufdatum Die Ablaufzeit des Tokens im Unix-Epochenzeitformat.

Zugriffstokens für Dienstkonten können nicht widerrufen werden und bleiben gültig, bis sie ablaufen.

Standardmäßig laufen Zugriffstokens für Dienstkonten nach einer Stunde ab. Mit der Methode serviceAccounts.generateAccessToken können Sie Tokens mit unterschiedlichen Lebensdauern anfordern. Da eine längere Token-Lebensdauer das Risiko erhöhen kann, müssen Sie die Einschränkung iam.allowServiceAccountCredentialLifetimeExtension konfigurieren, damit Clients Zugriffstokens für Dienstkonten mit einer Lebensdauer von mehr als einer Stunde anfordern können.

JSON Web Tokens für Dienstkonten

JSON Web Tokens (JWTs) für Dienstkonten sind Inhabertokens, die ein Dienstkonto authentifizieren. Während Dienstkonto-Zugriffstokens von einem Autorisierungsserver ausgestellt werden, können Dienstkonto-JWTs vom Client selbst ausgestellt werden.

Manchmal werden diese als „selbst signierte“ JWTs bezeichnet. Sie können nützlich sein, wenn Sie sich bei einigen Google APIs authentifizieren müssen, ohne ein Zugriffstoken vom Autorisierungsserver abzurufen, z. B. beim Erstellen eigener Clientbibliotheken.

Um ein Dienstkonto-JWT auszustellen, müssen Clients die folgenden Schritte ausführen:

  1. Bereiten Sie eine JSON Web Signature-Nutzlast vor, die die E-Mail-Adresse des Dienstkontos, einen OAuth-Bereich oder API-Endpunkt und eine Ablaufzeit enthält.

  2. Signieren Sie die Nutzlast mit einem Dienstkontoschlüssel des jeweiligen Dienstkontos. Clients können die Nutzlast offline mit einem nutzerverwalteten Dienstkontoschlüssel oder online mit der Methode signJwt und einem von Google verwalteten Dienstkontoschlüssel signieren. Weitere Informationen finden Sie unter Selbst signiertes JSON Web Token erstellen.

Ein decodiertes Dienstkonto-JWT sieht in etwa so aus, wobei SIGNATURE durch die Signatur des Tokens ersetzt wird:

{
  "alg": "RS256",
  "kid": "290b7bf588eee0c35d02bf1164f4336229373300",
  "typ": "JWT"
}.{
  "iss": "service-account@example.s3ns.iam.gserviceaccount.com",
  "sub": "service-account@example.s3ns.iam.gserviceaccount.com",
  "scope": "https://www.googleapis.com/auth/cloud-platform",
  "exp": 1744851267,
  "iat": 1744850967
}.SIGNATURE

Anstatt einen OAuth-Bereich im Schlüssel scope anzugeben, kann ein Dienstkonto-JWT einen API-Endpunkt im Schlüssel aud angeben:

{
  "alg": "RS256",
  "kid": "290b7bf588eee0c35d02bf1164f4336229373300",
  "typ": "JWT"
}.{
  "iss": "service-account@example.s3ns.iam.gserviceaccount.com",
  "sub": "service-account@example.s3ns.iam.gserviceaccount.com",
  "aud": "https://cloudresourcemanager.s3nsapis.fr/",
  "exp": 1744854799,
  "iat": 1744851199
}.SIGNATURE

Ein Dienstkonto-JWT enthält die folgenden Felder:

Feld Name Beschreibung
aud Zielgruppe API-Endpunkte, auf die der Client zugreifen darf. Nur gültig, wenn scope nicht angegeben ist.
exp Ablaufdatum Die Ablaufzeit des Tokens im Unix-Epochenzeitformat.
iat Zeitpunkt des Problems Der Zeitpunkt, zu dem das Token ausgestellt wurde, im Unix-Epochenzeitformat.
iss Aussteller Der Aussteller des Tokens, also das Dienstkonto selbst.
scope OAuth-Bereiche Die APIs, auf die der Client zugreifen darf, identifiziert durch den OAuth-Bereich. Nur gültig, wenn aud nicht angegeben ist.
sub Betreff Authentifiziertes Hauptkonto, das das Dienstkonto selbst ist.

Dienstkonto-JWTs können bis zu einer Stunde gültig sein und nicht widerrufen werden.

Föderierte Zugriffstokens

Föderierte Zugriffstokens sind Inhabertokens, die ein Hauptkonto eines Workforce Identity-Pools oder ein Hauptkonto eines Workload Identity-Pools authentifizieren.

Mit der Workforce Identity-Föderation können Clients ein externes Token gegen ein föderiertes Zugriffstoken austauschen, das ein Hauptkonto im Workforce-Pool authentifiziert. Das Hauptkonto des Mitarbeiteridentitätspools wird durch eine Hauptkonto-ID wie die folgende identifiziert:

principal://iam.googleapis.com/locations/global/workforcePools/POOL/subject/raha@altostrat.com.

Mit der Workload Identity-Föderation können Clients ein externes Token gegen ein föderiertes Zugriffstoken austauschen, das ein Workload-Pool-Hauptkonto authentifiziert. Das Hauptkonto des Workload Identity-Pools wird durch eine Hauptkonto-ID wie die folgende identifiziert:

principal://iam.googleapis.com/projects/PROJECT/locations/global/workloadIdentityPools/POOL/subject/SUBJECT_ATTRIBUTE_VALUE

Föderierte Zugriffstokens sind intransparent und können nicht geprüft werden. Die Tokens können nicht widerrufen werden und bleiben bis zum Ablauf gültig. Die Ablaufzeiten für die einzelnen Tokentypen sind so festgelegt:

  • Die Workforce Identity-Föderation legt den Tokenablauf auf den kleineren der folgenden beiden Werte fest:

    • Verbleibende Zeit bis zum Ablauf der Workforce Identity Federation-Sitzung

    • 1 Stunde

    Der Ablauf der Workforce Identity-Föderationssitzung wird anhand der Anmeldezeit und der für den Workforce Identity-Föderationspool konfigurierten Sitzungsdauer bestimmt.

  • Die Workload Identity-Föderation legt den Tokenablauf so fest, dass er mit dem Ablauf des externen Tokens übereinstimmt.

Zugriffstokens für KI-Agentenidentitäten

Mit Zugriffstokens für KI-Agentenidentitäten wird ein KI-Agent authentifiziert, dem eine KI-Agentenidentität zugewiesen wurde. Dabei wird eine Hauptkontokennung wie die folgende verwendet:

principal://agents.global.org-ORGANIZATION_ID.system.id.goog/resources/aiplatform/projects/PROJECT_NUMBER/locations/us-central1/reasoningEngines/REASONING_ENGINE_ID

Die Hauptkonto-ID basiert auf der SPIFFE-ID des X.509-Clientzertifikats des Agents, verwendet jedoch das Präfix principal:// anstelle von spiffe://.

Ein Agent kann ein Zugriffstoken für die Agent-Identität vom Compute Engine-Metadatenserver abrufen. Optional kann der Agent anfordern, dass das Token an sein X.509-Clientzertifikat gebunden wird. Ein Zugriffstoken für eine gebundene Agentenidentität ist nur gültig, wenn es über eine gegenseitige TLS-Verbindung verwendet wird, die mit dem X.509-Clientzertifikat authentifiziert wird, an das das Token gebunden wurde.

Wie föderierte Zugriffstokens sind Zugriffstokens für Agentenidentitäten intransparent, können nicht geprüft oder widerrufen werden und bleiben bis zum Ablauf gültig. Standardmäßig sind Zugriffstokens für die Agent-Identität eine Stunde lang gültig. Die Gültigkeit eines Tokens kann jedoch kürzer sein, wenn es an ein X.509-Clientzertifikat gebunden ist, das bald abläuft.

Tokens für Zugriffsgrenzen für Anmeldedaten

Tokens für die Zugriffsbegrenzung von Anmeldedaten sind Inhabertokens, die einen Nutzer oder ein Dienstkonto authentifizieren und eine Zugriffsbegrenzung enthalten. Durch die Zugriffsgrenze wird das Token so eingeschränkt, dass es nur für den Zugriff auf eine definierte Teilmenge von Cloud Storage-Ressourcen verwendet werden kann.

Tokens für die Zugriffsbeschränkung von Anmeldedaten werden manchmal als eingeschränkt bezeichnet, da sie von einem Eingabetoken abgeleitet sind, aber die Ressourcen, auf die sie Zugriff gewähren, stärker eingeschränkt sind.

Der Ablauf von Zugriffsbegrenzungstokens für Anmeldedaten wird vom Ablauf des Eingabetokens abgeleitet, das ein Dienstkonto-Zugriffstoken sein kann. Tokens für Zugriffsbeschränkungen für Anmeldedaten sind undurchsichtig und können nicht geprüft oder widerrufen werden.

Vom Client ausgestellte Zugriffsgrenzen-Tokens für Anmeldedaten

Vom Client ausgestellte Zugriffsbegrenzungstokens für Anmeldedaten ähneln Zugriffsbegrenzungstokens für Anmeldedaten, sind aber für Szenarien optimiert, in denen Clients Zugriffsbegrenzungstokens für Anmeldedaten mit unterschiedlichen Zugriffsbegrenzungen in hoher Frequenz abrufen müssen.

Clients können lokal vom Client ausgestellte Zugriffsbegrenzungstokens für Anmeldedaten erstellen. Dazu verwenden sie die Cloud-Clientbibliotheken und ein Zwischen-Zugriffsbegrenzungstoken, das sie regelmäßig aktualisieren müssen.

Vom Client ausgestellte Zugriffsbeschränkungstokens für Anmeldedaten sind intransparent und können nicht geprüft oder widerrufen werden.

Token-granting Tokens

Mit Token-Granting-Tokens können Clients neue oder andere Tokens abrufen, möglicherweise zu einem späteren Zeitpunkt. Cloud de Confiance by S3NS unterstützt mehrere verschiedene Arten von Token-Granting-Tokens, die alle Folgendes gemeinsam haben:

  • Sie stehen für eine vorherige Authentifizierung.

  • Sie authentifizieren ein Hauptkonto, das eine Google-Identität (ein Nutzer oder eine Arbeitslast) oder eine externe Identität sein kann.

  • Sie können gegen ein Zugriffstoken eingelöst werden.

  • Sie können nicht für Google API-Aufrufe verwendet werden, was sie von Zugriffstokens unterscheidet.

Token-Granting-Tokens können sich in folgenden Punkten unterscheiden:

  • Aussteller: Die Partei, die das Token ausstellt.

  • Hauptkonto: Der Typ der Hauptkontoidentität, die das Token authentifizieren kann.

  • Einschränkungen: Die Einschränkungen, die für das Token gelten können.

In der folgenden Tabelle sind die verschiedenen Arten von Token-Granting-Tokens aufgeführt.

Tokentyp Aussteller Typ des eingelösten Zugriffstokens Hauptkonten Beschränkungen
Föderiertes Aktualisierungstoken Cloud de Confiance by S3NS IAM-Autorisierungsserver Föderiertes Zugriffstoken Hauptkonto des Mitarbeiteridentitätspools OAuth-Bereich
Föderierter Autorisierungscode Cloud de Confiance by S3NS IAM-Autorisierungsserver Föderiertes Zugriffstoken Hauptkonto des Mitarbeiteridentitätspools OAuth-Bereich
Externes JSON-Webtoken Externer Identitätsanbieter Föderiertes Zugriffstoken Externes Hauptkonto Keine
Externe SAML-Assertion oder -Antwort Externer Identitätsanbieter Föderiertes Zugriffstoken Externes Hauptkonto Keine
Amazon Web Services (AWS) GetCallerIdentity-Token Externer Identitätsanbieter Föderiertes Zugriffstoken Externes Hauptkonto Keine

Die verschiedenen Arten von Token-ausstellenden Tokens weisen auch unterschiedliche Sicherheitseigenschaften auf:

  • Format: Einige Tokens sind intransparent. Andere Tokens können vom Client decodiert werden.

  • Gültigkeitsdauer: Tokens unterscheiden sich in ihrer Gültigkeitsdauer und darin, inwieweit sie geändert werden können.

  • Mehrfachverwendung: Einige Token-ausstellende Token können nur einmal verwendet werden. Andere Tokens können mehrmals verwendet werden.

  • Widerrufbarkeit: Einige Tokens können widerrufen werden. Andere Tokens bleiben bis zum Ablauf gültig.

  • Bindung: Einige Tokens sind an zusätzliche Anmeldedaten gebunden, was sie zu gebundenen Tokens macht. Andere Tokens sind nicht gebunden, was sie zu Inhabertokens macht.

In der folgenden Tabelle sind die Unterschiede zwischen diesen Attributen für Token-Granting-Tokens zusammengefasst:

Tokentyp Format Lebensdauer Widerruflich Mehrfachnutzung Bindung
Föderiertes Aktualisierungstoken Undurchsichtig Variiert, siehe Föderierte Aktualisierungstokens Nein Ja OAuth-Client-Anmeldedaten
Föderierter Autorisierungscode Undurchsichtig 10 Minuten Nein Nein OAuth-Client-Anmeldedaten
Externes Token oder externes JSON Web Token JWT Abhängig vom Identitätsanbieter Abhängig vom Identitätsanbieter Ja
Externe SAML-Assertion oder -Antwort SAML Abhängig vom Identitätsanbieter Abhängig vom Identitätsanbieter Ja
Amazon Web Services (AWS) GetCallerIdentity-Token Text-Blob Abhängig vom Identitätsanbieter Abhängig vom Identitätsanbieter Ja

Föderierte Aktualisierungstokens

Föderierte Aktualisierungstokens sind intransparente Tokens, mit denen Clients Zugriffstokens für ein Hauptkonto eines Workforce Identity-Pools abrufen können, wenn der Nutzer zuvor einen Client autorisiert hat, in seinem Namen zu handeln.

Wie Aktualisierungstokens sind föderierte Aktualisierungstokens an einen bestimmten Client gebunden und können nur in Kombination mit gültigen Clientanmeldedaten verwendet werden, z. B. einer Client-ID und einem Clientschlüssel.

Im Gegensatz zu Aktualisierungstokens können föderierte Aktualisierungstokens nicht widerrufen werden. Die Lebensdauer eines föderierten Aktualisierungstokens ist mit der Workforce Identity-Sitzung verknüpft, die zum Abrufen des Tokens verwendet wurde, und bleibt gültig, bis die Sitzung abläuft.

Föderierte Autorisierungscodes

Wie Autorisierungscodes sind föderierte Autorisierungscodes intransparente, kurzlebige Tokens. Die Codes sind nur für die Verwendung während der Nutzerauthentifizierung als Vermittler zwischen dem Client und dem Cloud de Confiance by S3NS IAM-Autorisierungsserver vorgesehen.

Autorisierungscodes sind an einen Client gebunden, können nur in Kombination mit gültigen Clientanmeldedaten verwendet werden und sind nur einmal gültig.

Externe JSON Web Tokens

Externe JSON Web Tokens (JWTs) werden von einem externen Identitätsanbieter wie Microsoft Entra ID, Okta, Kubernetes oder GitHub ausgestellt. Sie können sich in Struktur und Inhalt unterscheiden.

Wenn Sie die Workforce Identity-Föderation oder die Workload Identity-Föderation konfigurieren, können Sie eine Vertrauensbeziehung zwischen Cloud de Confiance by S3NS und einem externen Identitätsanbieter einrichten. Arbeitslasten können dann externe JWTs als Token-Granting-Tokens verwenden, um föderierte Zugriffstokens zu erhalten.

Wenn Sie die Mitarbeiteridentitätsföderation verwenden, authentifiziert das resultierende föderierte Zugriffstoken ein Hauptkonto im Workforce-Identitätspool.

Wenn Sie die Workload Identity-Föderation verwenden, authentifiziert das resultierende föderierte Zugriffstoken ein Hauptkonto des Workload Identity-Pools.

In beiden Fällen wird die Hauptkonto-ID von einer oder mehreren Anforderungen des externen JWT abgeleitet.

Damit externe JWTs mit der Workforce Identity-Föderation oder der Workload Identity-Föderation kompatibel sind, müssen sie bestimmte Anforderungen erfüllen.

Externe SAML-Assertions oder -Antworten

Externe Security Assertion Markup Language-Assertions (SAML) sind SAML 2.0-Assertions, die von einem externen Identitätsanbieter wie Microsoft Entra ID, Okta oder Active Directory Federation Services ausgestellt werden. Diese externen SAML-Assertions können optional in einer SAML 2.0-Antwort enthalten oder verschlüsselt sein.

Wie bei externen JSON Web Tokens können Sie die Workforce Identity-Föderation oder die Workload Identity-Föderation so konfigurieren, dass Arbeitslasten externe SAML-Assertions oder -Antworten als Token-Granting-Tokens verwenden können, um föderierte Zugriffstokens zu erhalten.

Damit externe SAML-Assertions mit der Workforce Identity-Föderation oder der Workload Identity-Föderation kompatibel sind, müssen sie bestimmte Anforderungen erfüllen.

Amazon Web Services (AWS) GetCallerIdentity-Token

Externe AWS-GetCallerIdentity-Tokens sind Textblobs, die eine signierte Anfrage an die AWS-GetCallerIdentity API enthalten. Ähnlich wie bei externen JSON Web Tokenskönnen Sie die Workforce Identity-Föderation oder die Workload Identity-Föderation so konfigurieren, dass Arbeitslasten diese Textblobs als Token-Granting-Token verwenden können, um föderierte Zugriffstokens zu erhalten.

Identitätstokens

Mit Identitätstokens (ID-Tokens) können Clients den Nutzer identifizieren, mit dem sie interagieren. Cloud de Confiance by S3NS unterstützt mehrere verschiedene Arten von Identitätstokens, die alle Folgendes gemeinsam haben:

  • Sie sind signiert, aber nicht verschlüsselt, sodass sie vom Client decodiert, verifiziert und interpretiert werden können.

  • Sie authentifizieren ein Hauptkonto, das ein Nutzer oder eine Arbeitslast sein kann.

  • Sie werden für einen bestimmten Kunden ausgestellt.

  • Sie sind kurzlebig und laufen nach höchstens einer Stunde ab.

  • Sie sind nicht widerruflich.

  • Sie können nicht für Google API-Aufrufe verwendet werden, was sie von Zugriffstokens unterscheidet.

  • Sie können nicht zum Abrufen von Zugriffstokens verwendet werden, was sie von Token-Granting-Tokens unterscheidet.

  • Sie können verwendet werden, um Aufrufe zwischen Mikrodiensten zu authentifizieren oder um sich programmatisch bei Identity-Aware Proxy (IAP) zu authentifizieren.

Identitätstokens können sich in folgenden Punkten unterscheiden:

  • Zielgruppe: Die Partei, die das Token decodieren und nutzen soll.

  • Aussteller: Die Partei, die das Token ausstellt.

  • Hauptkonto: Der Typ der Hauptkontoidentität, die das Token authentifizieren kann.

In der folgenden Tabelle sind die verschiedenen Arten von Identitätstokens aufgeführt.

Tokentyp Aussteller Zielgruppe Hauptkonto
Dienstkonto-ID-Token Cloud de Confiance by S3NS IAM-Autorisierungsserver Unbeschränkte Wahl der Zielgruppe Dienstkonto
ID-Token für die Identität von KI-Agenten Cloud de Confiance by S3NS IAM-Autorisierungsserver Flexible Wahl der Zielgruppe Agentenidentität
Identity-Aware Proxy (IAP)-Assertion IAP
  • Backend
  • App Engine-App
  • Nutzer (verwalteter Nutzer)
  • Nutzer (Privatnutzerkonto)
  • Hauptkonto des Mitarbeiteridentitätspools

Die verschiedenen Arten von Identitätstokens weisen auch unterschiedliche Sicherheitseigenschaften auf:

  • Format: Einige Tokens sind JSON Web Tokens (JWT), andere verwenden die XML-Formatierung.

  • Lebensdauer: Tokens haben unterschiedliche Lebensdauern.

  • Bindung: Einige Tokens können optional an zusätzliche Anmeldedaten gebunden werden, wodurch sie zu gebundenen Tokens werden.

In der folgenden Tabelle werden die Unterschiede zwischen den Identitätstokentypen zusammengefasst.

Tokentyp Format Lebensdauer Bindung
Dienstkonto-ID-Token JWT 1 Stunde
ID-Token für die Identität von KI-Agenten JWT 1 Stunde X.509-Clientzertifikat
Identity-Aware Proxy (IAP)-Assertion JWT 10 Minuten

Dienstkonto-ID-Tokens

Dienstkonto-ID-Tokens sind JSON Web Tokens (JWTs), die ein Dienstkonto authentifizieren.

Im Gegensatz zu Dienstkonto-JWTs und Dienstkonto-JWT-Assertions werden Dienstkonto-ID-Tokens nicht von einem Dienstkontoschlüssel signiert. Stattdessen werden Dienstkonto-ID-Tokens vom Google JSON Web Key Set (JWKS) signiert.

Ein decodiertes Dienstkonto-ID-Token sieht in etwa so aus, wobei SIGNATURE durch die Signatur des Tokens ersetzt wird:

{
  "alg": "RS256",
  "kid": "c37da75c9fbe18c2ce9125b9aa1f300dcb31e8d9",
  "typ": "JWT"
}.{
  "aud": "example-audience",
  "azp": "112010400000000710080",
  "email": "service-account@example.s3ns.iam.gserviceaccount.com",
  "email_verified": true,
  "exp": 1745365618,
  "iat": 1745362018,
  "iss": "https://accounts.google.com",
  "sub": "112010400000000710080"
}.SIGNATURE

Ein Dienstkonto-ID-Token enthält die folgenden Felder:

Feld Name Beschreibung
aud Zielgruppe Kennung der Partei, für die dieses Token bestimmt ist. Der Wert kann vom Token-Anforderer frei gewählt werden.
azp Bevollmächtigter Das Dienstkonto, das das Token angefordert hat, identifiziert durch seine eindeutige ID.
exp Ablaufdatum Die Ablaufzeit des Tokens im Unix-Epochenzeitformat.
iss Aussteller Der Aussteller des Tokens, immer auf https://accounts.google.com festgelegt.
sub Betreff Das Dienstkonto, das das Token angefordert hat, identifiziert durch seine eindeutige ID.

Die genauen Anforderungen, die in einem ID-Token enthalten sind, hängen davon ab, wie das ID-Token angefordert wird. Beispiel: ID-Tokens, die vom Compute Engine-Metadatenserver angefordert werden, können optional zusätzliche Anforderungen enthalten, die die Identität der VM bestätigen. ID-Tokens, die über die IAM Credentials API angefordert werden, können optional die Organisations-ID des Projekts des Dienstkontos enthalten.

Dienstkonto-ID-Tokens sind eine Stunde lang gültig und können nicht widerrufen werden.

ID-Tokens für KI-Agentenidentitäten

ID-Tokens für KI-Agentenidentitäten sind SPIFFE-verifizierbare Identitätsdokumente (JWT-SVID) und authentifizieren einen KI-Agenten, dem eine KI-Agentenidentität zugewiesen wurde.

Ein Agent kann ein ID-Token vom Compute Engine-Metadatenserver abrufen. Optional kann der Agent anfordern, dass das Token an sein X.509-Clientzertifikat gebunden wird. Ein ID-Token für eine gebundene Agentenidentität enthält den Fingerabdruck des X.509-Clientzertifikats in der Anforderung cnf.

Im Gegensatz zu Nutzer-ID-Tokens und Dienstkonto-ID-Tokens werden Agent-Identitäts-ID-Tokens nicht vom Google JSON Web Key Set (JWKS) signiert. Stattdessen werden ID-Tokens für Agent-Identitäten von einem JWKS signiert, das für einen Agent-Identitätspool spezifisch ist.

Ein decodiertes ID-Token für die Agentenidentität sieht in etwa so aus, wobei SIGNATURE durch die Signatur des Tokens ersetzt wird:

{
  "alg": "RS256",
  "kid": "78ab40e4a0319f9ced58024f5bb66e6387d68066",
  "typ": "JWT"
}.{
  "iss": "https://sts.googleapis.com/v1/organizations/1234567890/locations/global/workloadIdentityPools/agents.global.org-1234567890.system.id.goog",
  "sub": "spiffe://agents.global.org-1234567890.system.id.goog/resources/aiplatform/projects/1234567890/locations/us-central1/reasoningEngines/987654321",
  "aud": ["https://example.com/"],
  "iat": 1775776191,
  "exp": 1775779791,
  "cnf": {
    "x5t#S256": "QTB5TSHeDxHrzDzcrrHU+/shhkfCnARcBEvMldp2uis"
  }
}.SIGNATURE

Ein ID-Token für eine Agentenidentität enthält die folgenden Felder:

Feld Name Beschreibung
aud Zielgruppe Kennung der Partei, für die dieses Token bestimmt ist. Der Wert kann vom Token-Anforderer ausgewählt werden.
exp Ablaufdatum Die Ablaufzeit des Tokens im Unix-Epochenzeitformat.
iss Aussteller Der Aussteller des Tokens, d. h. der Agent-Identitätspool der Organisation oder des Projekts, die bzw. das den Agent enthält.
sub Betreff Die SPIFFE-ID des KI-Agenten.
cnf.x5t#S256 Bestätigung Der Fingerabdruck des X.509-Clientzertifikats, an das das Token gebunden ist. Die Anforderung ist leer, wenn das Token nicht gebunden ist.

Identity-Aware Proxy-Assertions

Identity-Aware Proxy (IAP)-Assertions sind JSON Web Tokens (JWTs), die IAP im HTTP-Anfrageheader x-goog-iap-jwt-assertion an IAP-geschützte Webanwendungen übergibt. IAP-Assertions authentifizieren einen Nutzer und dienen auch als Nachweis, dass eine Anfrage von IAP autorisiert wurde.

IAP-Assertions werden mit dem IAP-JWKS signiert. Dieses JWKS ist eine globale Ressource und die gleichen Signaturschlüssel werden für verschiedene Nutzertypen verwendet, darunter:

  • Verwaltete Nutzerkonten

  • Privatnutzerkonten

  • Dienstkonten

  • Hauptkonten von Workforce Identity-Pools

Eine decodierte IAP-Assertion sieht in etwa so aus, wobei SIGNATURE durch die Signatur des Tokens ersetzt wird:

{
  "alg": "ES256",
  "typ": "JWT",
  "kid": "4BCyVw"
}.{
  "aud": "/projects/0000000000/global/backendServices/000000000000",
  "azp": "/projects/0000000000/global/backendServices/000000000000",
  "email": "user@example.com",
  "exp": 1745374290,
  "google": {
    "access_levels": [
      "accessPolicies/0000000000/accessLevels/Australia"
    ]
  },
  "iat": 1745373690,
  "identity_source": "WORKFORCE_IDENTITY",
  "iss": "https://cloud.google.com/iap",
  "sub": "sts.google.com:AAFTZ...Q",
  "workforce_identity": {
    "iam_principal": "principal://iam.googleapis.com/locations/global/workforcePools/example/subject/user-0000000000",
    "workforce_pool_name": "locations/global/workforcePools/example"
  }
}.SIGNATURE

Eine IAP-Assertion enthält die folgenden Felder:

Feld Name Beschreibung
aud Zielgruppe Der Backend-Dienst, die App Engine-Anwendung oder der Cloud Run-Dienst, für den die IAP-Assertion vorgesehen ist.
iss Aussteller Der Aussteller des Tokens, immer auf https://cloud.google.com/iap festgelegt
sub Betreff

Das authentifizierte Hauptkonto, das durch seine eindeutige ID identifiziert wird.

Wenn IAP für die Verwendung von Google-Identitäten konfiguriert ist, entspricht diese ID der ID, die in der Directory API angezeigt wird.

Weitere Informationen zu den IAP-Assertion-Ansprüchen finden Sie unter JWT-Nutzlast prüfen.

IAP-Assertions sind 10 Minuten lang gültig und können nicht widerrufen werden.