Types de jetons

Cloud de Confiance by S3NS utilise plusieurs types de jetons pour l'authentification. Vous pouvez classer ces types de jetons en fonction de leur objectif et des parties entre lesquelles ils sont échangés.

Catégorie de jeton Chemin de communication Objectif
Jetons d'accès Serveur d'autorisation ⭢ Client ⭢ API Google Permet aux clients d'appeler les API Cloud de Confiance by S3NS .
Jetons d'octroi de jetons Serveur d'autorisation ⭤ Client Permet aux clients d'obtenir des jetons nouveaux ou différents, éventuellement à un moment ultérieur.
Jetons d'identité Serveur d'autorisation ⭢ Client Permet aux clients d'identifier l'utilisateur avec lequel ils interagissent.

La plupart des jetons d'accès et d'identité sont des jetons de support. Les jetons de support accordent l'accès à la partie en possession du jeton, quelle que soit la manière dont elle l'a obtenu. Si un acteur malintentionné intercepte un jeton de support, il peut l'utiliser pour obtenir un accès non autorisé.

Les jetons liés accordent l'accès à un client spécifique. Pour utiliser un jeton lié, un client doit fournir une preuve supplémentaire qu'il est le propriétaire légitime du jeton. Les jetons liés sont donc plus restrictifs que les jetons de support et peuvent aider à réduire le risque de vol de jetons.

Jetons d'accès

Les jetons d'accès permettent aux clients d'effectuer des appels authentifiés vers les API Cloud de Confiance by S3NS .Cloud de Confiance by S3NS accepte plusieurs types de jetons d'accès, qui ont les propriétés suivantes en commun :

  • Ils authentifient un compte principal, qui peut être un utilisateur ou une charge de travail.

  • Ils sont émis pour un client particulier.

  • Ils sont de courte durée et expirent au bout de quelques heures au maximum.

  • Ils sont limités à certains champs d'application, points de terminaison ou ressources OAuth. Cela signifie qu'un jeton d'accès n'accorde généralement pas l'accès à toutes les ressources d'un utilisateur, mais seulement à un sous-ensemble d'entre elles.

Les jetons d'accès peuvent différer de la manière suivante :

  • Émetteur : partie qui émet le jeton.

  • Compte principal : type de compte principal que le jeton peut authentifier.

  • Restrictions : restrictions pouvant être imposées au jeton.

Le tableau suivant liste les différents types de jetons d'accès :

Type de jeton Émetteur Comptes principaux Restrictions
Jeton d'accès du compte de service Cloud de Confiance by S3NS Serveur d'autorisation IAM Compte de service Habilitation OAuth
Jeton Web JSON (JWT) de compte de service Client Compte de service Champ d'application OAuth ou API
Jeton d'accès fédéré Cloud de Confiance by S3NS Serveur d'autorisation IAM
  • Compte principal du pool d'identités de personnel
  • Principal du pool d'identités de charge de travail
Habilitation OAuth
Jeton d'accès à l'identité de l'agent Cloud de Confiance by S3NS Serveur d'autorisation IAM Compte principal d'identité d'agent Habilitation OAuth
Jeton de limite d'accès aux identifiants Cloud de Confiance by S3NS Serveur d'autorisation IAM
  • Utilisateur (utilisateur géré)
  • Utilisateur (compte personnel)
  • Compte de service
Objets Cloud Storage spécifiques
Jeton de limite d'accès aux identifiants émis par le client Client Compte de service Objets Cloud Storage spécifiques

Les différents types de jetons d'accès présentent également des propriétés de sécurité différentes :

  • Format : certains jetons d'accès sont opaques, ce qui signifie qu'ils sont dans un format propriétaire et ne peuvent pas être inspectés. D'autres jetons sont encodés sous forme de jeton Web JSON, qui peut être décodé par le client.
  • Durée de vie : les jetons diffèrent par leur durée de vie et par la mesure dans laquelle ils peuvent être modifiés.
  • Révocabilité : certains jetons peuvent être révoqués. Les autres jetons restent valides jusqu'à leur expiration.
  • Liaison : certains jetons peuvent éventuellement être liés à un identifiant supplémentaire, ce qui en fait des jetons liés.

Le tableau suivant récapitule les différences entre les types de jetons d'accès.

Type de jeton Format Introspectable Durée de vie Réversible Liaison
Jeton d'accès au compte de service Opaque Non 5 minutes à 12 heures Non
Jeton Web JSON (JWT) de compte de service JWT N/A 5 minutes à 1 heure Non
Jeton d'accès fédéré Opaque Non Consultez Jetons d'accès fédérés. Non
Jeton d'accès de l'identité de l'agent Opaque Non Consultez Jetons d'accès d'identité d'agent. Non Certificat client X.509
Jeton de limite d'accès aux identifiants Opaque Non Voir Jetons de limite d'accès aux identifiants. Non
Jeton de limite d'accès aux identifiants émis par le client Opaque Non N/A Non

Jetons d'accès de compte de service

Les jetons d'accès de compte de service sont des jetons de support qui authentifient un compte de service. Les jetons sont opaques.

Pour un jeton d'accès de compte de service, l'API renvoie un résultat semblable à l'exemple suivant :

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

Un jeton de compte de service comprend les champs suivants :

Champ Name Description
aud Audience Compte de service auquel le jeton est destiné, équivalent à la partie autorisée.
azp Partie autorisée Compte de service qui a demandé le jeton, identifié par son ID unique.
email Adresse e-mail principale

Adresse e-mail du compte de service.

Ce champ n'est présent que si le jeton inclut le champ d'application https://www.googleapis.com/auth/userinfo.email.

exp Expiration Délai d'expiration du jeton, au format d'heure epoch Unix.

Les jetons d'accès des comptes de service ne peuvent pas être révoqués et restent valides jusqu'à leur expiration.

Par défaut, les jetons d'accès des comptes de service expirent au bout d'une heure. La méthode serviceAccounts.generateAccessToken vous permet de demander des jetons avec des durées de vie différentes. Étant donné que des durées de vie de jeton plus longues peuvent augmenter les risques, vous devez configurer la contrainte iam.allowServiceAccountCredentialLifetimeExtension pour permettre aux clients de demander des jetons d'accès de compte de service d'une durée de vie supérieure à une heure.

Jetons Web JSON de compte de service

Les jetons Web JSON (JWT) de compte de service sont des jetons de support qui authentifient un compte de service. Alors que les jetons d'accès de compte de service sont émis par un serveur d'autorisation, les jetons JWT de compte de service peuvent être émis par le client lui-même.

On parle parfois de jetons JWT "autosignés". Ils peuvent être utiles lorsque vous devez vous authentifier auprès de certaines API Google sans obtenir de jeton d'accès auprès du serveur d'autorisation, par exemple lorsque vous créez vos propres bibliothèques clientes.

Pour émettre un jeton JWT de compte de service, les clients doivent procéder comme suit :

  1. Préparez une charge utile de signature Web JSON incluant l'adresse e-mail du compte de service, un champ d'application OAuth ou un point de terminaison de l'API, ainsi qu'un délai d'expiration.

  2. Signez la charge utile à l'aide d'une clé de compte de service du compte de service respectif. Les clients peuvent signer la charge utile hors connexion à l'aide d'une clé de compte de service gérée par l'utilisateur, ou en ligne à l'aide de la méthode signJwt et d'une clé de compte de service gérée par Google. Pour en savoir plus, consultez Créer un jeton Web JSON autosigné.

Un jeton JWT de compte de service décodé ressemble à ce qui suit, avec SIGNATURE remplacé par la signature du jeton :

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

Au lieu de spécifier un champ d'application OAuth dans la clé scope, un jeton JWT de compte de service peut spécifier un point de terminaison de l'API dans la clé aud :

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

Un jeton JWT de compte de service inclut les champs suivants :

Champ Name Description
aud Audience Points de terminaison de l'API auxquels le client est autorisé à accéder. Valide uniquement si scope n'est pas spécifié.
exp Expiration Délai d'expiration du jeton, au format d'heure epoch Unix.
iat Heure du problème Heure à laquelle le jeton a été émis, au format d'heure epoch Unix.
iss Émetteur L'émetteur du jeton, qui est le compte de service lui-même.
scope Habilitations OAuth Ensemble d'API auxquelles le client est autorisé à accéder, identifié par le champ d'application OAuth. Valide uniquement si aud n'est pas spécifié.
sub Objet Le compte principal authentifié, qui est le compte de service lui-même.

Les jetons JWT de compte de service peuvent être valides pendant une heure maximum et ne peuvent pas être révoqués.

Jetons d'accès fédérés

Les jetons d'accès fédérés sont des jetons de support qui authentifient un compte principal de pool d'identités de personnel ou un compte principal de pool d'identités de charge de travail.

La fédération des identités des employés permet aux clients d'échanger un jeton externe contre un jeton d'accès fédéré qui authentifie un compte principal de pool d'employés. Le principal du pool d'identités de personnel est identifié par un identifiant de principal semblable à celui-ci :

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

La fédération d'identité de charge de travail permet aux clients d'échanger un jeton externe contre un jeton d'accès fédéré qui authentifie un compte principal de pool de charges de travail. Le compte principal du pool d'identités de charge de travail est identifié par un identifiant principal semblable à celui-ci :

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

Les jetons d'accès fédérés sont opaques et ne peuvent pas être inspectés. Les jetons ne peuvent pas être révoqués et restent valides jusqu'à leur expiration. Les dates d'expiration de chaque type de jeton sont définies comme suit :

  • La fédération des identités des employés définit l'expiration du jeton sur la plus petite des deux valeurs suivantes :

    • Temps restant avant l'expiration de la session de fédération d'identité de personnel

    • 1 heure

    L'expiration de la session de fédération des identités des employés est déterminée en fonction de l'heure de connexion et de la durée de la session configurée pour le pool de fédération des identités des employés.

  • La fédération d'identité de charge de travail définit l'expiration du jeton de sorte qu'elle corresponde à l'expiration du jeton externe.

Jetons d'accès d'identité d'agent

Les jetons d'accès d'identité d'agent authentifient un agent auquel une identité d'agent a été attribuée et utilisent un identifiant de compte principal semblable à celui-ci :

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

L'identifiant du compte principal est basé sur l'ID SPIFFE du certificat client X.509 de l'agent, mais utilise le préfixe principal:// au lieu de spiffe://.

Un agent peut obtenir un jeton d'accès d'identité d'agent à partir du serveur de métadonnées Compute Engine. L'agent peut éventuellement demander que le jeton soit lié à son certificat client X.509. Un jeton d'accès d'identité d'agent lié n'est valide que lorsqu'il est utilisé via une connexion TLS mutuelle authentifiée à l'aide du certificat client X.509 auquel le jeton a été lié.

Comme les jetons d'accès fédérés, les jetons d'accès d'identité d'agent sont opaques, ne peuvent pas être inspectés ni révoqués, et restent valides jusqu'à leur expiration. Par défaut, les jetons d'accès d'identité d'agent sont valides pendant une heure, mais l'expiration d'un jeton peut être plus courte lorsqu'il est lié à un certificat client X.509 dont l'expiration est proche.

Jetons de limite d'accès aux identifiants

Les jetons de limite d'accès aux identifiants sont des jetons de support qui authentifient un utilisateur ou un compte de service et incluent une limite d'accès. La limite d'accès restreint le jeton afin qu'il ne puisse être utilisé que pour accéder à un sous-ensemble défini de ressources Cloud Storage.

Les jetons de limite d'accès aux identifiants sont parfois appelés jetons à champ d'application réduit, car ils sont dérivés d'un jeton d'entrée, mais sont plus limités dans les ressources auxquelles ils accordent l'accès.

L'expiration des jetons de limite d'accès aux identifiants est dérivée de l'expiration du jeton d'entrée, qui est un jeton d'accès de compte de service. Les jetons de limite d'accès aux identifiants sont opaques et ne peuvent pas être inspectés ni révoqués.

Jetons de limite d'accès aux identifiants émis par le client

Les jetons de limite d'accès aux identifiants émis par le client sont semblables aux jetons de limite d'accès aux identifiants, mais ils sont optimisés pour les scénarios dans lesquels les clients doivent obtenir des jetons de limite d'accès aux identifiants avec différentes limites d'accès à une fréquence élevée.

Les clients peuvent créer localement des jetons de limite d'accès aux identifiants émis par le client à l'aide des bibliothèques clientes Cloud et d'un jeton intermédiaire de limite d'accès, qu'ils doivent actualiser régulièrement.

Les jetons de limite d'accès aux identifiants émis par le client sont opaques et ne peuvent pas être inspectés ni révoqués.

Jetons d'octroi de jetons

Les jetons d'octroi de jetons permettent aux clients d'obtenir des jetons nouveaux ou différents, éventuellement à un moment ultérieur. Cloud de Confiance by S3NS accepte plusieurs types de jetons d'octroi de jetons, qui ont tous les points communs suivants :

  • Ils représentent une authentification préalable.

  • Ils authentifient un compte principal, qui peut être une identité Google (un utilisateur ou une charge de travail) ou une identité externe.

  • Ils peuvent être échangés contre un jeton d'accès.

  • Ils ne peuvent pas être utilisés pour effectuer des appels d'API Google, ce qui les distingue des jetons d'accès.

Les jetons d'octroi de jetons peuvent différer de la manière suivante :

  • Émetteur : partie qui émet le jeton.

  • Principal : type d'identité principale que le jeton peut authentifier.

  • Restrictions : restrictions pouvant être imposées au jeton.

Le tableau suivant liste les différents types de jetons d'octroi de jetons.

Type de jeton Émetteur Type de jeton d'accès utilisé Comptes principaux Restrictions
Jeton d'actualisation fédéré Cloud de Confiance by S3NS Serveur d'autorisation IAM Jeton d'accès fédéré Compte principal du pool d'identités de personnel Habilitation OAuth
Code d'autorisation fédéré Cloud de Confiance by S3NS Serveur d'autorisation IAM Jeton d'accès fédéré Compte principal du pool d'identités de personnel Habilitation OAuth
Jeton Web JSON externe Fournisseur d'identité externe Jeton d'accès fédéré Compte principal externe Aucun
Assertion ou réponse SAML externe Fournisseur d'identité externe Jeton d'accès fédéré Compte principal externe Aucun
Jeton GetCallerIdentity Amazon Web Services (AWS) Fournisseur d'identité externe Jeton d'accès fédéré Compte principal externe Aucun

Les différents types de jetons d'octroi de jetons présentent également des propriétés de sécurité différentes :

  • Format : certains jetons sont opaques. D'autres jetons peuvent être décodés par le client.

  • Durée de vie : les jetons diffèrent par leur durée de vie et par la mesure dans laquelle ils peuvent être modifiés.

  • Multi-usage : certains jetons d'octroi de jetons ne peuvent être utilisés qu'une seule fois. D'autres jetons peuvent être utilisés plusieurs fois.

  • Révocabilité : certains jetons peuvent être révoqués. Les autres jetons restent valides jusqu'à leur expiration.

  • Liaison : certains jetons sont liés à un identifiant supplémentaire, ce qui en fait des jetons liés. Les autres jetons ne sont pas liés, ce qui en fait des jetons de support.

Le tableau suivant récapitule les différences entre ces propriétés pour les jetons d'octroi de jetons :

Type de jeton Format Durée de vie Réversible Valable plusieurs fois Liaison
Jeton d'actualisation fédéré Opaque Variable, consultez Jetons d'actualisation fédérés Non Oui Identifiants clients OAuth
Code d'autorisation fédéré Opaque 10 minutes Non Non Identifiants clients OAuth
Jeton externe ou jeton Web JSON externe JWT Dépend du fournisseur d'identité Dépend du fournisseur d'identité Oui
Assertion ou réponse SAML externe SAML Dépend du fournisseur d'identité Dépend du fournisseur d'identité Oui
Jeton GetCallerIdentity Amazon Web Services (AWS) Blob de texte Dépend du fournisseur d'identité Dépend du fournisseur d'identité Oui

Jetons d'actualisation fédérés

Les jetons d'actualisation fédérés sont des jetons opaques qui permettent aux clients d'obtenir des jetons d'accès pour un compte principal de pool d'identités de personnel, si l'utilisateur a précédemment autorisé un client à agir en son nom.

Comme les jetons d'actualisation, les jetons d'actualisation fédérés sont liés à un client spécifique et ne peuvent être utilisés qu'en combinaison avec des identifiants client valides, par exemple un ID client et un code secret du client.

Contrairement aux jetons d'actualisation, les jetons d'actualisation fédérés ne peuvent pas être révoqués. La durée de vie d'un jeton d'actualisation fédéré est liée à la session d'identité de personnel utilisée pour obtenir le jeton. Elle reste valide jusqu'à l'expiration de la session.

Codes d'autorisation fédérés

Comme les codes d'autorisation, les codes d'autorisation fédérés sont des jetons opaques à courte durée de vie. Les codes ne sont destinés à être utilisés que lors de l'authentification de l'utilisateur en tant qu'intermédiaire entre le client et le serveur d'autorisation Cloud de Confiance by S3NS IAM.

Les codes d'autorisation sont liés à un client, ne peuvent être utilisés qu'en combinaison avec des identifiants client valides et ne peuvent être utilisés qu'une seule fois.

Jetons Web JSON externes

Les jetons Web JSON (JWT) externes sont émis par un fournisseur d'identité externe tel que Microsoft Entra ID, Okta, Kubernetes ou GitHub. Leur structure et leur contenu peuvent différer.

En configurant la fédération d'identité de personnel ou la fédération d'identité de charge de travail, vous pouvez configurer une relation de confiance entre Cloud de Confiance by S3NS et un fournisseur d'identité externe. Les charges de travail peuvent ensuite utiliser des jetons JWT externes comme jetons d'attribution de jetons pour obtenir des jetons d'accès fédérés.

Lorsque vous utilisez la fédération d'identité de personnel, le jeton d'accès fédéré obtenu authentifie un compte principal de pool d'identités de personnel.

Lorsque vous utilisez la fédération d'identité de charge de travail, le jeton d'accès fédéré obtenu authentifie un compte principal de pool d'identités de charge de travail.

Dans les deux cas, l'identifiant du compte principal est dérivé d'une ou de plusieurs revendications du jeton JWT externe.

Pour être compatibles avec la fédération des identités des employés ou la fédération d'identité de charge de travail, les jetons JWT externes doivent répondre à des exigences spécifiques.

Assertions ou réponses SAML externes

Les assertions SAML (Security Assertion Markup Language) externes sont des assertions SAML 2.0 émises par un fournisseur d'identité externe tel que Microsoft Entra ID, Okta ou Active Directory Federation Services. Ces assertions SAML externes peuvent éventuellement être incluses dans une réponse SAML 2.0 ou être chiffrées.

Comme pour les jetons Web JSON externes, vous pouvez configurer la fédération d'identité de personnel ou la fédération d'identité de charge de travail afin que les charges de travail puissent utiliser des assertions ou des réponses SAML externes comme jetons d'octroi de jetons pour obtenir des jetons d'accès fédérés.

Pour être compatibles avec la fédération d'identité de personnel ou la fédération d'identité de charge de travail, les assertions SAML externes doivent répondre à des exigences spécifiques.

Jeton GetCallerIdentity Amazon Web Services (AWS)

Les jetons AWS GetCallerIdentity externes sont des blobs de texte contenant une requête signée adressée à l'API AWS GetCallerIdentity. Comme pour les jetons Web JSON externes, vous pouvez configurer la fédération d'identité de personnel ou la fédération d'identité de charge de travail afin que les charges de travail puissent utiliser ces blobs de texte comme jeton d'octroi de jeton pour obtenir des jetons d'accès fédérés.

Jetons d'identité

Les jetons d'identité (ID) permettent aux clients d'identifier l'utilisateur avec lequel ils interagissent. Cloud de Confiance by S3NS accepte plusieurs types de jetons d'identité, qui ont tous les points communs suivants :

  • Ils sont signés, mais pas chiffrés, de sorte qu'ils peuvent être décodés, vérifiés et interprétés par le client.

  • Ils authentifient un compte principal, qui peut être un utilisateur ou une charge de travail.

  • Ils sont émis pour un client particulier.

  • Ils sont de courte durée et expirent au bout d'une heure maximum.

  • Elles ne sont pas révocables.

  • Ils ne peuvent pas être utilisés pour effectuer des appels d'API Google, ce qui les distingue des jetons d'accès.

  • Ils ne peuvent pas être utilisés pour obtenir des jetons d'accès, ce qui les distingue des jetons d'octroi de jetons.

  • Ils peuvent être utilisés pour authentifier les appels entre microservices ou pour s'authentifier de manière programmatique auprès d'Identity-Aware Proxy (IAP).

Les jetons d'identité peuvent différer des manières suivantes :

  • Audience : partie destinée à décoder et à utiliser le jeton.

  • Émetteur : partie qui émet le jeton.

  • Principal : type d'identité principale que le jeton peut authentifier.

Le tableau suivant liste les différents types de jetons d'identité.

Type de jeton Émetteur Audience Principal
Jeton d'ID de compte de service Cloud de Confiance by S3NS Serveur d'autorisation IAM Libre de choisir n'importe quelle audience Compte de service
Jeton d'ID d'identité de l'agent Cloud de Confiance by S3NS Serveur d'autorisation IAM Libre de choisir n'importe quelle audience Identité de l'agent
Assertion Identity-Aware Proxy (IAP) IAP
  • Backend
  • App Engine app
  • Utilisateur (utilisateur géré)
  • Utilisateur (compte personnel)
  • Compte principal du pool d'identités de personnel

Les différents types de jetons d'identité présentent également des propriétés de sécurité différentes :

  • Format : certains jetons sont des jetons Web JSON (JWT), d'autres utilisent le format XML.

  • Durée de vie : la durée de vie des jetons varie.

  • Liaison : certains jetons peuvent éventuellement être liés à un identifiant supplémentaire, ce qui en fait des jetons liés.

Le tableau suivant récapitule les différences entre les types de jetons d'identité.

Type de jeton Format Durée de vie Liaison
Jeton d'ID de compte de service JWT 1 heure
Jeton d'ID d'identité de l'agent JWT 1 heure Certificat client X.509
Assertion Identity-Aware Proxy (IAP) JWT 10 minutes

Jetons d'ID de compte de service

Les jetons d'ID de compte de service sont des jetons Web JSON (JWT) qui authentifient un compte de service.

Contrairement aux jetons JWT de compte de service et aux assertions JWT de compte de service, les jetons d'ID de compte de service ne sont pas signés par une clé de compte de service. À la place, les jetons d'ID de compte de service sont signés par le JWKS (JSON Web Key Set) de Google.

Un jeton d'ID de compte de service décodé ressemble à ce qui suit, avec SIGNATURE remplacé par la signature du jeton :

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

Un jeton d'ID de compte de service comprend les champs suivants :

Champ Name Description
aud Audience Identifiant de la partie à laquelle ce jeton est destiné. La valeur peut être librement choisie par le demandeur du jeton.
azp Partie autorisée Compte de service qui a demandé le jeton, identifié par son ID unique.
exp Expiration Délai d'expiration du jeton, au format d'heure epoch Unix.
iss Émetteur Émetteur du jeton, toujours défini sur https://accounts.google.com.
sub Objet Compte de service qui a demandé le jeton, identifié par son ID unique.

L'ensemble exact de revendications incluses dans un jeton d'ID dépend de la manière dont le jeton d'ID est demandé. Par exemple, les jetons d'ID demandés par le serveur de métadonnées Compute Engine peuvent éventuellement inclure des revendications supplémentaires qui confirment l'identité de la VM. Les jetons d'ID demandés à l'aide de l'API IAM Credentials peuvent éventuellement contenir l'ID d'organisation du projet du compte de service.

Les jetons d'ID de compte de service sont valides pendant une heure et ne peuvent pas être révoqués.

Jetons d'ID d'identité d'agent

Les jetons d'ID d'identité d'agent sont des documents d'identité vérifiables SPIFFE (JWT-SVID) et authentifient un agent auquel une identité d'agent a été attribuée.

Un agent peut obtenir un jeton d'ID à partir du serveur de métadonnées Compute Engine. L'agent peut éventuellement demander que le jeton soit lié à son certificat client X.509. Un jeton d'ID d'identité d'agent lié contient l'empreinte du certificat client X.509 dans la revendication cnf.

Contrairement aux jetons d'ID utilisateur et aux jetons d'ID de compte de service, les jetons d'ID d'identité d'agent ne sont pas signés par le jeu de clés Web JSON (JWKS) de Google. À la place, les jetons d'ID d'identité d'agent sont signés par un JWKS spécifique à un pool d'identités d'agent.

Un jeton d'ID d'identité d'agent décodé ressemble à ce qui suit, avec SIGNATURE remplacé par la signature du jeton :

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

Un jeton d'ID d'identité d'agent comprend les champs suivants :

Champ Name Description
aud Audience Identifiant de la partie à laquelle ce jeton est destiné. La valeur peut être choisie par le demandeur du jeton.
exp Expiration Délai d'expiration du jeton, au format d'heure epoch Unix.
iss Émetteur Émetteur du jeton, qui est le pool d'identités d'agent de l'organisation ou du projet contenant l'agent.
sub Objet ID SPIFFE de l'agent.
cnf.x5t#S256 Confirmation Empreinte du certificat client X.509 auquel le jeton est lié. La revendication est vide si le jeton n'est pas lié.

Assertions Identity-Aware Proxy

Les assertions Identity-Aware Proxy (IAP) sont des jetons Web JSON (JWT) qu'IAP transmet aux applications Web protégées par IAP dans l'en-tête de requête HTTP x-goog-iap-jwt-assertion. Les assertions IAP authentifient un utilisateur et servent également de preuve qu'une requête a été autorisée par IAP.

les assertions IAP sont signées à l'aide de du JWKS IAP. Ce JWKS est une ressource globale, et les mêmes clés de signature sont utilisées pour différents types d'utilisateurs, y compris les suivants :

  • Comptes utilisateur gérés

  • Comptes personnels

  • Comptes de service

  • Principaux de pool d'identités de personnel

Une assertion IAP décodée ressemble à ce qui suit, avec SIGNATURE remplacé par la signature du jeton :

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

Une assertion IAP comprend les champs suivants :

Champ Name Description
aud Audience Service de backend, application App Engine ou service Cloud Run auquel l'assertion IAP est destinée.
iss Émetteur Émetteur du jeton, toujours défini sur https://cloud.google.com/iap.
sub Objet

Le compte principal authentifié, identifié par son identifiant unique.

Si IAP est configuré pour utiliser des identités Google, cet ID est équivalent à l'ID exposé dans l'API Directory.

Pour en savoir plus sur les revendications d'assertion IAP, consultez Valider la charge utile JWT.

Les assertions IAP sont valides pendant 10 minutes et ne peuvent pas être révoquées.