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