Questa pagina mostra come configurare Identity-Aware Proxy (IAP) per utilizzare la federazione delle identità per la forza lavoro. Per una panoramica dell'utilizzo della federazione delle identità per la forza lavoro con IAP, consulta Identità esterne.
Configura IAP con la federazione delle identità per la forza lavoro per un'applicazione
La configurazione di IAP con la federazione delle identità per la forza lavoro include le seguenti attività principali:
Configura un pool di forza lavoro e un provider.
Crea un ID client OAuth e un secret.
Abilita IAP e configuralo in modo che utilizzi la federazione delle identità per la forza lavoro.
Configura un pool di forza lavoro e un provider
Per configurare un pool di forza lavoro e un provider, segui le istruzioni per uno dei seguenti provider:
Quando imposti la durata della sessione, consulta Gestisci IAP con le sessioni di federazione delle identità per la forza lavoro.
Se vuoi mappare un indirizzo email da un IdP di terze parti aGoogle Cloud, devi aggiungere una mappatura degli attributi nel provider del pool di forza lavoro per google.email. Esempio: google.email=assertion.email.
Crea un ID client OAuth e un secret
Segui le istruzioni per creare un ID client e un secret OAuth in un progetto nella stessa organizzazione del pool di forza lavoro che utilizzerai per questa configurazione. Il progetto non deve essere lo stesso in cui si trova la risorsa protetta da IAP. Quando crei l'ID client OAuth e il secret, segui questi passaggi:
Utilizza un segnaposto per l'URI di reindirizzamento durante la creazione dell'ID client. Dopo aver creato l'ID client, esegui
describeun client OAuth per ottenere ilclientIDgenerato.Quando hai
clientID, eseguiupdateun client OAuth per aggiornareallowed-redirect-uriscome segue:https://iap.googleapis.com/v1/oauth/clientIds/$CLIENT_ID:handleRedirect.Dove
CLIENT_IDè ilclientIDrecuperato nel passaggio precedente.Dopo aver creato il client secret, esegui
describeun client OAuth credenziali per ottenere ilclientSecretgenerato.
Salva clientId e clientSecret perché ti serviranno nei passaggi successivi.
Abilita IAP per utilizzare la federazione delle identità per la forza lavoro
Per abilitare IAP con la federazione delle identità per la forza lavoro, completa i seguenti passaggi.
Abilita IAP
Abilita IAP sulla risorsa.
console
Nella console Google Cloud , apri la pagina IAP.
Vai alla pagina IAPSeleziona un progetto. Il progetto deve appartenere alla stessa organizzazione del pool di forza lavoro che hai creato in precedenza. Il progetto non deve essere quello in cui hai creato l'ID client OAuth e il secret.
Fai clic sulla scheda Applicazioni, quindi individua l'applicazione a cui vuoi limitare l'accesso utilizzando IAP.
Nella colonna IAP, sposta l'opzione su On.
gcloud
Per utilizzare gcloud CLI per abilitare IAP, segui le procedure per il servizio applicabile:
API
Crea un file
settings.json.cat << EOF > settings.json { "iap": { "enabled":true, } } EOF-
Abilita IAP su App Engine.
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d @settings.json \ "https://appengine.googleapis.com/v1/apps/PROJECT_ID?updateMask=iap.enabled"Per attivare IAP su Compute Engine, utilizza il seguente URL:
https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/REGION/backendServices/BACKEND_SERVICE_NAME?updateMask=iap.enabled.
Aggiorna le impostazioni di IAP
Per configurare IAP in modo che utilizzi la federazione delle identità per la forza lavoro, devi configurare le seguenti impostazioni:
WorkforceIdentitySettings: l'ID client OAuth e il secret creati in precedenza.IdentitySources: l'origine dell'identità.
Per saperne di più, consulta le API IAP.
gcloud
Utilizzando il seguente esempio come riferimento, crea un file
iap_settings.yaml.CLIENT_ID=clientId CLIENT_SECRET=clientSecret WORKFORCE_POOL_NAME=locations/global/workforcePools/test-pool cat <<EOF > iap_settings.yaml access_settings: identity_sources: ["WORKFORCE_IDENTITY_FEDERATION"] workforce_identity_settings: workforce_pools: ["$WORKFORCE_POOL_NAME"] oauth2: client_id: "$CLIENT_ID" client_secret: "$CLIENT_SECRET" EOFEsegui questo comando per aggiornare le impostazioni di IAP per la tua risorsa.
gcloud iap settings set iap_settings.yaml --project=PROJECT --resource-type=RESOURCE_TYPE --service=SERVICESostituisci quanto segue:
PROJECT: l'ID progetto.
RESOURCE_TYPE: il tipo di risorsa IAP. Il tipo di risorsa deve essere
cloud-run(anteprima),app-engine,iap_web,compute,organizationofolder. Per il tipo di risorsacloud-run, utilizza il flag--regionper indicare la regione in cui è stato eseguito il deployment del servizio Cloud Run.SERVICE: il nome del servizio. Questo è facoltativo sia per
app-engineche percompute.
Per maggiori dettagli sul comando, consulta
gcloud iap settings set.
API
Utilizzando il seguente esempio come riferimento, crea un file di impostazioni
iap_settings.json.CLIENT_ID=clientId CLIENT_SECRET=clientSecret WORKFORCE_POOL_NAME=locations/global/workforcePools/test-pool cat <<EOF > iap_settings.json { "access_settings": { "identity_sources": ["WORKFORCE_IDENTITY_FEDERATION"], "workforce_identity_settings": { "workforce_pools": ["$WORKFORCE_POOL_NAME"], "oauth2": { "client_id": "$CLIENT_ID", "client_secret": "$CLIENT_SECRET", } } } } EOFUtilizza gcloud CLI per ottenere il nome della risorsa, quindi copia
RESOURCE_NAMEdall'output perché ti servirà nel passaggio successivo.gcloud iap settings get \ --project=PROJECT \ --resource-type=RESOURCE_TYPE \ --service=SERVICESostituisci quanto segue:
PROJECT: l'ID progetto.
RESOURCE_TYPE: il tipo di risorsa IAP. Il tipo di risorsa deve essere
appengine,iap_web,compute,organization,folderocloud_run-$REGION(anteprima), dove $REGION è la regione in cui è stato eseguito il deployment del servizio Cloud Run.SERVICE: il nome del servizio. Questo è facoltativo sia per
app-engineche percompute.
Sostituisci
RESOURCE_NAMEnel comando seguente conRESOURCE_NAMEdel passaggio precedente.curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d @iap_settings.json \ "https://iap.googleapis.com/v1/RESOURCE_NAME:iapSettings?updateMask=iapSettings.accessSettings.identitySources,iapSettings.accessSettings.workforceIdentitySettings.workforcePools,iapSettings.accessSettings.workforceIdentitySettings.oauth2.clientId,iapSettings.accessSettings.workforceIdentitySettings.oauth2.clientSecret"
Concedi l'accesso alle risorse protette da IAP
Per accedere a una risorsa protetta da IAP, gli utenti finali devono avere il ruolo Utente applicazione web con protezione IAP sulla risorsa. Puoi concedere il ruolo Utente app web protetta da IAP a un singolo utente (entità) o a un insieme di utenti (insieme di entità, che corrisponde a un gruppo, a un attributo specifico o a un intero pool di utenti).
L'accesso illimitato alle risorse protette da IAP non è supportato.
console
Nella console Google Cloud , apri la pagina IAP.
Vai alla pagina IAPSeleziona la risorsa che vuoi proteggere con IAP.
Fai clic su Aggiungi entità, quindi aggiungi gli identificatori delle entità dei gruppi o delle persone a cui vuoi concedere un ruolo Identity and Access Management (IAM) per la risorsa.
In Assegna ruoli, seleziona Utente app web protetta da IAP.
Fai clic su Aggiungi.
gcloud
Esegui questo comando.
gcloud iap web add-iam-policy-binding \
--member=PRINCIPAL_IDENTIFIER \
--role='roles/iap.httpsResourceAccessor' \
--project=PROJECT_ID \
--resource-type=RESOURCE_TYPE \
--service=SERVICE \
--condition=CONDITION
Sostituisci quanto segue:
PRINCIPAL_IDENTIFIER: l'identificatore dell'entità.
PROJECT_ID: l'ID progetto.
- RESOURCE_TYPE: il tipo di risorsa IAP, che può essere
app-engineobackend-services.
SERVICE: (Facoltativo) Il nome del servizio.
CONDITION: (facoltativo) condizioni IAM. Di seguito è riportato un esempio di condizione configurata con i livelli di accesso:
expression="accessPolicies/12345678/accessLevels/iap_test_access_level" in request.auth.access_levels,title=iap-test-access-level,description=only access on weekdays
API
Questo metodo non è consigliato perché interessa l'intera policy IAM di una risorsa. Un errore potrebbe rimuovere la policy da una risorsa.
Ottieni le associazioni delle policy IAM esistenti.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d {} \ "https://iap.googleapis.com/v1/RESOURCE_NAME:getIamPolicy" -o iam_policy_bindings.jsonSostituisci RESOURCE_NAME con il RESOURCE_NAME che hai ottenuto in un passaggio precedente.
Nel file
iam_policy_bindings.jsonottenuto nel passaggio precedente, rimuovi le righe version ed etag e aggiungi l'associazione che vuoi aggiungere per l'identificatore dell'entità. Per saperne di più, consulta Informazioni sulle policy di autorizzazione.{ "bindings": [ { // existing bindings }, { "role": "roles/iap.httpsResourceAccessor", "members": [ "principal://iam.googleapis.com/locations/global/workforcePools/iap-test-pool/subject/iap-test-subject" ], "condition": { "expression": "\"accessPolicies/12345678/accessLevels/iap_test_access_level\" in request.auth.access_levels", "title": "iap-test-access-level", "description": "only access on weekdays" } } ] }Aggiorna le associazioni delle policy IAM.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d "{"policy":$(cat iam_policy_bindings.json)}" \ "https://iap.googleapis.com/v1/RESOURCE_NAME:setIamPolicy"Sostituisci RESOURCE_NAME con il RESOURCE_NAME che hai ottenuto in un passaggio precedente.
Per saperne di più, consulta GetIamPolicy e SetIamPolicy.
(Facoltativo) Configura l'accesso sensibile al contesto
Facoltativamente, puoi configurare regole di accesso sensibile al contesto per l'autorizzazione avanzata.
Per configurare i livelli di accesso, consulta Creazione e applicazione dei livelli di accesso. I livelli di accesso basati sulle informazioni del dispositivo non sono disponibili quando utilizzi la federazione delle identità per la forza lavoro. Puoi comunque utilizzare i livelli di accesso basati sul contesto della richiesta con condizioni relative all'indirizzo IP, all'ora e alla data.
Autenticazione programmatica
IAP supporta l'autenticazione JWT dei account di servizio per le applicazioni configurate con la federazione delle identità per la forza lavoro. Per le istruzioni, consulta Autenticazione con un account di servizio account.
Limitazioni relative all'utilizzo dei pool di forza lavoro
Quando utilizzi la federazione delle identità per la forza lavoro, tieni presente le seguenti limitazioni:
Quando utilizzi IAP con la federazione delle identità per la forza lavoro, si applicano le seguenti limitazioni:
Per ogni applicazione abilitata per IAP, è possibile configurare un solo pool di forza lavoro, che può contenere un solo provider.
Il pool di forza lavoro, l'ID client OAuth e il secret, nonché le applicazioni abilitate per IAP devono trovarsi tutti nella stessa organizzazione.
I livelli di accesso per le informazioni relative ai dispositivi non sono supportati.
Sono supportate solo le seguenti configurazioni delle impostazioni IAP:
Nel payload del JWT dell'intestazione firmata da IAP vengono trasmesse solo le seguenti attestazioni utente e della federazione delle identità per la forza lavoro:
sub: un identificatore univoco per l'utente, con il prefissosts.google.com:.email: viene propagato solo quando è specificata una mappaturagoogle.email=assertion.emaildurante la creazione del provider del pool di forza lavoro. Per saperne di più, consulta Mappature degli attributi.workforce_identity.workforce_pool_name: il nome del pool di forza lavoro nel formatolocations/global/workforcePools/WORKFORCE_POOL_ID.workforce_identity.iam_principal: l'identificatore dell'entità IAM nel formatoprincipal://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/subject/SUBJECT_ATTRIBUTE_VALUE.
L'accesso programmatico con la federazione delle identità per la forza lavoro è supportato solo per i service account Google.
Risoluzione dei problemi
Per informazioni sulla risoluzione dei problemi, consulta Risoluzione dei problemi e domande frequenti.