La federazione delle identità per la forza lavoro ti consente di utilizzare un provider di identità (IdP) esterno per autenticare utenti e gruppi di utenti in un'istanza di Looker (Google Cloud core). Utilizzando la federazione delle identità per la forza lavoro, gli utenti della tua organizzazione possono utilizzare il Single Sign-On (SSO) per accedere a Looker (Google Cloud core) senza che tu debba eseguire il provisioning o la sincronizzazione degli Account Google (account Cloud Identity o Google Workspace) per ogni utente.
La federazione delle identità per la forza lavoro supporta IdP esterni che utilizzano OpenID Connect (OIDC) o SAML 2.0, come Microsoft Entra ID (precedentemente Azure Active Directory), Okta, Ping Identity e altri.
Looker (Google Cloud core) supporta la federazione delle identità per la forza lavoro su istanze che utilizzano connessioni sicure pubbliche, connessioni private o connessioni ibride.
Come funziona la federazione delle identità per la forza lavoro con Looker (Google Cloud core)
Quando configuri la federazione delle identità per la forza lavoro per un'istanza di Looker (Google Cloud core), si verifica il seguente processo:
- Autenticazione: un utente accede all'URL dell'istanza di Looker (Google Cloud core). Se l'impostazione Ignora la pagina di accesso è attiva, l'utente viene reindirizzato automaticamente al portale di accesso Google Cloud (
https://auth.cloud.google/authorize), che lo reindirizza all'IdP esterno per l'autenticazione. - Scambio di token: dopo che l'utente ha eseguito l'autenticazione con l'IdP, quest'ultimo restituisce un'asserzione di autenticazione a Google Cloud Security Token Service (STS). STS scambia l'asserzione con un token di accesso federato e un token ID.
- Autorizzazione: Looker (Google Cloud core) verifica che l'entità federata disponga dell'autorizzazione Identity and Access Management (IAM) richiesta (
looker.instances.login) sull'istanza. - Provisioning e assegnazione dei ruoli: Looker (Google Cloud core) crea l'account utente al primo accesso (provisioning Just-In-Time) e applica le mappature gruppo-ruolo e gli attributi utente in base alle attestazioni che riceve dal tuo IdP.
Prima di iniziare
Prima di configurare la federazione delle identità per la forza lavoro per Looker (Google Cloud core), assicurati di disporre dei seguenti ruoli e configurazioni:
Ruoli IAM richiesti
Per configurare la federazione delle identità per la forza lavoro e creare istanze di Looker (Google Cloud core), devi disporre dei seguenti ruoli:
- IAM Workforce Pool Admin (
roles/iam.workforcePoolAdmin): richiesto per l'organizzazione Google Cloud per creare e gestire pool e provider di forza lavoro. - Amministratore di Looker (
roles/looker.admin): richiesto nel progetto Google Cloudper creare e gestire le istanze di Looker (Google Cloud core). - Project IAM Admin (
roles/resourcemanager.projectIamAdmin): richiesto sul progetto Google Cloud per concedere i ruoli IAM alle entità della forza lavoro.
API obbligatorie
Abilita le seguenti API nel tuo progetto Google Cloud :
API Identity and Access Management (
iam.googleapis.com)API Security Token Service (
sts.googleapis.com)API Cloud Resource Manager (
cloudresourcemanager.googleapis.com)API Looker (Google Cloud core) (
looker.googleapis.com)
Passaggio 1: configura un pool di identità della forza lavoro e un provider
I pool e i provider di identità della forza lavoro vengono creati a livello di organizzazione Google Cloud, non di progetto.
Per configurare un pool di identità della forza lavoro e un provider, completa i seguenti passaggi:
- Crea un pool di identità per la forza lavoro seguendo le istruzioni riportate nella pagina della documentazione Configura la federazione delle identità per la forza lavoro.
- Crea un provider di pool di identità per la forza lavoro per il tuo IdP OIDC o SAML 2.0:
- Per i provider OIDC, consulta Configura la federazione delle identità per la forza lavoro OIDC.
- Per i provider SAML, consulta Configura la federazione delle identità per la forza lavoro SAML 2.0.
- Definisci le seguenti mappature degli attributi immediatamente durante la creazione del provider:
- Email: mappa l'attestazione email dell'IdP a
google.email. Questa mappatura è obbligatoria per l'identificazione dell'utente; l'autenticazione non andrà a buon fine se questa mappatura non è presente. - Nome e cognome: mappa le rivendicazioni relative a nome e cognome dell'IdP rispettivamente a
attribute.given_name(nome) eattribute.family_name(cognome). Queste mappature sono obbligatorie per compilare i profili utente di Looker. L'autenticazione non andrà a buon fine se queste mappature non sono presenti.
- Email: mappa l'attestazione email dell'IdP a
Se vuoi, configura anche le seguenti mappature degli attributi:
- Gruppi: mappa l'attestazione del gruppo del tuo IdP (ad esempio,
assertion.groups) agoogle.groups. Questa mappatura è obbligatoria se prevedi di attivare il mirroring dei gruppi e di mappare i gruppi IdP ai ruoli di Looker. Per i provider OIDC, assicurati che la configurazione del provider richieda anche l'ambitogroupsse l'IdP lo richiede (consulta Configura la federazione delle identità per la forza lavoro per i requisiti specifici dell'IdP). - Attributi personalizzati: mappa le rivendicazioni IdP personalizzate a
attribute.<attribute_name>. Puoi utilizzare questi attributi mappati in Looker (Google Cloud core) per parametrizzare le connessioni al database e applicare filtri di accesso ai dati a livello di riga.
- Gruppi: mappa l'attestazione del gruppo del tuo IdP (ad esempio,
Configura la durata della sessione estesa e la sincronizzazione in background
Per supportare sessioni del browser senza interruzioni, invii pianificati di lunga durata, accesso alle chiavi API utente e integrazioni dei connettori, completa i seguenti passaggi:
- Configura la sincronizzazione degli attributi in background sul provider del pool di forza lavoro in modo che Google Cloud possa aggiornare periodicamente gli attributi utente e le iscrizioni ai gruppi in background:
- Per i provider OIDC: configura il flusso del codice di autorizzazione OIDC con l'ambito
offline_access(che utilizza i token di aggiornamento per aggiornare periodicamente gli attributi utente e le iscrizioni ai gruppi) o il provisioning SCIM 2.0. Se gli utenti appartengono a un numero elevato di gruppi che superano i limiti di dimensione dei token OIDC, configura il provisioning SCIM 2.0 per sincronizzare le iscrizioni ai gruppi con Google Cloud. - Per i provider SAML: configura il provisioning SCIM 2.0 sul provider del pool di forza lavoro. Poiché le asserzioni SAML non forniscono token di aggiornamento in modo nativo, SCIM 2.0 è necessario per attivare le consegne pianificate e gli avvisi offline.
- Per i provider OIDC: configura il flusso del codice di autorizzazione OIDC con l'ambito
Configura una policy di durata della sessione estesa per il tuo pool di forza lavoro utilizzando i binding cloud di Gestore contesto accesso e imposta la policy su 90 giorni (7.776.000 secondi).
Questa policy imposta la durata massima della sessione e la validità del token di aggiornamento su 90 giorni. Se una policy sulla durata della sessione estesa non è configurata o è impostata su una durata inferiore, la validità del token di aggiornamento del pool di forza lavoro ha la precedenza sulle impostazioni per la durata della sessione di Looker, per cui le sessioni del browser, le pianificazioni offline, le chiavi API utente e le applicazioni connesse richiedono una nuova autenticazione alla scadenza del token di aggiornamento.
Passaggio 2: concedi le autorizzazioni IAM alle entità della forza lavoro
Per consentire agli utenti della forza lavoro di accedere all'istanza di Looker (Google Cloud core), concedi il ruolo IAM Utente istanza Looker (roles/looker.instanceUser) o Amministratore Looker (roles/looker.admin) alle entità o ai gruppi della forza lavoro.
Puoi concedere ruoli a singoli utenti, interi gruppi o tutte le entità in un pool di forza lavoro utilizzando i seguenti identificatori di entità:
Singolo utente della forza lavoro:
principal://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/subject/SUBJECT_ID
Gruppo di forza lavoro:
principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/group/GROUP_ID
Tutte le entità in un pool di forza lavoro:
principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/*
Per saperne di più sull'assegnazione dei ruoli IAM, consulta la pagina della documentazione Controllo controllo dell'accesso di Looker (Google Cloud core) con IAM.
Passaggio 3: seleziona la federazione delle identità per la forza lavoro come metodo di autenticazione principale
Puoi selezionare la federazione delle identità per la forza lavoro come metodo di autenticazione principale durante la creazione di una nuova istanza di Looker (Google Cloud core) o modificando un'istanza esistente.
Durante la creazione dell'istanza
Quando crei una nuova istanza di Looker (Google Cloud core), puoi selezionare la federazione delle identità per la forza lavoro come metodo di autenticazione principale:
console
- Nella console Google Cloud, vai alla pagina Looker (Google Cloud core).
- Fai clic su CREA ISTANZA.
- Completa la configurazione del nome, della regione e della versione dell'istanza come descritto nella documentazione per la creazione di istanze che utilizzano connessioni sicure pubbliche, connessioni Private Service Connect o connessioni di accesso privato ai servizi.
- Nella sezione Autenticazione, seleziona Federazione delle identità per la forza lavoro (SAML/OIDC) come metodo di autenticazione principale.
- Fai clic su Crea.
Per impostare OAuth come metodo di autenticazione secondario, modifica la configurazione dell'istanza dopo averla creata.
gcloud
Utilizza il comando gcloud looker instances create con il flag --workforce-auth-enabled per creare un'istanza che utilizza la federazione delle identità per la forza lavoro come metodo di autenticazione principale:
gcloud looker instances create INSTANCE_NAME \ --project=PROJECT_ID \ --region=REGION \ --edition=EDITION \ --workforce-auth-enabled \ --async
Sostituisci quanto segue:
INSTANCE_NAME: un nome per l'istanza di Looker (Google Cloud core); non è associato all'URL dell'istanza.PROJECT_ID: l'ID del progetto Google Cloud in cui stai creando l'istanza di Looker (Google Cloud core).REGION: la regione in cui è ospitata l'istanza di Looker (Google Cloud core). Le regioni disponibili sono elencate nella pagina Località di Looker (Google Cloud core).EDITION: la versione dell'istanza. Per un elenco dei valori disponibili, consulta Crea un'istanza di Looker (Google Cloud core) con connessioni sicure pubbliche.
In Google Cloud CLI, l'autenticazione Google è abilitata per impostazione predefinita quando non specifichi alcun flag di autenticazione. Ogni volta che l'autenticazione Google è abilitata, gcloud looker instances create richiede --oauth-client-id e --oauth-client-secret. Se specifichi
--workforce-auth-enabled senza --google-auth-enabled, il comando
disattiva l'autenticazione Google nell'istanza e non è necessario
fornire le credenziali OAuth.
Per consentire anche OAuth come metodo di autenticazione secondario quando crei l'istanza, aggiungi i flag --google-auth-enabled, --oauth-client-id e --oauth-client-secret:
gcloud looker instances create INSTANCE_NAME \ --project=PROJECT_ID \ --region=REGION \ --edition=EDITION \ --workforce-auth-enabled \ --google-auth-enabled \ --oauth-client-id=OAUTH_CLIENT_ID \ --oauth-client-secret=OAUTH_CLIENT_SECRET \ --async
Sostituisci OAUTH_CLIENT_ID e OAUTH_CLIENT_SECRET con l'ID client e il client secret del tuo client OAuth.
Puoi aggiungere altri flag al comando per applicare altre impostazioni dell'istanza, come periodi di manutenzione e canali di rilascio, o per configurare il networking privato:
- Per le connessioni sicure pubbliche, consulta Crea un'istanza di Looker (Google Cloud core) con connessioni sicure pubbliche.
- Per Private Service Connect, consulta Crea un'istanza Private Service Connect.
- Per l'accesso privato ai servizi, consulta Crea un'istanza di connessioni private (accesso privato ai servizi).
Quando modifichi un'istanza esistente
Se hai un'istanza di Looker (Google Cloud core) esistente, puoi modificare la configurazione dell'istanza per selezionare la federazione delle identità per la forza lavoro come metodo di autenticazione principale o per impostare OAuth come metodo di autenticazione secondario:
console
- Nella console Google Cloud, vai alla pagina Looker (Google Cloud core).
- Fai clic sul nome dell'istanza che vuoi modificare.
- Nella scheda Dettagli dell'istanza, fai clic su Modifica.
- Nella sezione Autenticazione, seleziona Federazione delle identità per la forza lavoro (SAML/OIDC) come metodo di autenticazione principale.
- (Facoltativo) Per consentire OAuth come metodo di autenticazione secondario, attiva l'opzione Abilita OAuth secondario.
- Fai clic su Salva.
gcloud
Utilizza il comando gcloud looker instances update con il flag --workforce-auth-enabled per selezionare la federazione delle identità per la forza lavoro come metodo di autenticazione principale:
gcloud looker instances update INSTANCE_NAME \ --project=PROJECT_ID \ --region=REGION \ --workforce-auth-enabled \ --no-google-auth-enabled \ --async
Sostituisci quanto segue:
INSTANCE_NAME: il nome della tua istanza di Looker (Google Cloud core).PROJECT_ID: l'ID del progetto Google Cloud in cui si trova l'istanza di Looker (Google Cloud core).REGION: la regione in cui è ospitata l'istanza di Looker (Google Cloud core).
Il flag --no-google-auth-enabled disattiva l'autenticazione Google sull'istanza. Per mantenere OAuth come metodo di autenticazione secondario, sostituisci il flag --no-google-auth-enabled con il flag --google-auth-enabled. Se l'istanza non ha già un client OAuth, aggiungi anche i flag --oauth-client-id=OAUTH_CLIENT_ID e --oauth-client-secret=OAUTH_CLIENT_SECRET.
Passaggio 4: configura le impostazioni di Workforce Identity in Looker
Dopo aver creato l'istanza di Looker (Google Cloud core), un amministratore può configurare le mappature degli attributi utente, il mirroring dei gruppi e le opzioni di accesso nella pagina Autenticazione della forza lavoro del pannello di amministrazione di Looker.
- Accedi alla tua istanza di Looker (Google Cloud core) con un account con il ruolo Looker Admin.
- Nel menu di navigazione, seleziona Amministratore > Autenticazione > Workforce Identity.
- Configura le impostazioni descritte nelle sezioni seguenti.
Per saperne di più sulle seguenti impostazioni, consulta la documentazione della pagina Autenticazione della forza lavoro.
Unisci gli account utente
Nel campo Unisci utenti utilizzando, seleziona i sistemi di autenticazione da cui unire gli account utente esistenti quando un utente accede per la prima volta con la federazione delle identità per la forza lavoro.
I sistemi supportati per l'unione includono:
- SAML
- OIDC
Bypassa la pagina di accesso
L'opzione Ignora pagina di accesso controlla se gli utenti non autenticati vengono reindirizzati automaticamente al portale SSO aziendale:
- Attivato (impostazione predefinita): quando gli utenti accedono all'URL dell'istanza, vengono reindirizzati automaticamente alla schermata di accesso dell'IdP senza visualizzare la pagina di accesso di Looker.
- Disattivato: gli utenti visualizzano la pagina di accesso di Looker e possono scegliere tra le opzioni di autenticazione disponibili.
Fai clic su Salva configurazione per applicare le impostazioni.
Mappatura attributi utente
Mappa le rivendicazioni dall'asserzione IdP agli attributi utente di Looker. Gli attributi utente possono essere utilizzati per molti scopi, ad esempio per parametrizzare le connessioni al database e applicare filtri di sicurezza a livello di riga.
- Nella sezione Mappatura attributi, mappa gli attributi della forza lavoro di Google agli attributi utente di Looker corrispondenti (ad esempio, mappa
attribute.departmenta un attributo utentedepartmentin Looker).
Gruppi e ruoli
Puoi gestire i ruoli utente tramite il mirroring dei gruppi o l'assegnazione dei ruoli predefiniti:
- Esegui il mirroring dei gruppi dall'IdP: quando questa impostazione è attiva, Looker (Google Cloud core) crea gruppi di Looker che eseguono il mirroring dei gruppi passati nell'asserzione del token IdP.
- Nella tabella Mappatura dei gruppi, mappa i nomi dei gruppi IdP esterni ai gruppi Looker e assegna i ruoli Looker appropriati (ad esempio Visualizzatore, Utente o Sviluppatore).
- Ruolo predefinito per i nuovi utenti: se il mirroring dei gruppi non viene utilizzato o non corrisponde a un utente, specifica il ruolo predefinito da concedere ai nuovi utenti al primo accesso.
- Gruppo di nuovi utenti predefinito: se il mirroring dei gruppi non viene utilizzato o non corrisponde a un utente, specifica il gruppo predefinito da assegnare ai nuovi utenti.
Gestione delle sessioni e validità dei token
Le sessioni utente e i token in Looker (Google Cloud core) sono regolati dalla durata della sessione e dalla validità del token di aggiornamento configurate nella policy del pool di identità per la forza lavoro (ad esempio una policy per la durata della sessione estesa):
- Sessioni del browser: le impostazioni della durata della sessione di Looker supportano sessioni fino a 30 giorni se utilizzi sessioni persistenti. Tuttavia, la validità del token di aggiornamento del pool di identità per la forza lavoro ha la precedenza se è inferiore alla durata della sessione configurata in Looker. Alla scadenza del token di aggiornamento, l'utente deve eseguire di nuovo l'accesso. Ti consigliamo di impostare una validità del token di aggiornamento di 90 giorni nella policy per la durata della sessione estesa.
- Consegne e avvisi pianificati (job offline): i job in background vengono eseguiti finché il proprietario della pianificazione dispone di un token IdP attivo. Se l'autore di una pianificazione o di un avviso non accede all'istanza per più di 90 giorni (o per la durata configurata nella policy della sessione del pool di forza lavoro), la sua sessione offline scade e le pubblicazioni o gli avvisi pianificati di proprietà di quell'utente vengono messi in pausa. Per riprendere le pianificazioni o gli avvisi in pausa, il proprietario deve accedere all'istanza oppure un amministratore deve assegnare la proprietà della pianificazione.
- Server e connettori OAuth di Looker: le integrazioni che utilizzano il server OAuth di Looker (come Data Studio, Fogli connessi e connettori di terze parti) utilizzano un token di aggiornamento di 30 giorni (o un token di aggiornamento senza scadenza in Data Studio). Se la durata della sessione del pool di forza lavoro è impostata su un valore inferiore a 90 giorni, gli utenti potrebbero dover eseguire nuovamente l'autenticazione con Looker alla scadenza della sessione.
- Chiavi API utente: i token di accesso API generati dalle chiavi API utente sono validi per un'ora e richiedono una sessione IdP utente attiva. Se la sessione IdP dell'utente scade (ogni 90 giorni o in base alla durata della sessione del pool di forza lavoro), l'utente deve accedere di nuovo all'istanza per continuare a utilizzare le sue chiavi API.
- Chiavi API dei service account: i token di accesso API dei service account non sono interessati dalle policy di sessione dei pool di forza lavoro.
Passaggi successivi
- Gestisci gli utenti in Looker (Google Cloud core)
- Controllo controllo dell'accesso di Looker (Google Cloud core) con IAM
- Gestisci le policy di manutenzione per un'istanza di Looker (Google Cloud core)