In questa pagina viene descritto come proteggere l'app con le intestazioni IAP firmate. Quando è configurato, Identity-Aware Proxy (IAP) utilizza i token web JSON (JWT) per assicurarsi che una richiesta alla tua app sia autorizzata. In questo modo, la tua app è protetta dai seguenti rischi:
- IAP è disattivato accidentalmente
- Firewall configurati in modo errato
- Accesso non autorizzato dall'interno del progetto
Per proteggere l'app, devi utilizzare le intestazioni firmate per tutti i tipi di app.
In alternativa, se hai un'app dell'ambiente standard App Engine, puoi utilizzare l'API Users.
I controlli di integrità di Compute Engine e GKE non includono le intestazioni JWT e IAP non elabora i controlli di integrità. Se il controllo di integrità restituisce errori di accesso, assicurati di aver configurato correttamente il controllo di integrità nellaconsola Google Cloud e che la convalida dell'intestazione JWT consenta il percorso del controllo di integrità. Per saperne di più, consulta Creare un'eccezione del controllo di integrità.
Prima di iniziare
Per proteggere l'app con le intestazioni firmate, avrai bisogno di:
- Un'applicazione a cui vuoi che gli utenti si connettano.
- Una libreria JWT di terze parti per la tua lingua che supporti
l'algoritmo
ES256.
Proteggere l'app con le intestazioni IAP
Per proteggere l'app con il JWT IAP, verifica l'intestazione, il payload e la firma del JWT. Il JWT si trova nell'intestazione della richiesta HTTP x-goog-iap-jwt-assertion. Se un utente malintenzionato bypassa IAP, può falsificare le intestazioni dell'identità non firmate di IAP, x-goog-authenticated-user-{email,id}. Il JWT IAP fornisce un'alternativa più sicura.
Le intestazioni firmate forniscono una sicurezza secondaria nel caso in cui qualcuno bypassi IAP. Quando IAP è abilitato, rimuove le intestazioni x-goog-* fornite dal client quando la richiesta passa attraverso l'infrastruttura di pubblicazione di IAP.
Verificare l'intestazione JWT
Verifica che l'intestazione del JWT sia conforme ai seguenti vincoli:
| Rivendicazioni dell'intestazione JWT | ||
|---|---|---|
alg |
Algoritmo | ES256 |
kid |
ID chiave |
Deve corrispondere a una delle chiavi pubbliche elencate nel
file di chiavi IAP, disponibile in due formati diversi:
https://www.gstatic.com/iap/verify/public_key
e
https://www.gstatic.com/iap/verify/public_key-jwk
|
Assicurati che il JWT sia stato firmato con la chiave privata corrispondente alla rivendicazione kid del token. Innanzitutto, recupera la chiave pubblica da uno dei due seguenti:
https://www.gstatic.com/iap/verify/public_key. Questo URL contiene un dizionario JSON che mappa le rivendicazionikidai valori della chiave pubblica.https://www.gstatic.com/iap/verify/public_key-jwk. Questo URL contiene le chiavi pubbliche IAP in JWKJWK.
Dopo aver ottenuto la chiave pubblica, utilizza una libreria JWT per verificare la firma.
IAP ruota periodicamente le chiavi pubbliche. Per assicurarti di poter sempre verificare i JWT, consulta Automatizzare la memorizzazione nella cache delle chiavi pubbliche.
Verificare il payload JWT
Verifica che il payload del JWT sia conforme ai seguenti vincoli:
| Rivendicazioni del payload JWT | ||
|---|---|---|
exp |
Scadenza | Deve essere nel futuro. L'ora è misurata in secondi trascorsi dall'epoca di Unix. Concedi 30 secondi per la distorsione. La durata massima di un token è di 10 minuti + 2 * distorsione. |
iat |
Ora di emissione | Deve essere nel passato. L'ora è misurata in secondi trascorsi dall'epoca di Unix. Concedi 30 secondi per la distorsione. |
aud |
Pubblico |
Deve essere una stringa con i seguenti valori:
|
iss |
Emittente |
Deve essere https://cloud.google.com/iap.
|
hd |
Dominio dell'account |
Se un account appartiene a un dominio ospitato, viene fornita la
hd rivendicazione per distinguere il
dominio a cui è associato l'account.
|
google |
Rivendicazione Google |
Se alla richiesta si applicano uno o più livelli di accesso
i relativi nomi vengono memorizzati nell'oggetto JSON della google
rivendicazione, sotto la chiave access_levels, come array
di stringhe.
Quando specifichi una policy per i dispositivi e l'organizzazione ha accesso ai dati sul dispositivo, anche |
Puoi ottenere i valori per la stringa aud menzionata sopra accedendo alla
Google Cloud console oppure utilizzando lo strumento a riga di comando gcloud.
Per ottenere i valori della stringa aud dalla Google Cloud console, vai alle
impostazioni del proxy Identity-Aware Proxy
per il tuo progetto, fai clic su Altro accanto alla risorsa del bilanciatore del carico e poi
seleziona Pubblico JWT con intestazione firmata. La finestra di dialogo JWT con intestazione firmata visualizzata mostra la rivendicazione aud per la risorsa selezionata.
Se vuoi utilizzare lo strumento a riga di comando gcloud CLI
gcloud per ottenere i valori della stringa aud, devi conoscere
l'ID progetto. Puoi trovare l'ID progetto nella
Google Cloud console
scheda Informazioni sul progetto, quindi esegui i comandi specificati per ogni valore.
Numero progetto
Per ottenere il numero del progetto utilizzando lo strumento a riga di comando gcloud, esegui il comando seguente:
gcloud projects describe PROJECT_ID
Il comando restituisce un output simile al seguente:
createTime: '2016-10-13T16:44:28.170Z' lifecycleState: ACTIVE name: project_name parent: id: '433637338589' type: organization projectId: PROJECT_ID projectNumber: 'PROJECT_NUMBER'
ID servizio
Per ottenere l'ID servizio utilizzando lo strumento a riga di comando gcloud, esegui il comando seguente:
gcloud compute backend-services describe SERVICE_NAME --project=PROJECT_ID --global
Il comando restituisce un output simile al seguente:
affinityCookieTtlSec: 0 backends: - balancingMode: UTILIZATION capacityScaler: 1.0 group: https://www.googleapis.com/compute/v1/projects/project_name/regions/us-central1/instanceGroups/my-group connectionDraining: drainingTimeoutSec: 0 creationTimestamp: '2017-04-03T14:01:35.687-07:00' description: '' enableCDN: false fingerprint: zaOnO4k56Cw= healthChecks: - https://www.googleapis.com/compute/v1/projects/project_name/global/httpsHealthChecks/my-hc id: 'SERVICE_ID' kind: compute#backendService loadBalancingScheme: EXTERNAL name: my-service port: 8443 portName: https protocol: HTTPS selfLink: https://www.googleapis.com/compute/v1/projects/project_name/global/backendServices/my-service sessionAffinity: NONE timeoutSec: 3610
Recuperare l'identità dell'utente
Se tutte le verifiche precedenti hanno esito positivo, recupera l'identità dell'utente. Il payload del token ID contiene le seguenti informazioni sull'utente:
| Identità utente del payload del token ID | ||
|---|---|---|
sub |
Oggetto |
L'identificatore univoco e stabile dell'utente. Utilizza questo valore anziché l'
x-goog-authenticated-user-id intestazione.
|
email |
Email dell'utente | Indirizzo email dell'utente.
|
Di seguito è riportato un codice campione per proteggere un'app con le intestazioni IAP firmate: