La federazione delle identità per la forza lavoro ti consente di utilizzare il provider di identità (IdP) Microsoft Entra ID per gestire l'accesso a Google Cloud. Dopo aver federato le identità utilizzando il protocollo OpenID Connect (OIDC) o SAML 2.0, gli utenti federati possono accedere ai servizi Google Cloud che supportano la federazione delle identità per la forza lavoro.
Prima di iniziare
- Assicurati di aver configurato un'organizzazione Google Cloud .
-
Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il comando seguente:
gcloud initSe utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.
- In Microsoft Entra ID, assicurati che i token ID siano abilitati per il flusso implicito. Per maggiori informazioni, consulta Abilita la concessione implicita del token ID.
- Per l'accesso, l'IdP deve fornire informazioni di autenticazione firmate: gli IdP OIDC devono fornire un JWT e le risposte dell'IdP SAML devono essere firmate.
- Per ricevere informazioni importanti sulle modifiche alla tua organizzazione o ai prodottiGoogle Cloud , devi fornire i contatti essenziali. Per saperne di più, consulta la panoramica della federazione delle identità per la forza lavoro.
Costi
La federazione delle identità per la forza lavoro è disponibile come funzionalità senza costi. Tuttavia, l'audit logging dettagliato della federazione delle identità per la forza lavoro utilizza Cloud Logging. Per informazioni sui prezzi di Logging, consulta Prezzi di Google Cloud Observability.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per configurare la federazione delle identità per la forza lavoro, chiedi all'amministratore di concederti il ruolo IAM Amministratore pool di forza lavoro IAM (roles/iam.workforcePoolAdmin) nell'organizzazione.
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.
Se stai configurando le autorizzazioni in un ambiente di sviluppo o di test, ma non in un ambiente di produzione, puoi concedere il ruolo di base Proprietario IAM (roles/owner), che include anche le autorizzazioni per la federazione delle identità per la forza lavoro.
Crea un'applicazione Microsoft Entra ID
Questa sezione mostra come creare un'applicazione Microsoft Entra ID utilizzando l'interfaccia di amministrazione di Microsoft Entra. In alternativa, puoi aggiornare l'applicazione esistente. Per ulteriori dettagli, consulta Stabilire le applicazioni nell'ecosistema Microsoft Entra ID.I pool di identità per la forza lavoro supportano la federazione utilizzando i protocolli OIDC e SAML.
OIDC
Per creare una registrazione dell'applicazione Microsoft Entra ID che utilizza il protocollo OIDC, segui questi passaggi:
Accedi all'interfaccia di amministrazione di Microsoft Entra.
Vai a Entra ID > Registrazioni app.
Per iniziare a configurare la registrazione dell'applicazione, segui questi passaggi:
Fai clic su Nuova registrazione.
Inserisci un nome per l'applicazione.
In Tipi di account supportati, seleziona un'opzione.
Nella sezione URI di reindirizzamento, nell'elenco a discesa Seleziona una piattaforma, seleziona Web.
Nel campo di testo, inserisci un URL di reindirizzamento. Gli utenti vengono reindirizzati a questo URL dopo aver eseguito l'accesso. Se stai configurando l'accesso alla console (federata), utilizza il seguente formato URL:
https://auth.cloud.google/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_IDSostituisci quanto segue:
WORKFORCE_POOL_ID: un ID pool di identità della forza lavoro che utilizzi quando crei il pool di identità della forza lavoro più avanti in questo documento, ad esempioentra-id-oidc-pool.WORKFORCE_PROVIDER_ID: un ID provider di pool di identità della forza lavoro che utilizzi quando crei il provider di pool di identità della forza lavoro più avanti in questo documento, ad esempioentra-id-oidc-pool-provider.Per informazioni sulla formattazione dell'ID, consulta la sezione Parametri di query della documentazione dell'API.
Per creare la registrazione dell'applicazione, fai clic su Register (Registra).
Per utilizzare la mappatura degli attributi di esempio fornita più avanti in questo documento, devi creare un attributo
departmentpersonalizzato.
Consigliato: come best practice per la sicurezza, ti consigliamo di configurare un'attestazione di gruppo nel seguente modo:
Vai alla registrazione dell'applicazione Microsoft Entra ID.
Fai clic su Configurazione token.
Fai clic su Aggiungi rivendicazione gruppi.
Seleziona i tipi di gruppi da restituire. Per maggiori dettagli, consulta Configurazione delle attestazioni facoltative dei gruppi.
SAML
Per creare una registrazione dell'applicazione Microsoft Entra ID che utilizza il protocollo SAML, segui questi passaggi:
Accedi all'interfaccia di amministrazione di Microsoft Entra.
Vai a Entra ID > Applicazioni aziendali.
Per iniziare a configurare l'applicazione aziendale, segui questi passaggi:
Fai clic su Nuova applicazione > Crea la tua applicazione.
Nel riquadro Crea la tua applicazione visualizzato, inserisci un nome per l'applicazione.
Fai clic su Crea.
Vai a Single Sign-On > SAML.
Aggiorna la sezione Basic SAML Configuration (Configurazione SAML di base) come segue:
Nel campo Identifier (Entity ID) (Identificatore (ID entità)), inserisci il seguente valore:
https://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_IDSostituisci quanto segue:
WORKFORCE_POOL_ID: un ID del pool di identità della forza lavoro che utilizzi quando crei il pool di identità della forza lavoro più avanti in questo documento, ad esempioentra-id-saml-pool.WORKFORCE_PROVIDER_ID: un ID provider di pool di identità della forza lavoro che utilizzi quando crei il provider di pool di identità della forza lavoro più avanti in questo documento, ad esempioentra-id-saml-pool-provider.Per informazioni sulla formattazione dell'ID, consulta la sezione Parametri di query della documentazione dell'API.
Nel campo Reply URL (Assertion Consumer Service URL) (URL di risposta (URL Assertion Consumer Service)), inserisci un URL di reindirizzamento. I tuoi utenti vengono reindirizzati a questo URL dopo aver eseguito l'accesso. Se stai configurando l'accesso alla console (federata), utilizza il seguente formato URL:
https://auth.cloud.google/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_IDSostituisci quanto segue:
WORKFORCE_POOL_ID: l'ID del pool di identità della forza lavoro.WORKFORCE_PROVIDER_ID: l'ID provider del pool di identità della forza lavoro.
Per attivare l'accesso avviato da IdP, imposta il campo Stato di inoltro sul seguente valore:
https://console.cloud.google/Per salvare la configurazione dell'applicazione SAML, fai clic su Salva.
Per utilizzare la mappatura degli attributi di esempio fornita più avanti in questo documento, devi creare un attributo
departmentpersonalizzato.
Consigliato: come best practice per la sicurezza, ti consigliamo di configurare un'attestazione di gruppo nel seguente modo:
Vai alla tua applicazione Microsoft Entra ID.
Fai clic su Single sign-on.
Nella sezione Attributes & Claims (Attributi e rivendicazioni), fai clic su Edit (Modifica).
Fai clic su Aggiungi un'attestazione di gruppo.
Seleziona il tipo di gruppo da restituire. Per maggiori dettagli, consulta Aggiungi attestazioni di gruppo ai token per le applicazioni SAML utilizzando la configurazione SSO.
Crea un pool di identità per la forza lavoro
gcloud
Per creare il pool di identità per la forza lavoro, esegui questo comando:
gcloud iam workforce-pools create WORKFORCE_POOL_ID \
--organization=ORGANIZATION_ID \
--display-name="DISPLAY_NAME" \
--description="DESCRIPTION" \
--session-duration=SESSION_DURATION \
--location=global
Sostituisci quanto segue:
WORKFORCE_POOL_ID: un ID scelto da te per rappresentare il tuo pool di forza lavoro Google Cloud . L'ID pool deve essere univoco a livello globale in tutti i pool di identità della forza lavoro in Google Cloud. Per informazioni sulla formattazione dell'ID, consulta la sezione Parametri di query nella documentazione dell'API.ORGANIZATION_ID: l'ID organizzazione numerico della tua organizzazione Google Cloud per il pool di identità della forza lavoro. I pool di identità della forza lavoro sono disponibili in tutti i progetti e le cartelle dell'organizzazione.DISPLAY_NAME: (Facoltativo) Un nome visualizzato per il pool di identità della forza lavoro.DESCRIPTION: (Facoltativo) Descrizione di un pool di identità della forza lavoro.SESSION_DURATION: (Facoltativo) La durata della sessione, espressa come numero seguito das, ad esempio3600s. La durata della sessione determina per quanto tempo sono validi i Google Cloud token di accesso, le sessioni di accesso alla console (federata) e le sessioni di accesso a gcloud CLI di questo pool di forza lavoro. La durata della sessione è impostata su un'ora (3600 s) per impostazione predefinita. Il valore della durata della sessione deve essere compreso tra 15 minuti (900 s) e 12 ore (43.200 s).
Console
Per creare il pool di identità della forza lavoro, segui questi passaggi:
Nella console Google Cloud , vai alla pagina Pool di identità per la forza lavoro:
Seleziona l'organizzazione per il pool di identità della forza lavoro. I pool di identità della forza lavoro sono disponibili in tutti i progetti e le cartelle di un'organizzazione.
Fai clic su Crea pool e segui questi passaggi:
Nel campo Nome, inserisci il nome visualizzato del pool. L'ID pool viene ricavato automaticamente dal nome durante la digitazione e viene visualizzato sotto il campo Nome. Puoi aggiornare l'ID pool facendo clic su Modifica accanto all'ID pool.
(Facoltativo) In Descrizione, inserisci una descrizione del pool.
Per creare il pool di identità per la forza lavoro, fai clic su Avanti.
La durata della sessione del pool di identità della forza lavoro è di un'ora (3600 s) per impostazione predefinita. La durata della sessione determina per quanto tempo sono validi i token di accesso Google Cloud , la console (federata) e le sessioni di accesso di gcloud CLI di questo pool di forza lavoro. Dopo aver creato il pool, puoi aggiornarlo per impostare una durata della sessione personalizzata. La durata della sessione deve essere compresa tra 15 minuti (900 secondi) e 12 ore (43.200 secondi).
Crea il provider del pool di identità per la forza lavoro di Microsoft Entra ID
Questa sezione descrive come creare un provider di pool di identità per la forza lavoro per consentire agli utenti IdP di accedere a Google Cloud. Puoi configurare il provider in modo che utilizzi il protocollo OIDC o SAML.
Crea un provider di pool di identità della forza lavoro OIDC
Per creare un provider di pool di identità per la forza lavoro per l'integrazione delle applicazioni Microsoft Entra ID utilizzando il protocollo OIDC, segui questi passaggi:
Per ottenere l'URI dell'emittente per la tua applicazione Microsoft Entra ID:
- Vai alla pagina Panoramica della registrazione dell'applicazione Microsoft Entra ID.
- Fai clic su Endpoint.
Trova l'endpoint Documento di metadati OpenID Connect. L'URI dell'emittente è l'URI del documento di metadati OpenID Connect, omettendo il suffisso
/.well-known/openid-configuration.Ad esempio, se l'URI del documento di metadati OpenID Connect è
https://login.microsoftonline.com/d41ad248-019e-49e5-b3de-4bdfe1fapple/v2.0/.well-known/openid-configuration, l'URI dell'emittente èhttps://login.microsoftonline.com/d41ad248-019e-49e5-b3de-4bdfe1fapple/v2.0/. In alternativa, puoi copiare l'URL del documento di metadati OpenID Connect, aprirlo in una scheda del browser e copiare il valore diissuerdalla risposta JSON.
Per ottenere l'ID client per l'applicazione Microsoft Entra ID:
- Vai alla pagina Panoramica della registrazione dell'applicazione Microsoft Entra ID.
- In ID applicazione (client), copia il valore.
Per creare un provider di pool di identità della forza lavoro OIDC per l'accesso basato sul web, segui questi passaggi:
gcloud
Per creare un provider che supporti il protocollo OIDC, segui questi passaggi:
Flusso codice
Per creare un provider OIDC che utilizzi il flusso del codice di autorizzazione per l'accesso basato sul web, segui questi passaggi:
Nell'applicazione Microsoft Entra ID, per ottenere il client secret, segui questi passaggi:
Vai alla registrazione dell'app Microsoft Entra ID.
In Certificati e secret, fai clic sulla scheda Client secret.
Per aggiungere un client secret, fai clic su + Nuovo client secret.
Nella finestra di dialogo Aggiungi un client secret, inserisci le informazioni necessarie.
Per creare il client secret, fai clic su Aggiungi.
Nella scheda Client secret, individua il nuovo client secret.
Nella colonna Valore del nuovo client secret, fai clic su content_copy Copia.
Per creare il provider, esegui questo comando:
gcloud iam workforce-pools providers create-oidc WORKFORCE_PROVIDER_ID \ --workforce-pool=WORKFORCE_POOL_ID \ --display-name="DISPLAY_NAME" \ --description="DESCRIPTION" \ --issuer-uri="ISSUER_URI" \ --client-id="OIDC_CLIENT_ID" \
--client-secret-value="OIDC_CLIENT_SECRET" \
--vendor-type="entra-id" \ --web-sso-response-type="code" \ --web-sso-assertion-claims-behavior="merge-user-info-over-id-token-claims" \ --web-sso-additional-scopes="WEB_SSO_ADDITIONAL_SCOPES" \ --attribute-mapping="ATTRIBUTE_MAPPING" \ --attribute-condition="ATTRIBUTE_CONDITION" \ --jwk-json-path="JWK_JSON_PATH" \ --detailed-audit-logging \ --location=globalSostituisci quanto segue:
WORKFORCE_PROVIDER_ID: un ID provider del pool di identità della forza lavoro univoco. Il prefissogcp-è riservato e non può essere utilizzato in un ID pool di identità della forza lavoro o in un ID provider del pool di identità della forza lavoro.WORKFORCE_POOL_ID: l'ID del pool di identità della forza lavoro a cui connettere l'IdP.DISPLAY_NAME: un nome visualizzato facoltativo facile da usare per il provider, ad esempioidp-eu-employees.DESCRIPTION: una descrizione facoltativa del provider della forza lavoro, ad esempioIdP for Partner Example Organization employees.ISSUER_URI: l'URI dell'emittente OIDC, in un formato URI valido, che inizia conhttps; ad esempio,https://example.com/oidc. Nota: per motivi di sicurezza,ISSUER_URIdeve utilizzare lo schema HTTPS.OIDC_CLIENT_ID: l'ID client OIDC registrato con il tuo IdP OIDC; l'ID deve corrispondere alla rivendicazioneauddel JWT emesso dal tuo IdP.OIDC_CLIENT_SECRET: il client secret OIDC.WEB_SSO_ADDITIONAL_SCOPES: ambiti aggiuntivi facoltativi da inviare all'IdP OIDC per l'accesso basato su browser della console (federato) o di gcloud CLI.ATTRIBUTE_MAPPING: una mappatura degli attributi. Per Microsoft Entra ID con autenticazione OIDC, consigliamo le seguenti mappature degli attributi:google.subject=assertion.oid, google.groups=assertion.groups, google.display_name=assertion.preferred_usernameQuesto esempio mappa gli attributi IdP
assertion.oid,assertion.groupseassertion.preferred_usernameagli attributi Google Cloudgoogle.subject,google.groupsegoogle.display_name, rispettivamente.ATTRIBUTE_CONDITION: una condizione dell'attributo; ad esempio, per limitare l'attributoipaddra un determinato intervallo IP, puoi impostare la condizioneassertion.ipaddr.startsWith('98.11.12.').JWK_JSON_PATH: un percorso facoltativo per un JWK OIDC caricato localmente. Se questo parametro non viene fornito, Google Cloud utilizza il percorso/.well-known/openid-configurationdel tuo IdP per recuperare i JWK contenenti le chiavi pubbliche. Per saperne di più sui JWK OIDC caricati localmente, consulta Gestisci i JWK OIDC.-
L'audit logging dettagliato della federazione delle identità per la forza lavoro registra le informazioni ricevute dall'IdP in Logging. L'audit logging dettagliato può aiutarti a risolvere i problemi di configurazione del provider del pool di identità per la forza lavoro. Per scoprire come risolvere gli errori di mappatura degli attributi con l'audit logging dettagliato, consulta Errori generali di mappatura degli attributi. Per scoprire di più sui prezzi di Logging, consulta Prezzi di Google Cloud Observability.
Per disattivare l'audit logging dettagliato per un provider di pool di identità per la forza lavoro, ometti il flag
--detailed-audit-loggingquando eseguigcloud iam workforce-pools providers create. Per disattivare l'audit logging dettagliato, puoi anche aggiornare il provider.
Il flag
--web-sso-assertion-claims-behaviorcontrolla il modo in cui le rivendicazioni OIDC vengono incluse nell'oggettoassertionutilizzato per le mappature e le condizioni degli attributi. Per il flusso del codice di autorizzazione (--web-sso-response-type="code"), puoi impostare questo flag su uno dei seguenti valori:-
merge-user-info-over-id-token-claims: unisce le rivendicazioni dell'endpoint OIDCUserInfocon quelle del token ID. Se entrambi contengono lo stesso nome di rivendicazione, il valore della rivendicazioneUserInfoha la precedenza. Utilizza questo valore quando l'IdP restituisce attributi utente o attestazioni di gruppo aggiuntivi dall'endpointUserInfo. -
only-id-token-claims: include solo le rivendicazioni del token ID. Utilizza questo valore quando tutte le rivendicazioni richieste per le mappature e le condizioni degli attributi sono già presenti nel token ID.
locations/global/workforcePools/enterprise-example-organization-employees.
Flusso implicito
Per creare un provider OIDC che utilizzi il flusso implicito per l'accesso web, segui questi passaggi:
Per attivare il token ID nell'applicazione Microsoft Entra ID, segui questi passaggi:
- Vai alla registrazione dell'applicazione Microsoft Entra ID.
- In Autenticazione, seleziona la casella di controllo Token ID.
- Fai clic su Salva.
Per creare il provider, esegui questo comando:
gcloud iam workforce-pools providers create-oidc WORKFORCE_PROVIDER_ID \ --workforce-pool=WORKFORCE_POOL_ID \ --display-name="DISPLAY_NAME" \ --description="DESCRIPTION" \ --issuer-uri="ISSUER_URI" \ --client-id="OIDC_CLIENT_ID" \
--vendor-type="entra-id" \ --web-sso-response-type="id-token" \ --web-sso-assertion-claims-behavior="only-id-token-claims" \ --web-sso-additional-scopes="WEB_SSO_ADDITIONAL_SCOPES" \ --attribute-mapping="ATTRIBUTE_MAPPING" \ --attribute-condition="ATTRIBUTE_CONDITION" \ --jwk-json-path="JWK_JSON_PATH" \ --detailed-audit-logging \ --location=globalSostituisci quanto segue:
WORKFORCE_PROVIDER_ID: un ID provider del pool di identità della forza lavoro univoco. Il prefissogcp-è riservato e non può essere utilizzato in un ID pool di identità della forza lavoro o in un ID provider del pool di identità della forza lavoro.WORKFORCE_POOL_ID: l'ID del pool di identità della forza lavoro a cui connettere l'IdP.DISPLAY_NAME: un nome visualizzato facoltativo facile da usare per il provider, ad esempioidp-eu-employees.DESCRIPTION: una descrizione facoltativa del provider della forza lavoro, ad esempioIdP for Partner Example Organization employees.ISSUER_URI: l'URI dell'emittente OIDC, in un formato URI valido, che inizia conhttps; ad esempio,https://example.com/oidc. Nota: per motivi di sicurezza,ISSUER_URIdeve utilizzare lo schema HTTPS.OIDC_CLIENT_ID: l'ID client OIDC registrato con il tuo IdP OIDC; l'ID deve corrispondere alla rivendicazioneauddel JWT emesso dal tuo IdP.WEB_SSO_ADDITIONAL_SCOPES: ambiti aggiuntivi facoltativi da inviare all'IdP OIDC per l'accesso basato su browser della console (federato) o di gcloud CLI.ATTRIBUTE_MAPPING: una mappatura degli attributi. Per Microsoft Entra ID con autenticazione OIDC, consigliamo le seguenti mappature degli attributi:google.subject=assertion.oid, google.groups=assertion.groups, google.display_name=assertion.preferred_usernameQuesto esempio mappa gli attributi IdP
assertion.oid,assertion.groupseassertion.preferred_usernameagli attributi Google Cloudgoogle.subject,google.groupsegoogle.display_name, rispettivamente.ATTRIBUTE_CONDITION: una condizione dell'attributo; ad esempio, per limitare l'attributoipaddra un determinato intervallo IP, puoi impostare la condizioneassertion.ipaddr.startsWith('98.11.12.').JWK_JSON_PATH: un percorso facoltativo per un JWK OIDC caricato localmente. Se questo parametro non viene fornito, Google Cloud utilizza il percorso/.well-known/openid-configurationdel tuo IdP per recuperare i JWK contenenti le chiavi pubbliche. Per saperne di più sui JWK OIDC caricati localmente, consulta Gestisci i JWK OIDC.-
L'audit logging dettagliato della federazione delle identità per la forza lavoro registra le informazioni ricevute dall'IdP in Logging. L'audit logging dettagliato può aiutarti a risolvere i problemi di configurazione del provider del pool di identità per la forza lavoro. Per scoprire come risolvere gli errori di mappatura degli attributi con l'audit logging dettagliato, consulta Errori generali di mappatura degli attributi. Per scoprire di più sui prezzi di Logging, consulta Prezzi di Google Cloud Observability.
Per disattivare l'audit logging dettagliato per un provider di pool di identità per la forza lavoro, ometti il flag
--detailed-audit-loggingquando eseguigcloud iam workforce-pools providers create. Per disattivare l'audit logging dettagliato, puoi anche aggiornare il provider.
Per il flusso implicito (
Nella risposta al comando, POOL_RESOURCE_NAME è il nome del pool, ad esempio--web-sso-response-type="id-token"), devi impostare il flag--web-sso-assertion-claims-behaviorsuonly-id-token-claims, che include solo le rivendicazioni del token ID nell'oggettoassertion. Il flusso implicito non supporta il valoremerge-user-info-over-id-token-claims.locations/global/workforcePools/enterprise-example-organization-employees.
Console
Flusso codice
Per creare un provider OIDC che utilizzi il flusso del codice di autorizzazione per l'accesso basato sul web, segui questi passaggi:
Per ottenere il client secret di Microsoft Entra ID:
Vai alla registrazione dell'app Microsoft Entra ID.
In Certificati e secret, fai clic sulla scheda Client secret.
Per aggiungere un client secret, fai clic su + Nuovo client secret.
Nella finestra di dialogo Aggiungi un client secret, inserisci le informazioni necessarie.
Per creare il client secret, fai clic su Aggiungi.
Nella scheda Client secret, individua il nuovo client secret.
Nella colonna Valore del nuovo client secret, fai clic su content_copy Copia.
- Nella console Google Cloud , vai alla pagina Pool di identità per la forza lavoro:
- Nella tabella Pool di identità per la forza lavoro, seleziona il pool per cui vuoi creare il provider.
- Nella sezione Provider, fai clic su Aggiungi provider.
- Nell'elenco Seleziona un provider, seleziona il tuo IdP.
Se il tuo IdP non è presente nell'elenco, seleziona Provider di identità generico.
- In Seleziona un protocollo di autenticazione, seleziona OpenID Connect (OIDC).
- Nella sezione Crea un provider, segui questi passaggi:
- In Nome, inserisci il nome del provider.
- In Descrizione, inserisci la descrizione del provider.
- In Issuer (URL) (Emittente (URL)), inserisci l'URI dell'emittente. L'URI dell'emittente OIDC deve essere in un formato URI valido e iniziare con
https, ad esempiohttps://example.com/oidc. - In ID client, inserisci l'ID client OIDC registrato con il tuo IdP OIDC; l'ID deve corrispondere alla rivendicazione
auddel JWT emesso dal tuo IdP. - Per creare un provider abilitato, assicurati che l'opzione Abilita provider sia attiva.
- Fai clic su Continua.
- Nella sezione Condividi le informazioni del tuo provider con l'IdP, copia l'URL. Nell'IdP, configura questo URL come URI di reindirizzamento, che indica all'IdP dove inviare il token di asserzione dopo l'accesso.
- Fai clic su Continua.
- Nella sezione Configura l'accesso web OIDC, segui questi passaggi:
- Nell'elenco Tipo di flusso, seleziona Codice.
- Nell'elenco Comportamento delle dichiarazioni di asserzione, seleziona una delle seguenti opzioni:
- Informazioni utente e token ID: unisce le rivendicazioni dell'endpoint
UserInfocon quelle del token ID, preferendo i valori delle rivendicazioniUserInfoper lo stesso nome della rivendicazione. Seleziona questa opzione se l'IdP restituisce attributi utente o claim di gruppo aggiuntivi dall'endpointUserInfo. - Solo token ID: include solo le rivendicazioni del token ID. Seleziona questa opzione quando tutte le rivendicazioni richieste per le mappature e le condizioni degli attributi sono già presenti nel token ID.
- Informazioni utente e token ID: unisce le rivendicazioni dell'endpoint
- Nel campo Client secret, inserisci il client secret del tuo IdP.
- Fai clic su Continua.
- Nella sezione Configura provider, per Logging dettagliato, fai clic sul pulsante di attivazione/disattivazione Abilita l'audit logging dei valori degli attributi.
L'audit logging dettagliato della federazione delle identità per la forza lavoro registra le informazioni ricevute dall'IdP in Logging. L'audit logging dettagliato può aiutarti a risolvere i problemi di configurazione del provider del pool di identità per la forza lavoro. Per scoprire come risolvere gli errori di mappatura degli attributi con l'audit logging dettagliato, consulta Errori generali di mappatura degli attributi. Per scoprire di più sui prezzi di Logging, consulta Prezzi di Google Cloud Observability.
Per disattivare l'audit logging dettagliato per un provider di pool di identità per la forza lavoro, lascia disattivato il pulsante di attivazione/disattivazione Abilita l'audit logging dei valori degli attributi quando crei il provider. Per disattivare l'audit logging dettagliato, puoi anche aggiornare il provider.
- Per creare il provider, fai clic su Invia.
Dopo aver creato il provider, viene visualizzata la pagina degli attributi del provider.
Per configurare le mappature e le condizioni degli attributi, segui questi passaggi:
- Quando richiesto, accedi al tuo IdP esterno per convalidare le mappature degli attributi predefinite.
- Nella pagina degli attributi del provider, visualizza e modifica le mappature e le condizioni degli attributi:
- Per aggiungere o modificare le mappature degli attributi:
- Fai clic su Aggiungi mappatura per aggiungere una nuova mappatura o modificare quelle esistenti.
- Nel campo Google n, dove n è un numero, seleziona una chiave supportata da Google Cloud.
- Nel campo OIDC n corrispondente, inserisci il nome dell'attributo IdP o un'espressione CEL.
Per Microsoft Entra ID con autenticazione OIDC, consigliamo le seguenti mappature degli attributi:
google.subject=assertion.oid, google.groups=assertion.groups, google.display_name=assertion.preferred_usernameQuesto esempio mappa gli attributi IdP
assertion.oid,assertion.groupseassertion.preferred_usernameagli attributi Google Cloudgoogle.subject,google.groupsegoogle.display_name, rispettivamente.
- Per aumentare il numero di gruppi, procedi nel seguente modo:
- Fai clic su Attiva per gli attributi aggiuntivi.
- Nell'attività secondaria che si apre, inserisci i seguenti dettagli:
- Nel campo URI emittente attributi aggiuntivi, inserisci l'URL dell'emittente.
- Nel campo ID client attributi aggiuntivi, inserisci l'ID client.
- Nel campo Client secret attributi aggiuntivi, inserisci il client secret.
- Nell'elenco Tipo di attributi aggiuntivi, seleziona un tipo di attributo per gli attributi aggiuntivi.
- Nel campo Filtro attributi aggiuntivi, inserisci un'espressione di filtro da utilizzare quando esegui una query sull'API Microsoft Graph per i gruppi.
- Fai clic su Attiva.
Dopo aver attivato gli attributi aggiuntivi, puoi fare clic su Modifica per riaprire l'attività secondaria e modificare i dettagli oppure su Disattiva per disattivare gli attributi aggiuntivi.
- Per aggiungere una condizione di attributo, segui questi passaggi:
- Fai clic su Aggiungi condizione.
- Nel campo Condizioni degli attributi, inserisci una condizione in formato CEL; ad esempio, per limitare l'attributo
ipaddra un determinato intervallo IP, puoi impostare la condizioneassertion.ipaddr.startsWith('98.11.12.').
- Per aggiungere o modificare le mappature degli attributi:
- Per convalidare le mappature, fai clic su Salva e recupera di nuovo il token.
- Per completare la configurazione, fai clic su Salva ed esci.
Flusso implicito
Per creare un provider OIDC che utilizzi il flusso implicito per l'accesso basato sul web, segui questi passaggi:
Per attivare il token ID nell'applicazione Microsoft Entra ID, segui questi passaggi:
- Vai alla registrazione dell'applicazione Microsoft Entra ID.
- In Autenticazione, seleziona la casella di controllo Token ID.
- Fai clic su Salva.
- Nella console Google Cloud , vai alla pagina Pool di identità per la forza lavoro:
- Nella tabella Pool di identità per la forza lavoro, seleziona il pool per cui vuoi creare il provider.
- Nella sezione Provider, fai clic su Aggiungi provider.
- Nell'elenco Seleziona un provider, seleziona il tuo IdP.
Se il tuo IdP non è presente nell'elenco, seleziona Provider di identità generico.
- In Seleziona un protocollo di autenticazione, seleziona OpenID Connect (OIDC).
- Nella sezione Crea un provider, segui questi passaggi:
- In Nome, inserisci il nome del provider.
- In Descrizione, inserisci la descrizione del provider.
- In Issuer (URL) (Emittente (URL)), inserisci l'URI dell'emittente. L'URI dell'emittente OIDC deve essere in un formato URI valido e iniziare con
https, ad esempiohttps://example.com/oidc. - In ID client, inserisci l'ID client OIDC registrato con il tuo IdP OIDC; l'ID deve corrispondere alla rivendicazione
auddel JWT emesso dal tuo IdP. - Per creare un provider abilitato, assicurati che l'opzione Abilita provider sia attiva.
- Fai clic su Continua.
- Nella sezione Condividi le informazioni del tuo provider con l'IdP, copia l'URL. Nell'IdP, configura questo URL come URI di reindirizzamento, che indica all'IdP dove inviare il token di asserzione dopo l'accesso.
- Fai clic su Continua.
- Nella sezione Configura l'accesso web OIDC, segui questi passaggi:
- Nell'elenco Tipo di flusso, seleziona Token ID.
- Nell'elenco Comportamento delle rivendicazioni di asserzione, è selezionato Token ID.
- Fai clic su Continua.
- Nella sezione Configura provider, in Logging dettagliato, fai clic sul pulsante di attivazione/disattivazione Abilita l'audit logging dei valori degli attributi.
L'audit logging dettagliato della federazione delle identità per la forza lavoro registra le informazioni ricevute dall'IdP in Logging. L'audit logging dettagliato può aiutarti a risolvere i problemi di configurazione del provider del pool di identità per la forza lavoro. Per scoprire come risolvere gli errori di mappatura degli attributi con l'audit logging dettagliato, consulta Errori generali di mappatura degli attributi. Per scoprire di più sui prezzi di Logging, consulta Prezzi di Google Cloud Observability.
Per disattivare l'audit logging dettagliato per un provider di pool di identità per la forza lavoro, lascia disattivato il pulsante di attivazione/disattivazione Abilita l'audit logging dei valori degli attributi quando crei il provider. Per disattivare l'audit logging dettagliato, puoi anche aggiornare il provider.
- Per creare il provider, fai clic su Invia.
Dopo aver creato il provider, viene visualizzata la pagina degli attributi del provider.
Per configurare le mappature e le condizioni degli attributi, segui questi passaggi:
- Quando richiesto, accedi al tuo IdP esterno per convalidare le mappature degli attributi predefinite.
- Nella pagina degli attributi del provider, visualizza e modifica le mappature e le condizioni degli attributi:
- Per aggiungere o modificare le mappature degli attributi:
- Fai clic su Aggiungi mappatura per aggiungere una nuova mappatura o modificare quelle esistenti.
- Nel campo Google n, dove n è un numero, seleziona una chiave supportata da Google Cloud.
- Nel campo OIDC n corrispondente, inserisci il nome dell'attributo IdP o un'espressione CEL.
Per Microsoft Entra ID con autenticazione OIDC, consigliamo le seguenti mappature degli attributi:
google.subject=assertion.oid, google.groups=assertion.groups, google.display_name=assertion.preferred_usernameQuesto esempio mappa gli attributi IdP
assertion.oid,assertion.groupseassertion.preferred_usernameagli attributi Google Cloudgoogle.subject,google.groupsegoogle.display_name, rispettivamente.
- Per aumentare il numero di gruppi, procedi nel seguente modo:
- Fai clic su Attiva per gli attributi aggiuntivi.
- Nell'attività secondaria che si apre, inserisci i dettagli:
- Nel campo URI emittente attributi aggiuntivi, inserisci l'URL dell'emittente.
- Nel campo ID client attributi aggiuntivi, inserisci l'ID client.
- Nel campo Client secret attributi aggiuntivi, inserisci il client secret.
- Nell'elenco Tipo di attributi aggiuntivi, seleziona un tipo di attributo per gli attributi aggiuntivi.
- Nel campo Filtro attributi aggiuntivi, inserisci un'espressione di filtro da utilizzare quando esegui una query sull'API Microsoft Graph per i gruppi.
- Fai clic su Attiva.
Dopo aver attivato gli attributi aggiuntivi, puoi fare clic su Modifica per riaprire l'attività secondaria e modificare i dettagli oppure su Disattiva per disattivare gli attributi aggiuntivi.
- Per aggiungere una condizione di attributo, segui questi passaggi:
- Fai clic su Aggiungi condizione.
- Nel campo Condizioni degli attributi, inserisci una condizione in formato CEL; ad esempio, per limitare l'attributo
ipaddra un determinato intervallo IP, puoi impostare la condizioneassertion.ipaddr.startsWith('98.11.12.').
- Per aggiungere o modificare le mappature degli attributi:
- Per convalidare le mappature, fai clic su Salva e recupera di nuovo il token.
- Per completare la configurazione, fai clic su Salva ed esci.
Crea un provider di pool di identità della forza lavoro SAML 2.0
Nel tuo IdP SAML, registra una nuova applicazione per la federazione delle identità per la forza lavoro Google Cloud.
Imposta il pubblico per le asserzioni SAML. Di solito è il campo
SP Entity IDnella configurazione dell'IdP. Devi impostarlo sul seguente URL:https://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_IDImposta l'URL di reindirizzamento, noto anche come URL ACS (Assertion Consumer Service). Per impostare l'URL di reindirizzamento, individua il campo dell'URL di reindirizzamento nell'IdP SAML ed esegui una delle seguenti operazioni:
Per configurare l'accesso basato su browser tramite la console Google Cloud o un altro metodo di accesso basato su browser, inserisci il seguente URL:
https://auth.cloud.google/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_IDSostituisci quanto segue:
WORKFORCE_POOL_ID: l'ID del pool di identità della forza lavoroWORKFORCE_PROVIDER_ID: l'ID del provider del pool di identità della forza lavoro che crei più avanti in questo documento.
Per configurare l'accesso programmatico tramite il tuo IdP, inserisci il seguente URL:
localhost
Per ulteriori dettagli sulla configurazione dell'accesso alla console, consulta Configura l'accesso degli utenti alla console.
In Google Cloud, crea un provider di pool di identità della forza lavoro SAML utilizzando il documento dei metadati SAML del tuo IdP. Puoi scaricare il documento XML dei metadati SAML dal tuo IdP. Il documento deve includere almeno quanto segue:
- Un ID entità SAML per il tuo IdP.
- L'URL Single Sign-On per l'IdP.
- Almeno una chiave pubblica di firma. Per informazioni dettagliate sulle chiavi di firma, consulta la sezione Requisiti chiave più avanti in questa guida.
gcloud
Per salvare i metadati SAML per l'applicazione Microsoft Entra ID e creare il provider, segui questi passaggi:
- Vai alla tua applicazione Microsoft Entra ID.
- Fai clic su Single sign-on.
- Nella sezione Certificati SAML, scarica il file XML dei metadati di federazione.
- Salva i metadati come file XML locale.
Per creare il provider del pool di identità della forza lavoro SAML, esegui il seguente comando:
gcloud iam workforce-pools providers create-saml WORKFORCE_PROVIDER_ID \
--workforce-pool="WORKFORCE_POOL_ID" \
--display-name="DISPLAY_NAME" \
--description="DESCRIPTION" \
--idp-metadata-path="XML_METADATA_PATH" \
--attribute-mapping="ATTRIBUTE_MAPPING" \
--attribute-condition="ATTRIBUTE_CONDITION" \
--vendor-type="entra-id" \
--detailed-audit-logging \
--location=global
Sostituisci quanto segue:
WORKFORCE_PROVIDER_ID: un ID provider.WORKFORCE_POOL_ID: l'ID del pool di identità della forza lavoro.DISPLAY_NAME: un nome visualizzato.DESCRIPTION: una descrizione.XML_METADATA_PATH: il percorso del file di metadati in formato XML con i metadati di configurazione per il provider di identità SAML.ATTRIBUTE_MAPPING: la mappatura degli attributi, ad esempio:google.subject=assertion.attributes['http://schemas.microsoft.com/identity/claims/objectidentifier'], attribute.costcenter=assertion.attributes.costcenter[0]Questo esempio mappa l'attributo IdP
assertion.attributes['http://schemas.microsoft.com/identity/claims/objectidentifier']sugoogle.subjecte l'attributo IdPassertion.attributes.costcenter[0]suattribute.costcenter.Per saperne di più, consulta Mappatura degli attributi.
ATTRIBUTE_CONDITION: una condizione dell'attributo facoltativa. Ad esempio, per limitare l'attributoipaddra un determinato intervallo IP, puoi impostare la condizioneassertion.attributes.ipaddr.startsWith('98.11.12.'). Questa condizione di esempio garantisce che solo gli utenti con un indirizzo IP che inizia con98.11.12.possano accedere utilizzando questo provider della forza lavoro.
-
L'audit logging dettagliato della federazione delle identità per la forza lavoro registra le informazioni ricevute dall'IdP in Logging. L'audit logging dettagliato può aiutarti a risolvere i problemi di configurazione del provider del pool di identità per la forza lavoro. Per scoprire come risolvere gli errori di mappatura degli attributi con l'audit logging dettagliato, consulta Errori generali di mappatura degli attributi. Per scoprire di più sui prezzi di Logging, consulta Prezzi di Google Cloud Observability.
Per disattivare l'audit logging dettagliato per un provider di pool di identità per la forza lavoro, ometti il flag
--detailed-audit-loggingquando eseguigcloud iam workforce-pools providers create. Per disattivare l'audit logging dettagliato, puoi anche aggiornare il provider.
(Facoltativo) Accetta le asserzioni SAML criptate dal tuo IdP
Per consentire al tuo IdP SAML 2.0 di produrre asserzioni SAML criptate che possono essere accettate dalla federazione delle identità per la forza lavoro, segui questi passaggi:
- Nella federazione delle identità per la forza lavoro, segui questi passaggi:
- Crea una coppia di chiavi asimmetriche per il provider del pool di identità della forza lavoro.
- Scarica un file di certificato che contiene la chiave pubblica.
- Configura l'IdP SAML in modo che utilizzi la chiave pubblica per criptare le asserzioni SAML che emette.
- Nel tuo IdP, segui questi passaggi:
- Attiva la crittografia delle asserzioni, nota anche come crittografia dei token.
- Carica la chiave pubblica che hai creato nella federazione delle identità per la forza lavoro.
- Verifica che l'IdP produca asserzioni SAML criptate.
Crea chiavi di crittografia delle asserzioni SAML per la federazione delle identità per la forza lavoro
Questa sezione illustra come creare una coppia di chiavi asimmetriche che consente alla federazione delle identità per la forza lavoro di accettare asserzioni SAML criptate.
Google Cloud utilizza la chiave privata per decriptare le asserzioni SAML emesse dal tuo IdP. Per creare una coppia di chiavi asimmetriche da utilizzare con la crittografia SAML, esegui il comando seguente. Per saperne di più, consulta Algoritmi di crittografia SAML supportati.
gcloud iam workforce-pools providers keys create KEY_ID \ --workforce-pool WORKFORCE_POOL_ID \ --provider WORKFORCE_PROVIDER_ID \ --location global \ --use encryption \ --spec KEY_SPECIFICATION
Sostituisci quanto segue:
KEY_ID: un nome della chiave a tua sceltaWORKFORCE_POOL_ID: l'ID del poolWORKFORCE_PROVIDER_ID: l'ID provider del pool di identità della forza lavoro-
KEY_SPECIFICATION: la specifica della chiave, che può esserersa-2048,rsa-3072ersa-4096.
Dopo aver creato la coppia di chiavi, per scaricare la chiave pubblica in un file di certificato, esegui questo comando. Solo la federazione delle identità per la forza lavoro ha accesso alla chiave privata.
gcloud iam workforce-pools providers keys describe KEY_ID \ --workforce-pool WORKFORCE_POOL_ID \ --provider WORKFORCE_PROVIDER_ID \ --location global \ --format "value(keyData.key)" \ > CERTIFICATE_PATH
Sostituisci quanto segue:
KEY_ID: il nome della chiaveWORKFORCE_POOL_ID: l'ID del poolWORKFORCE_PROVIDER_ID: l'ID provider del pool di identità della forza lavoroCERTIFICATE_PATH: il percorso in cui scrivere il certificato, ad esempiosaml-certificate.cerosaml-certificate.pem
Configura l'IdP conforme a SAML 2.0 per emettere asserzioni SAML criptate
Per configurare Microsoft Entra ID in modo da criptare i token SAML, consulta <a href="https://learn.microsoft.com/en-us/azure/active-directory/manage-apps/howto-saml-token-encryption?tabs=azure-portal"
Configura la crittografia dei token SAML di Azure Active Directory.
Dopo aver configurato l'IdP per criptare le asserzioni SAML, ti consigliamo di verificare che le asserzioni generate siano effettivamente criptate. Anche se la crittografia delle asserzioni SAML è configurata, la federazione delle identità per la forza lavoro può comunque elaborare le asserzioni in testo non crittografato.
Elimina le chiavi di crittografia della federazione delle identità per la forza lavoro
Per eliminare le chiavi di crittografia SAML, esegui questo comando: gcloud iam workforce-pools providers keys delete KEY_ID \ --workforce-pool WORKFORCE_POOL_ID \ --provider WORKFORCE_PROVIDER_ID \ --location globalSostituisci quanto segue:
KEY_ID: il nome della chiaveWORKFORCE_POOL_ID: l'ID del poolWORKFORCE_PROVIDER_ID: l'ID provider del pool di identità della forza lavoro
Algoritmi crittografici SAML supportati
La federazione delle identità per la forza lavoro supporta i seguenti algoritmi di trasporto delle chiavi:
- http://www.w3.org/2001/04/xmlenc#rsa-oaep-mgf1p
- http://www.w3.org/2009/xmlenc11#rsa-oaep"
- http://www.w3.org/2001/04/xmlenc#rsa-1_5"
La federazione delle identità per la forza lavoro supporta i seguenti algoritmi crittografici a blocchi:
Console
Per configurare il provider SAML utilizzando la console Google Cloud , segui questi passaggi:
- Nella console Google Cloud , vai alla pagina Pool di identità per la forza lavoro:
- Nella tabella Pool di identità per la forza lavoro, seleziona il pool per cui vuoi creare il provider.
- Nella sezione Provider, fai clic su Aggiungi provider.
- Nell'elenco Seleziona un provider, seleziona il tuo IdP.
Se il tuo IdP non è presente nell'elenco, seleziona Provider di identità generico.
- In Seleziona un protocollo di autenticazione, seleziona SAML.
- Nella sezione Crea un provider, segui questi passaggi:
- In Nome, inserisci un nome per il provider.
- (Facoltativo) In Descrizione, inserisci una descrizione del provider.
- In IDP metadata file (XML) (File di metadati IDP (XML)), seleziona il file XML dei metadati che hai generato in precedenza in questa guida.
- Per creare un provider abilitato, assicurati che l'opzione Abilita provider sia attiva.
- Fai clic su Continua.
- Nella sezione Condividi le informazioni del provider, copia gli URL. Nel tuo IdP, configura il primo URL come ID entità, che identifica la tua applicazione per l'IdP. Configura l'altro URL come URI di reindirizzamento, che indica all'IdP dove inviare il token di asserzione dopo l'accesso.
- Fai clic su Continua.
- Nella sezione Configura provider, in Logging dettagliato,
fai clic sul pulsante di attivazione/disattivazione Abilita l'audit logging dei valori degli attributi.
L'audit logging dettagliato della federazione delle identità per la forza lavoro registra le informazioni ricevute dall'IdP in Logging. L'audit logging dettagliato può aiutarti a risolvere i problemi di configurazione del provider del pool di identità per la forza lavoro. Per scoprire come risolvere gli errori di mappatura degli attributi con l'audit logging dettagliato, consulta Errori generali di mappatura degli attributi. Per scoprire di più sui prezzi di Logging, consulta Prezzi di Google Cloud Observability.
Per disattivare l'audit logging dettagliato per un provider di pool di identità per la forza lavoro, lascia disattivato il pulsante di attivazione/disattivazione Abilita l'audit logging dei valori degli attributi quando crei il provider. Per disattivare l'audit logging dettagliato, puoi anche aggiornare il provider.
- Per creare il provider, fai clic su Invia.
Dopo aver creato il provider, viene visualizzata la pagina degli attributi del provider.
Per configurare le mappature e le condizioni degli attributi, segui questi passaggi:
- Quando richiesto, accedi all'IdP esterno per convalidare le mappature degli attributi predefinite.
- Nella pagina degli attributi del provider, visualizza e modifica le mappature e le condizioni degli attributi:
- Per aggiungere o modificare le mappature degli attributi:
- Fai clic su Aggiungi mappatura per aggiungere una nuova mappatura o modificare quelle esistenti.
- Nel campo Google n, dove n è un numero, seleziona una chiave supportata da Google Cloud .
- Nel campo SAML n corrispondente, inserisci il nome dell'attributo IdP o un'espressione CEL, ad esempio:
google.subject=assertion.attributes['http://schemas.microsoft.com/identity/claims/objectidentifier'], attribute.costcenter=assertion.attributes.costcenter[0]Questo esempio mappa l'attributo IdP
assertion.attributes['http://schemas.microsoft.com/identity/claims/objectidentifier']sugoogle.subjecte l'attributo IdPassertion.attributes.costcenter[0]suattribute.costcenter.
- Per aumentare il numero di gruppi, procedi nel seguente modo:
- Fai clic su Attiva per gli attributi aggiuntivi.
- Nell'attività secondaria che si apre, inserisci i dettagli:
- Nel campo URI emittente attributi aggiuntivi, inserisci l'URL dell'emittente.
- Nel campo ID client attributi aggiuntivi, inserisci l'ID client.
- Nel campo Client secret attributi aggiuntivi, inserisci il client secret.
- Nell'elenco Tipo di attributi aggiuntivi, seleziona un tipo di attributo per gli attributi aggiuntivi.
- Nel campo Filtro attributi aggiuntivi, inserisci un'espressione di filtro da utilizzare quando esegui una query sull'API Microsoft Graph per i gruppi.
- Fai clic su Attiva.
Dopo aver attivato gli attributi aggiuntivi, puoi fare clic su Modifica per riaprire l'attività secondaria e modificare i dettagli oppure su Disattiva per disattivare gli attributi aggiuntivi.
- Per aggiungere una condizione dell'attributo, segui questi passaggi:
- Fai clic su Aggiungi condizione.
- Nel campo Condizioni degli attributi, inserisci una condizione in formato CEL, ad esempio:
Ad esempio, per limitare l'attributo
ipaddra un determinato intervallo IP, puoi impostare la condizioneassertion.attributes.ipaddr.startsWith('98.11.12.'). Questa condizione di esempio garantisce che solo gli utenti con un indirizzo IP che inizia con98.11.12.possano accedere utilizzando questo provider di forza lavoro.
- Per aggiungere o modificare le mappature degli attributi:
- Per convalidare le mappature, fai clic su Salva e recupera di nuovo il token.
- Per completare la configurazione, fai clic su Salva ed esci.
Verifica la configurazione del provider
Prima di testare il flusso di accesso dell'utente finale, puoi verificare che la configurazione del provider sia corretta e che Google Cloud possa scambiare token con il tuo IdP.
La pagina Convalida gli attributi del provider nella console Google Cloud include un visualizzatore di attributi che ti consente di testare in modo interattivo la configurazione ed eseguire il debug delle espressioni Common Expression Language (CEL). Puoi utilizzare il visualizzatore degli attributi per:
- Visualizza gli attributi non elaborati inviati nell'asserzione IdP.
- Verifica che le mappature e le condizioni degli attributi trasformino correttamente questi attributi.
- Eseguire il debug di espressioni CEL complesse in tempo reale.
Per verificare la configurazione del provider:
- Per attivare il flusso di accesso basato su browser per la federazione delle identità per la forza lavoro, aggiungi
https://auth.cloud.google/signin-callback/locations/global/workforcePools/POOL_ID/providers/PROVIDER_IDall'elenco degli URI di reindirizzamento consentiti del tuo IdP. -
Nella console Google Cloud , vai a Pool di identità per la forza lavoro.
Vai a Pool di identità per la forza lavoro - Nell'elenco dei pool, fai clic sul nome del pool che vuoi verificare.
- Nella pagina Dettagli del pool di forza lavoro, fai clic sul nome dell'IdP che vuoi verificare.
- Nella pagina Dettagli provider, fai clic su Esegui il debug del token IdP.
- Nella finestra di dialogo Accedi, accedi al tuo IdP come utente di test.
La pagina Convalida gli attributi del provider mostra gli attributi mappati e il risultato della condizione dell'attributo.
La sezione Attributi mappati dal token IdP mostra come gli attributi Google, ad esempio google.subject, vengono compilati dal token dell'IdP in base alla configurazione della mappatura. Se una mappatura non è corretta, viene visualizzata un'icona di errore.
La sezione Condizione attributo mostra il risultato booleano della tua condizione. Se la condizione restituisce false, l'accesso viene bloccato.
Per visualizzare il token di asserzione completo, fai clic su Visualizza token completo. Viene visualizzato l'oggetto JSON non elaborato del tuo IdP. Fai riferimento a una proprietà di primo livello nelle mappature utilizzando il formato assertion.PROPERTY_NAME.
Modifica la configurazione del provider
Per correggere eventuali errori, puoi modificare la configurazione:
- Nella pagina Convalida gli attributi del provider, fai clic su Modifica.
- Apporta le necessarie modifiche.
- Per avviare un nuovo test e visualizzare i risultati aggiornati, fai clic su Salva e recupera di nuovo il token.
Gestisci l'accesso alle risorse Google Cloud
Questa sezione fornisce un esempio che mostra come gestire l'accesso alle risorseGoogle Cloud da parte degli utenti della federazione delle identità per la forza lavoro.
In questo esempio, concedi un ruolo Identity and Access Management (IAM) su un progetto di esempio. Gli utenti possono quindi accedere e utilizzare questo progetto per accedere ai prodotti Google Cloud .
Puoi gestire i ruoli IAM per singole identità, un gruppo di identità o un intero pool. Per ulteriori informazioni, consulta Identificatori delle entità per la forza lavoro per le policy di autorizzazione.
Utilizzo dei gruppi mappati
Per concedere il ruolo Storage Admin (roles/storage.admin) a tutte le identità all'interno del gruppo GROUP_ID per il progetto TEST_PROJECT_ID, esegui questo comando:
gcloud projects add-iam-policy-binding TEST_PROJECT_ID \
--role="roles/storage.admin" \
--member="principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/group/GROUP_ID"
Sostituisci quanto segue:
TEST_PROJECT_ID: l'ID progetto di testWORKFORCE_POOL_ID: l'ID del pool di identità della forza lavoroGROUP_ID: un gruppo nell'attestazionegoogle.groupsmappata.
Per singola identità
Per concedere il ruolo Storage Admin (roles/storage.admin) a una singola identità per il progetto TEST_PROJECT_ID, esegui questo comando:
gcloud projects add-iam-policy-binding TEST_PROJECT_ID \
--role="roles/storage.admin" \
--member="principal://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/subject/SUBJECT_VALUE"
Sostituisci quanto segue:
TEST_PROJECT_ID: l'ID progetto di testWORKFORCE_POOL_ID: l'ID del pool di identità della forza lavoroSUBJECT_VALUE: l'identità utente
Utilizzo dell'attributo del reparto mappato
Per concedere il ruolo Storage Admin (roles/storage.admin) a tutte le identità
all'interno di un reparto specifico per il progetto
TEST_PROJECT_ID, esegui questo comando:
gcloud projects add-iam-policy-binding TEST_PROJECT_ID \
--role="roles/storage.admin" \
--member="principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/attribute.department/DEPARTMENT_VALUE"
Sostituisci quanto segue:
TEST_PROJECT_ID: l'ID progetto di testWORKFORCE_POOL_ID: l'ID del pool di identità della forza lavoroDEPARTMENT_VALUE: il valoreattribute.departmentmappato
Accedi e testa l'accesso
In questa sezione, accedi come utente del pool di identità della forza lavoro e verifichi di avere accesso alle risorse Google Cloud .
Accedi
Questa sezione mostra come accedere come utente federato e accedere alle risorseGoogle Cloud .
Accesso alla console (federato)
Per accedere alla console della federazione delle identità per la forza lavoro Google Cloud , nota anche come console (federata), segui questi passaggi:
-
Vai alla pagina di accesso alla console (federata).
-
Inserisci il nome del provider, formattato come segue:
locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID
Se richiesto, inserisci le credenziali utente in Microsoft Entra ID.
Se avvii un accesso avviato da IdP, utilizza il seguente URL di inoltro: https://console.cloud.google/.
Accesso basato su browser a gcloud CLI
Per accedere a gcloud CLI utilizzando un flusso di accesso basato su browser, segui questi passaggi:
Crea un file di configurazione
Esegui questo comando per creare un file di configurazione di accesso:
Linux e macOS
gcloud iam workforce-pools create-login-config \ locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID \ --output-file=LOGIN_CONFIG_PATH
Windows (PowerShell)
gcloud iam workforce-pools create-login-config ` locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID ` --output-file=LOGIN_CONFIG_PATH
Sostituisci quanto segue:
WORKFORCE_POOL_ID: l'ID del pool di federazione delle identità per la forza lavoro.WORKFORCE_PROVIDER_ID: l'ID provider della federazione delle identità per la forza lavoro.-
LOGIN_CONFIG_PATH: il percorso in cui scrivere il file di configurazione di accesso. Ad esempio,login-config.json.
Il file di configurazione di accesso contiene gli endpoint utilizzati da gcloud CLI per abilitare il flusso di autenticazione basato su browser e impostare il pubblico sull'IdP configurato nel provider del pool di identità per la forza lavoro. Il file non contiene informazioni riservate.
I contenuti del file di configurazione di accesso sono simili ai seguenti:
{ "universe_domain": "googleapis.com", "universe_cloud_web_domain": "cloud.google", "type": "external_account_authorized_user_login_config", "audience": "//iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID", "auth_url": "https://auth.cloud.google/authorize", "token_url": "https://sts.googleapis.com/v1/oauthtoken", "token_info_url": "https://sts.googleapis.com/v1/introspect" }
Accedi utilizzando l'autenticazione basata su browser
Indica il file di configurazione di accesso con una variabile di ambiente, una proprietà nella configurazione gcloud CLI attiva o utilizzalo direttamente con il comando gcloud auth login:
Variabile di ambiente
Per utilizzare il file di configurazione di accesso con una variabile di ambiente, completa le seguenti istruzioni:
-
Imposta la variabile di ambiente
CLOUDSDK_AUTH_LOGIN_CONFIG_FILEsul percorso del file di configurazione di accesso. -
Esegui questo comando:
gcloud auth login
- gcloud CLI fa riferimento alla variabile di ambiente per trovare il file di configurazione di accesso, quindi avvia il processo di autenticazione. Segui il flusso basato su browser per autenticare e autorizzare gcloud CLI ad accedere alle risorse per tuo conto per i comandi futuri.
Per interrompere l'utilizzo del file di configurazione di accesso per i comandi gcloud auth login, cancella la variabile di ambiente CLOUDSDK_AUTH_LOGIN_CONFIG_FILE.
Configurazione di gcloud CLI
Per utilizzare il file di configurazione di accesso con una proprietà di configurazione di gcloud CLI, completa le seguenti istruzioni:
-
Imposta la proprietà
auth/login_config_filedella configurazione gcloud CLI attiva sul percorso del file di configurazione di accesso con il seguente comando:gcloud config set auth/login_config_file LOGIN_CONFIG_PATH
-
Esegui questo comando:
gcloud auth login
- gcloud CLI fa riferimento alla proprietà di configurazione per trovare il file di configurazione di accesso, quindi avvia il processo di autenticazione. Segui il flusso basato su browser per autenticare e autorizzare gcloud CLI ad accedere alle risorse per tuo conto per i comandi futuri.
Per interrompere l'utilizzo del file di configurazione di accesso per i comandi gcloud auth login, annulla l'impostazione della proprietà con il seguente comando:
gcloud config unset auth/login_config_file
gcloud auth login
Per utilizzare il file di configurazione di accesso direttamente con il comando gcloud auth login, completa le seguenti istruzioni:
-
Se hai utilizzato il flag
--activatedurante la creazione del file di configurazione di accesso, esegui questo comando:gcloud auth login
-
Se non hai utilizzato il flag
--activatedurante la creazione del file di configurazione di accesso, esegui questo comando:Linux e macOS
gcloud auth login \ --login-config=LOGIN_CONFIG_PATH
Windows (PowerShell)
gcloud auth login ` --login-config=LOGIN_CONFIG_PATH
Sostituisci LOGIN_CONFIG_PATH con il percorso del file di configurazione di accesso.
Il comando gcloud auth login memorizza le credenziali di accesso nella tua home directory. L'entità autenticata diventa l'entità attiva nella configurazione dell'interfaccia alla gcloud CLI attiva. A meno che non venga eseguito l'override, gcloud CLI utilizza queste credenziali archiviate per accedere a Google Cloud.
Accesso headless a gcloud CLI
Per accedere a Microsoft Entra ID con gcloud CLI, segui questi passaggi:
OIDC
Segui i passaggi descritti in Inviare la richiesta di accesso. Consenti all'utente di accedere alla tua applicazione con Microsoft Entra ID utilizzando OIDC.
Copia il token ID dal parametro
id_tokendell'URL di reindirizzamento e salvalo in un file in una posizione sicura sulla tua macchina locale. In un passaggio successivo, imposterai PATH_TO_OIDC_ID_TOKEN sul percorso di questo file.Genera un file di configurazione simile all'esempio riportato più avanti in questo passaggio eseguendo il seguente comando:
gcloud iam workforce-pools create-cred-config \ locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID \ --subject-token-type=urn:ietf:params:oauth:token-type:id_token \ --credential-source-file=PATH_TO_OIDC_ID_TOKEN \ --workforce-pool-user-project=WORKFORCE_POOL_USER_PROJECT \ --output-file=config.jsonSostituisci quanto segue:
WORKFORCE_POOL_ID: l'ID del pool di identità della forza lavoro.WORKFORCE_PROVIDER_ID: l'ID provider del pool di identità della forza lavoro.PATH_TO_OIDC_ID_TOKEN: il percorso della posizione del file in cui è archiviato il token IdP.WORKFORCE_POOL_USER_PROJECT: il numero o l'ID progetto utilizzato per la quota e la fatturazione. L'entità deve disporre dell'autorizzazioneserviceusage.services.useper questo progetto.
Al termine del comando, Microsoft Entra ID crea il seguente file di configurazione:
{ "type": "external_account", "audience": "//iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID", "subject_token_type": "urn:ietf:params:oauth:token-type:id_token", "token_url": "https://sts.googleapis.com/v1/token", "workforce_pool_user_project": "WORKFORCE_POOL_USER_PROJECT", "credential_source": { "file": "PATH_TO_OIDC_CREDENTIALS" } }Apri gcloud CLI ed esegui il comando seguente:
gcloud auth login --cred-file=PATH_TO_OIDC_CREDENTIALSSostituisci PATH_TO_OIDC_CREDENTIALS con il percorso del file di output di un passaggio precedente.
gcloud CLI pubblica in modo trasparente le tue credenziali nell'endpoint di Security Token Service. Nell'endpoint, viene scambiato con token di accesso Google Cloud temporanei.
Ora puoi eseguire i comandi gcloud CLI perGoogle Cloud.
SAML
Fai accedere un utente alla tua applicazione Microsoft Entra ID e ottieni la risposta SAML.
Salva la risposta SAML restituita da Microsoft Entra ID in una posizione sicura sulla tua macchina locale, quindi memorizza il percorso come segue:
SAML_ASSERTION_PATH=SAML_ASSERTION_PATHPer generare un file di configurazione delle credenziali, esegui questo comando:
gcloud iam workforce-pools create-cred-config \ locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID \ --subject-token-type=urn:ietf:params:oauth:token-type:saml2 \ --credential-source-file=SAML_ASSERTION_PATH \ --workforce-pool-user-project=PROJECT_ID \ --output-file=config.jsonSostituisci quanto segue:
WORKFORCE_PROVIDER_ID: l'ID del provider del pool di identità della forza lavoro che hai creato in precedenza in questa guidaWORKFORCE_POOL_ID: l'ID del pool di identità della forza lavoro che hai creato in precedenza in questa guidaSAML_ASSERTION_PATH: il percorso del file di asserzione SAMLPROJECT_ID: l'ID progetto
Il file di configurazione generato è simile al seguente:
{ "type": "external_account", "audience": "//iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID", "subject_token_type": "urn:ietf:params:oauth:token-type:saml2", "token_url": "https://sts.googleapis.com/v1/token", "credential_source": { "file": "SAML_ASSERTION_PATH" }, "workforce_pool_user_project": "PROJECT_ID" }Per accedere a gcloud CLI utilizzando lo scambio di token della federazione delle identità per la forza lavoro, esegui questo comando:
gcloud auth login --cred-file=config.jsongcloud CLI scambia quindi in modo trasparente le tue credenziali Microsoft Entra ID con token di accesso Google Cloud temporanei. I token di accesso ti consentono di accedere a Google Cloud.
Viene visualizzato un output simile al seguente:
Authenticated with external account user credentials for: [principal://iam.googleapis.com/locations/global/workforcePools/
WORKFORCE_POOL_ID/subject/USER_ID].Per elencare gli account con credenziali e il tuo account attivo, esegui questo comando:
gcloud auth list
Controlla l'accesso
Ora hai accesso ai prodotti Google Cloud che supportano la federazione delle identità per la forza lavoro e per i quali ti è stato concesso l'accesso. In precedenza in questo documento, hai concesso il ruolo Storage Admin (roles/storage.admin) a tutte le identità all'interno dell'identificatore del gruppo specificato in gcloud projects add-iam-policy-binding per il progetto TEST_PROJECT_ID.
Ora puoi verificare di avere l'accesso elencando i bucket Cloud Storage.
Console (federata)
Per verificare di avere accesso utilizzando la console (federata), segui questi passaggi:
Vai alla pagina Cloud Storage.
Verifica di poter visualizzare un elenco di bucket esistenti per
TEST_PROJECT_ID.
gcloud CLI
Per verificare di avere accesso utilizzando gcloud CLI, puoi elencare i bucket Cloud Storage e gli oggetti per il progetto a cui hai accesso. Per farlo, esegui questo comando. L'entità deve disporre dell'autorizzazione serviceusage.services.use per il progetto specificato.
gcloud storage ls --project="TEST_PROJECT_ID"
Eliminare utenti
La federazione delle identità per la forza lavoro crea metadati e risorse utente per le identità utente federate. Se scegli di eliminare gli utenti nel tuo IdP, devi anche eliminare esplicitamente queste risorse in Google Cloud. Per farlo, consulta Elimina gli utenti della federazione delle identità per la forza lavoro e i relativi dati.
Per terminare immediatamente le sessioni attive di un utente, puoi revocarle. Per ulteriori informazioni, consulta Revoca le sessioni utente della federazione delle identità per la forza lavoro.Potresti notare che le risorse continuano a essere associate a un utente eliminato. Questo perché l'eliminazione dei metadati e delle risorse utente richiede un'operazione a lunga esecuzione. Dopo aver avviato l'eliminazione dell'identità di un utente, i processi avviati dall'utente prima dell'eliminazione possono continuare a essere eseguiti fino al loro completamento o annullamento.
Passaggi successivi
- Configura SCIM in Microsoft Entra ID
- Elimina gli utenti della federazione delle identità per la forza lavoro e i relativi dati
- Revoca le sessioni utente della federazione delle identità per la forza lavoro
- Scopri quali prodotti Google Cloud supportano la federazione delle identità per la forza lavoro
- Configura l'accesso degli utenti alla console (federato)