| 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 |
|
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 |
|
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 |
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:
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.
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
signJwtund 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 |
|
|
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.
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.