| Categoria di token | Percorso di comunicazione | Finalità |
|---|---|---|
| Token di accesso | Server di autorizzazione ⭢ Client ⭢ API di Google | Consente ai client di chiamare le API Cloud de Confiance by S3NS . |
| Token di concessione dei token | Server di autorizzazione ⭤ Client | Consente ai client di ottenere token nuovi o diversi, eventualmente in un secondo momento. |
| Token di identità | Server di autorizzazione ⭢ Client | Consente ai client di identificare l'utente con cui stanno interagendo. |
La maggior parte dei token di accesso e di identità sono token di connessione. I token di connessione concedono l'accesso alla parte in possesso del token, indipendentemente da come lo ha ottenuto. Se un malintenzionato intercetta un token di connessione, può utilizzarlo per ottenere l'accesso non autorizzato.
Per utilizzare un token associato, un client deve fornire un'ulteriore prova di essere il legittimo proprietario del token. I token associati sono quindi più restrittivi dei token di connessione e possono contribuire a ridurre il rischio di furto di token.
Token di accesso
I token di accesso consentono ai client di effettuare chiamate autenticate alle API Cloud de Confiance by S3NS . Cloud de Confiance by S3NS supporta diversi tipi di token di accesso, che hanno le seguenti proprietà in comune:
Autenticano un'entità, che può essere un utente o un workload.
Vengono emessi per un client specifico.
Hanno una durata breve e scadono al massimo dopo alcune ore.
Sono limitati a determinati ambiti, endpoint o risorse OAuth. Ciò significa che un token di accesso in genere non concede l'accesso a tutte le risorse di un utente, ma solo a un determinato sottoinsieme.
I token di accesso possono differire nei seguenti modi:
Issuer: la parte che emette il token.
Entità: il tipo di entità che il token può autenticare.
Restrictions: le limitazioni che possono essere imposte al token.
La tabella seguente elenca i diversi tipi di token di accesso:
| Tipo di token | Emittente | Entità | Limitazioni |
|---|---|---|---|
| Token di accesso al service account | Cloud de Confiance by S3NS Server di autorizzazione IAM | Service account | ambito OAuth |
| Token web JSON (JWT) del service account | Client | Service account | Ambito OAuth o API |
| Token di accesso federato | Server di autorizzazione IAMCloud de Confiance by S3NS |
|
ambito OAuth |
| Token di accesso dell'identità dell'agente | Server di autorizzazione IAMCloud de Confiance by S3NS | Entità identità dell'agente | ambito OAuth |
| Token del confine di accesso alle credenziali | Server di autorizzazione IAMCloud de Confiance by S3NS |
|
Oggetti Cloud Storage specifici |
| Token di confine di accesso alle credenziali emesso dal client | Client | Service account | Oggetti Cloud Storage specifici |
I diversi tipi di token di accesso presentano anche proprietà di sicurezza diverse:
- Formato: alcuni token di accesso sono opachi, ovvero sono in un formato proprietario e non possono essere ispezionati. Altri token sono codificati come token web JSON, che può essere decodificato dal client.
- Durata: i token differiscono per durata e per la misura in cui possono essere modificati.
- Revocabilità: alcuni token possono essere revocati. Gli altri token rimangono validi fino alla scadenza.
- Binding: alcuni token possono essere facoltativamente associati a una credenziale aggiuntiva, diventando così token associati.
La seguente tabella riassume le differenze tra i tipi di token di accesso.
| Tipo di token | Formato | Introspezionabile | Durata | Revocabile | Associazione |
|---|---|---|---|---|---|
| Token di accesso al service account | Opaque | No | 5 minuti-12 ore | No | |
| Token web JSON (JWT) del service account | JWT | N/D | 5 minuti-1 ora | No | |
| Token di accesso federato | Opaque | No | Consulta Token di accesso federato | No | |
| Token di accesso dell'identità dell'agente | Opaque | No | Consulta Token di accesso all'identità dell'agente | No | Certificato client X.509 |
| Token di confine di accesso alle credenziali | Opaque | No | Consulta Token dei limiti di accesso alle credenziali | No | |
| Token del limite di accesso delle credenziali emesso dal client | Opaque | No | N/D | No |
Token di accesso ai service account
I token di accesso ai service account sono token di connessione che autenticano un service account. I token sono opachi.
Per un token di accesso del account di servizio, l'API restituisce un output simile al seguente esempio:
{
"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 token del account di servizio include i seguenti campi:
| Campo | Nome | Descrizione |
|---|---|---|
aud |
Pubblico | Il account di servizio per cui è stato emesso il token, equivalente alla parte autorizzata. |
azp |
Parte autorizzata | Il account di servizio che ha richiesto il token, identificato dal suo ID univoco. |
email |
Indirizzo email principale |
L'indirizzo email del account di servizio.
Questo campo è presente solo se il token include l'ambito |
exp |
Scadenza | La data di scadenza del token, nel formato dell'epoca di Unix. |
I token di accesso dei service account non possono essere revocati e rimangono validi fino alla scadenza.
Per impostazione predefinita, i token di accesso dei account di servizio scadono dopo un'ora. Utilizzando il metodo serviceAccounts.generateAccessToken, puoi richiedere token con durate diverse. Poiché durate dei token più lunghe possono aumentare il rischio, devi configurare il vincolo iam.allowServiceAccountCredentialLifetimeExtension per consentire ai client di richiedere token di accesso ai account di servizio con durate superiori a un'ora.
Token web JSON dei service account
I token web JSON (JWT) dei service account sono token di connessione che autenticano un account di servizio. Mentre i token di accesso dei service account vengono emessi da un server di autorizzazione, i JWT account di servizio possono essere emessi dal client stesso.
A volte questi JWT sono chiamati "autofirmati". Possono essere utili quando devi autenticarti con alcune API di Google senza ottenere un token di accesso dal server di autorizzazione, ad esempio quando crei le tue librerie client.
Per emettere un JWT per un account di servizio, i client devono seguire questi passaggi:
Prepara un payload JSON Web Signature che includa l'indirizzo email del account di servizio, un ambito OAuth o un endpoint API e una data di scadenza.
Firma il payload utilizzando una chiave del service account corrispondente. I client possono firmare il payload offline utilizzando una chiave del account di servizio gestita dall'utente o online utilizzando il metodo
signJwte una chiave del account di servizio gestita da Google. Per saperne di più, consulta Crea un token web JSON autofirmato.
Un JWT del account di servizio decodificato è simile al seguente, con SIGNATURE sostituito dalla firma del token:
{
"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
Anziché specificare un ambito OAuth nella chiave scope, un JWT del account di servizio può specificare un endpoint API nella chiave 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 JWT del account di servizio include i seguenti campi:
| Campo | Nome | Descrizione |
|---|---|---|
aud |
Pubblico |
Endpoint API a cui il client è autorizzato ad accedere. Valido solo se scope non è specificato.
|
exp |
Scadenza | La data di scadenza del token, nel formato dell'epoca di Unix. |
iat |
Ora del problema | L'ora di emissione del token, nel formato dell'epoca di Unix. |
iss |
Emittente | L'emittente del token, ovvero l'account di servizio stesso. |
scope |
ambiti OAuth |
L'insieme di API a cui il client è autorizzato ad accedere, identificato dall'ambito OAuth. Valido solo se aud non è specificato.
|
sub |
Oggetto | Entità autenticata, ovvero il account di servizio stesso. |
I JWT dei service account possono essere validi per un massimo di un'ora e non possono essere revocati.
Token di accesso federati
I token di accesso federati sono token di connessione che autenticano un'entità del pool di forza lavoro di identità o un'entità del pool di identità del workload.
La federazione delle identità per la forza lavoro consente ai client di scambiare un token esterno con un token di accesso federato che autentica un'entità del pool di forza lavoro. L'entità del pool di identità della forza lavoro è identificata da un identificatore simile al seguente:
principal://iam.googleapis.com/locations/global/workforcePools/POOL/subject/raha@altostrat.com.
La federazione delle identità per i workload consente ai client di scambiare un token esterno con un token di accesso federato che autentica un'entità del pool di workload. L'entità del pool di identità del workload è identificata da un identificatore dell'entità simile al seguente:
principal://iam.googleapis.com/projects/PROJECT/locations/global/workloadIdentityPools/POOL/subject/SUBJECT_ATTRIBUTE_VALUE
I token di accesso federati sono opachi e non possono essere sottoposti a introspezione. I token non possono essere revocati e rimangono validi fino alla scadenza. Le scadenze per ogni tipo di token sono impostate come segue:
La federazione delle identità per la forza lavoro imposta la scadenza del token sul valore minore tra i seguenti:
Tempo rimanente prima della scadenza della sessione di federazione delle identità della forza lavoro
1 ora
La scadenza della sessione della federazione delle identità per la forza lavoro viene determinata in base all'ora di accesso e alla durata della sessione configurata per il pool della federazione delle identità per la forza lavoro.
La federazione delle identità per i workload imposta la scadenza del token in modo che corrisponda alla scadenza del token esterno.
Token di accesso dell'identità dell'agente
I token di accesso dell'identità dell'agente autenticano un agente a cui è stata assegnata un'identità dell'agente e utilizzano un identificatore dell'entità simile al seguente:
principal://agents.global.org-ORGANIZATION_ID.system.id.goog/resources/aiplatform/projects/PROJECT_NUMBER/locations/us-central1/reasoningEngines/REASONING_ENGINE_ID
L'identificatore dell'entità si basa sull'ID SPIFFE del certificato client X.509 dell'agente, ma utilizza il prefisso principal:// anziché spiffe://.
Un agente può ottenere un token di accesso all'identità dell'agente dal server dei metadati di Compute Engine. Se vuole, l'agente può richiedere che il token sia associato al suo certificato client X.509. Un token di accesso dell'identità dell'agente associato è valido solo se utilizzato su una connessione mutual TLS autenticata utilizzando il certificato client X.509 a cui è stato associato il token.
Come i token di accesso federati, i token di accesso dell'identità dell'agente sono opachi, non possono essere sottoposti a introspezione o revocati e rimangono validi fino alla scadenza. Per impostazione predefinita, i token di accesso dell'identità dell'agente sono validi per un'ora, ma la scadenza di un token potrebbe essere più breve se è associato a un certificato client X.509 prossimo alla scadenza.
Token di confine di accesso alle credenziali
I token di accesso con limitazione delle credenziali sono token di connessione che autenticano un utente o un account di servizio e includono un limite di accesso. Il confine di accesso limita il token in modo che possa essere utilizzato solo per accedere a un sottoinsieme definito di risorse Cloud Storage.
I token di confine di accesso alle credenziali sono talvolta definiti con ambito ridotto perché derivano da un token di input, ma sono più limitati nelle risorse a cui concedono l'accesso.
La scadenza dei token di accesso ai limiti delle credenziali deriva dalla scadenza del token di input, che un token di accesso al service account. I token del confine di accesso alle credenziali sono opachi e non possono essere esaminati o revocati.
Token di accesso delle credenziali lato client
I token dei limiti di accesso alle credenziali emessi dal client sono simili ai token dei limiti di accesso alle credenziali, ma sono ottimizzati per gli scenari in cui i client devono ottenere token dei limiti di accesso alle credenziali con limiti di accesso diversi ad alta frequenza.
I client possono creare localmente token di limiti di accesso delle credenziali emessi dal client utilizzando le librerie client di Cloud e un token intermediario dei limiti di accesso, che devono aggiornare periodicamente.
I token dei limiti di accesso delle credenziali emessi dal client sono opachi e non possono essere esaminati o revocati.
Token di concessione dei token
I token di concessione dei token consentono ai client di ottenere token nuovi o diversi, possibilmente in un secondo momento. Cloud de Confiance by S3NS supporta diversi tipi di token di concessione dei token, che hanno tutti in comune quanto segue:
Rappresentano un'autenticazione precedente.
Autenticano un'entità, che può essere un'identità Google (un utente o un workload) o un'identità esterna.
Possono essere riscattati per un token di accesso.
Non possono essere utilizzati per effettuare chiamate API di Google, il che li distingue dai token di accesso.
I token di concessione dei token possono differire nei seguenti modi:
Issuer: la parte che emette il token.
Principal: il tipo di identità principale che il token può autenticare.
Restrictions: le limitazioni che possono essere imposte al token.
La tabella seguente elenca i diversi tipi di token di concessione dei token.
| Tipo di token | Emittente | Tipo di token di accesso utilizzato | Entità | Limitazioni |
|---|---|---|---|---|
| Token di aggiornamento federato | Server di autorizzazione IAMCloud de Confiance by S3NS | Token di accesso federato | Entità del pool di identità della forza lavoro | ambito OAuth |
| Codice di autorizzazione federato | Server di autorizzazione IAMCloud de Confiance by S3NS | Token di accesso federato | Entità del pool di identità della forza lavoro | ambito OAuth |
| Token web JSON esterno | Provider di identità esterno | Token di accesso federato | Entità esterna | Nessuno |
| Risposta o asserzione SAML esterna | Provider di identità esterno | Token di accesso federato | Entità esterna | Nessuno |
Token GetCallerIdentity di Amazon Web Services (AWS)
|
Provider di identità esterno | Token di accesso federato | Entità esterna | Nessuno |
I diversi tipi di token che concedono token presentano anche proprietà di sicurezza diverse:
Formato: alcuni token sono opachi. Altri token possono essere decodificati dal client.
Durata: i token differiscono per durata e per la misura in cui possono essere modificati.
Multiuso: alcuni token di concessione dei token possono essere utilizzati una sola volta. Altri token possono essere utilizzati più volte.
Revocabilità: alcuni token possono essere revocati. Gli altri token rimangono validi fino alla scadenza.
Binding: alcuni token sono associati a una credenziale aggiuntiva, il che li rende token associati. Altri token non sono associati, il che li rende token di connessione.
La seguente tabella riassume le differenze tra queste proprietà per i token di concessione dei token:
| Tipo di token | Formato | Durata | Revocabile | Multiuso | Associazione |
|---|---|---|---|---|---|
| Token di aggiornamento federato | Opaque | Varia, consulta Token di aggiornamento federati | No | Sì | Credenziali client OAuth |
| Codice di autorizzazione federato | Opaque | 10 minuti | No | No | Credenziali client OAuth |
| Token esterno o token web JSON esterno | JWT | Dipende dal provider di identità | Dipende dal provider di identità | Sì | |
| Risposta o asserzione SAML esterna | SAML | Dipende dal provider di identità | Dipende dal provider di identità | Sì | |
Token GetCallerIdentity Amazon Web Services (AWS) |
Blob di testo | Dipende dal provider di identità | Dipende dal provider di identità | Sì |
Token di aggiornamento federati
I token di aggiornamento federati sono token opachi che consentono ai client di ottenere token di accesso per un'entità del pool di identità della forza lavoro, se l'utente ha precedentemente autorizzato un client ad agire per suo conto.
Come i token di aggiornamento, i token di aggiornamento federati sono associati a un client specifico e possono essere utilizzati solo in combinazione con credenziali client valide, ad esempio un ID client e un client secret.
A differenza dei token di aggiornamento, i token di aggiornamento federati non possono essere revocati. La durata di un token di aggiornamento federato è collegata alla sessione di Workforce Identity utilizzata per ottenere il token e rimane valida fino alla scadenza della sessione.
Codici di autorizzazione federati
Come i codici di autorizzazione, i codici di autorizzazione federati sono token opachi e di breve durata. I codici devono essere utilizzati solo durante l'autenticazione utente come intermediario tra il client e il server di autorizzazione IAM Cloud de Confiance by S3NS .
I codici di autorizzazione sono associati a un client, possono essere utilizzati solo in combinazione con credenziali client valide e possono essere utilizzati una sola volta.
Token web JSON esterni
I token web JSON (JWT) esterni vengono emessi da un provider di identità esterno, come Microsoft Entra ID, Okta, Kubernetes o GitHub. Potrebbero differire per struttura e contenuti.
Configurando la federazione delle identità per la forza lavoro o la federazione delle identità per i workload, puoi configurare una relazione di trust tra Cloud de Confiance by S3NS e un provider di identità esterno. I workload possono quindi utilizzare i JWT esterni come token di concessione dei token per ottenere token di accesso federati.
Quando utilizzi la federazione delle identità per la forza lavoro, il token di accesso federato risultante autentica un'entità del pool di identità della forza lavoro.
Quando utilizzi la federazione delle identità per i workload, il token di accesso federato risultante autentica un'entità del pool di identità del workload.
In entrambi i casi, l'identificatore dell'entità viene derivato da una o più rivendicazioni del JWT esterno.
Per essere compatibili con la federazione delle identità per la forza lavoro o la federazione delle identità per i workload, i JWT esterni devono soddisfare requisiti specifici.
Risposte o asserzioni SAML esterne
Le asserzioni Security Assertion Markup Language (SAML) esterne sono asserzioni SAML 2.0 emesse da un provider di identità esterno come Microsoft Entra ID, Okta o Active Directory Federation Services. Queste asserzioni SAML esterne possono essere facoltativamente racchiuse in una risposta SAML 2.0 o essere criptate.
Come per i token web JSON esterni, puoi configurare la federazione delle identità per la forza lavoro o la federazione delle identità per i workload in modo che i workload possano utilizzare asserzioni o risposte SAML esterne come token di concessione dei token per ottenere token di accesso federati.
Per essere compatibili con la federazione delle identità per la forza lavoro o la federazione delle identità per i workload, le asserzioni SAML esterne devono soddisfare requisiti specifici.
Token GetCallerIdentity Amazon Web Services (AWS)
I token AWS GetCallerIdentity esterni sono blob di testo che contengono una richiesta firmata all'API GetCallerIdentity AWS.
Analogamente ai token web JSON esterni, puoi configurare la federazione delle identità per la forza lavoro o la federazione delle identità per i workload in modo
che i workload possano utilizzare questi blob di testo come token di concessione dei token per ottenere
token di accesso federati.
Token di identità
I token ID (identità) consentono ai client di identificare l'utente con cui interagiscono. Cloud de Confiance by S3NS supporta diversi tipi di token ID, che hanno tutti in comune quanto segue:
Sono firmati, ma non criptati, in modo che possano essere decodificati, verificati e interpretati dal client.
Autenticano un'entità, che può essere un utente o un workload.
Vengono emessi per un client specifico.
Sono di breve durata e scadono dopo al massimo un'ora.
Non sono revocabili.
Non possono essere utilizzati per effettuare chiamate alle API di Google, il che li distingue dai token di accesso.
Non possono essere utilizzati per ottenere token di accesso, il che li distingue dai token di concessione dei token.
Possono essere utilizzati per autenticare le chiamate tra microservizi o per autenticarsi in modo programmatico in Identity-Aware Proxy (IAP).
I token di identità possono differire nei seguenti modi:
Pubblico: la parte destinata a decodificare e utilizzare il token.
Issuer: la parte che emette il token.
Principal: il tipo di identità principale che il token può autenticare.
La tabella seguente elenca i diversi tipi di token di identità.
| Tipo di token | Emittente | Pubblico | Entità |
|---|---|---|---|
| Token ID del service account | Server di autorizzazione IAMCloud de Confiance by S3NS | Libertà di scegliere qualsiasi segmento di pubblico | Service account |
| Token ID dell'identità dell'agente | Server di autorizzazione IAMCloud de Confiance by S3NS | Libertà di scegliere qualsiasi pubblico | Agent Identity |
| Asserzione Identity-Aware Proxy (IAP) | IAP |
|
|
I diversi tipi di token di identità presentano anche proprietà di sicurezza diverse:
Formato: alcuni token sono JSON Web Token (JWT), altri utilizzano la formattazione XML.
Durata: i token hanno una durata diversa.
Binding: alcuni token possono essere facoltativamente associati a una credenziale aggiuntiva, diventando così token associati.
La tabella seguente riassume le differenze tra i tipi di token di identità.
| Tipo di token | Formato | Durata | Associazione |
|---|---|---|---|
| Token ID del service account | JWT | 1 ora | |
| Token ID dell'identità dell'agente | JWT | 1 ora | Certificato client X.509 |
| Asserzione Identity-Aware Proxy (IAP) | JWT | 10 minuti |
Token ID del service account
I token ID dell'account di servizio sono token web JSON (JWT) che autenticano un account di servizio.
A differenza dei JWT dei service account e delle asserzioni JWT dei service account, i token ID dei account di servizio non sono firmati da una chiave del account di servizio. I token ID dei account di servizio sono invece firmati dal set di chiavi web JSON (JWKS) di Google.
Un token ID di un account di servizio decodificato è simile al seguente, con SIGNATURE sostituito dalla firma del token:
{
"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 token ID del account di servizio include i seguenti campi:
| Campo | Nome | Descrizione |
|---|---|---|
aud |
Pubblico | Identificatore della parte a cui è destinato questo token. Il valore può essere scelto liberamente dal richiedente del token. |
azp |
Parte autorizzata | Il account di servizio che ha richiesto il token, identificato dal suo ID univoco. |
exp |
Scadenza | La data di scadenza del token, nel formato dell'epoca di Unix. |
iss |
Emittente |
L'emittente del token, sempre impostato su
https://accounts.google.com.
|
sub |
Oggetto | Il account di servizio che ha richiesto il token, identificato dal suo ID univoco. |
L'insieme esatto di claim inclusi in un token ID dipende dal modo in cui viene richiesto il token ID. Ad esempio, i token ID richiesti dal server dei metadati di Compute Engine possono includere facoltativamente claim aggiuntivi che confermano l'identità della VM. I token ID richiesti utilizzando l'API IAM Credentials possono facoltativamente contenere l'ID organizzazione del progetto del account di servizio.
I token ID dei service account sono validi per un'ora e non possono essere revocati.
Token ID dell'identità dell'agente
I token ID dell'identità dell'agente sono documenti di identità verificabili SPIFFE (JWT-SVID) e autenticano un agente a cui è stata assegnata un'identità dell'agente.
Un agente può ottenere un token ID dal server dei metadati di Compute Engine.
Se vuole, l'agente può richiedere che il token sia associato al proprio certificato client X.509. Un token ID di identità dell'agente associato contiene l'impronta del certificato client X.509 nell'attestazione cnf.
A differenza dei token ID utente e dei token ID service account, i token ID identità agente non sono firmati dal set di chiavi web JSON (JWKS) di Google. I token ID dell'identità dell'agente sono invece firmati da un JWKS specifico per un pool di identità dell'agente.
Un token ID di identità dell'agente decodificato è simile al seguente, con SIGNATURE sostituito dalla firma del token:
{
"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 token ID di identità dell'agente include i seguenti campi:
| Campo | Nome | Descrizione |
|---|---|---|
aud |
Pubblico | Identificatore della parte a cui è destinato questo token. Il valore può essere scelto dal richiedente del token. |
exp |
Scadenza | La data di scadenza del token, nel formato dell'epoca di Unix. |
iss |
Emittente | L'emittente del token, ovvero il pool di identità degli agenti dell'organizzazione o del progetto che contiene l'agente. |
sub |
Oggetto | L'ID SPIFFE dell'agente. |
cnf.x5t#S256 |
Conferma | L'impronta del certificato client X.509 a cui è associato il token. L'attestazione è vuota se il token non è associato. |
Asserzioni di Identity-Aware Proxy
Le asserzioni di Identity-Aware Proxy (IAP) sono JSON Web Token (JWT) che IAP passa alle applicazioni web protette da IAP nell'intestazione della richiesta HTTP x-goog-iap-jwt-assertion. Le asserzioni IAP autenticano un utente e fungono anche da prova che una richiesta è stata autorizzata da IAP.
Account utente gestiti
Account consumer
Service account
Entità del pool di identità della forza lavoro
Un'attestazione IAP decodificata è simile alla seguente, con SIGNATURE sostituito dalla firma del token:
{
"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
Un'asserzione IAP include i seguenti campi:
| Campo | Nome | Descrizione |
|---|---|---|
aud |
Pubblico | Il servizio di backend, l'applicazione App Engine o il servizio Cloud Run a cui è destinata l'asserzione IAP. |
iss |
Emittente |
L'emittente del token, sempre impostato su
https://cloud.google.com/iap
|
sub |
Oggetto |
L'entità autenticata, identificata dal suo ID univoco. Se IAP è configurato per utilizzare le identità Google, questo ID equivale all'ID esposto nell'API Directory. |
Per ulteriori dettagli sulle attestazioni di asserzione IAP, consulta Verifica del payload JWT.
Le asserzioni IAP sono valide per 10 minuti e non possono essere revocate.