La fédération des identités des employés vous permet d'utiliser un fournisseur d'identité (IdP) externe pour authentifier les utilisateurs et les groupes d'utilisateurs dans une instance Looker (Google Cloud core). En utilisant la fédération des identités des employés, les utilisateurs de votre organisation peuvent utiliser l'authentification unique (SSO) pour accéder à Looker (Google Cloud core) sans que vous ayez à provisionner ou à synchroniser des comptes Google (comptes Cloud Identity ou Google Workspace) pour chaque utilisateur.
La fédération des identités des employés est compatible avec les IdP externes qui utilisent OpenID Connect (OIDC) ou SAML 2.0, tels que Microsoft Entra ID (anciennement Azure Active Directory), Okta, Ping Identity et d'autres.
Looker (Google Cloud Core) est compatible avec la fédération des identités des employés sur les instances qui utilisent des connexions sécurisées publiques, des connexions privées ou des connexions hybrides.
Fonctionnement de la fédération des identités des employés avec Looker (Google Cloud Core)
Lorsque vous configurez la fédération des identités des employés pour une instance Looker (Google Cloud Core), le processus suivant se produit :
- Authentification : un utilisateur accède à l'URL de votre instance Looker (Google Cloud Core). Si le paramètre Ignorer la page de connexion est activé, l'utilisateur est automatiquement redirigé vers le portail de connexion Google Cloud (
https://auth.cloud.google/authorize), qui le redirige vers votre IdP externe pour l'authentification. - Échange de jetons : une fois que l'utilisateur s'est authentifié auprès de votre IdP, celui-ci renvoie une assertion d'authentification au Google Cloud service de jetons de sécurité (STS). STS échange l'assertion contre un jeton d'accès fédéré et un jeton d'ID.
- Autorisation : Looker (Google Cloud Core) vérifie que le compte principal fédéré dispose de l'autorisation Identity and Access Management (IAM) requise (
looker.instances.login) sur l'instance. - Provisionnement et attribution de rôles : Looker (Google Cloud Core) crée le compte utilisateur lors de la première connexion (provisionnement juste-à-temps) et applique les mappages de groupes à rôles et les attributs utilisateur en fonction des revendications qu'il reçoit de votre IdP.
Avant de commencer
Avant de configurer la fédération des identités des employés pour Looker (Google Cloud Core), assurez-vous de disposer des rôles et configurations suivants :
Rôles IAM requis
Pour configurer la fédération des identités des employés et créer des instances Looker (Google Cloud Core), vous devez disposer des rôles suivants :
- Administrateur IAM de pool d'employés (
roles/iam.workforcePoolAdmin) : requis sur l'organisation Google Cloud pour créer et gérer des pools d'employés et des fournisseurs. - Administrateur Looker (
roles/looker.admin) : requis sur le projet Google Cloudpour créer et gérer des instances Looker (Google Cloud Core). - Administrateur IAM de projet (
roles/resourcemanager.projectIamAdmin) : requis sur le projet Google Cloud pour attribuer des rôles IAM aux comptes principaux du personnel.
API requises
Activez les API suivantes dans votre projet 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)
Étape 1 : Configurez un pool d'identités de personnel et un fournisseur
Les pools d'identités de personnel et les fournisseurs sont créés au niveau de l'organisation Google Cloud, et non au niveau du projet.
Pour configurer un pool d'identités de personnel et un fournisseur, procédez comme suit :
- Créez un pool d'identités de personnel en suivant les instructions de la page de documentation Configurer la fédération des identités des employés.
- Créez un fournisseur de pools d'identités de personnel pour votre IdP OIDC ou SAML 2.0 :
- Pour les fournisseurs OIDC, consultez Configurer la fédération des identités des employés OIDC.
- Pour les fournisseurs SAML, consultez Configurer la fédération des identités des employés SAML 2.0.
- Définissez les mappages d'attributs suivants immédiatement lors de la création du fournisseur :
- E-mail : mappez la revendication d'adresse e-mail de votre IdP sur
google.email. Ce mappage est obligatoire pour l'identification des utilisateurs. L'authentification échouera s'il est manquant. - Prénom et nom : mappez les revendications de prénom et de nom de votre IdP sur
attribute.given_name(prénom) etattribute.family_name(nom). Ces mappages sont obligatoires pour renseigner les profils utilisateur Looker. L'authentification échouera si ces mappages sont manquants.
- E-mail : mappez la revendication d'adresse e-mail de votre IdP sur
Vous pouvez également configurer les mappages d'attributs suivants :
- Groupes : mappez la revendication de groupe de votre IdP (par exemple,
assertion.groups) àgoogle.groups. Ce mappage est requis si vous prévoyez d'activer la mise en miroir des groupes et de mapper les groupes IdP aux rôles Looker. Pour les fournisseurs OIDC, assurez-vous que votre configuration de fournisseur demande également le champ d'applicationgroupssi votre IdP l'exige (consultez Configurer la fédération des identités des employés pour connaître les exigences spécifiques à l'IdP). - Attributs personnalisés : mappez les revendications IdP personnalisées à
attribute.<attribute_name>. Vous pouvez utiliser ces attributs mappés dans Looker (Google Cloud Core) pour paramétrer les connexions à la base de données et appliquer des filtres d'accès aux données au niveau des lignes.
- Groupes : mappez la revendication de groupe de votre IdP (par exemple,
Configurer la durée de session prolongée et la synchronisation en arrière-plan
Pour permettre des sessions de navigateur ininterrompues, des livraisons planifiées de longue durée, l'accès aux clés API des utilisateurs et l'intégration de connecteurs, procédez comme suit :
- Configurez la synchronisation des attributs en arrière-plan sur votre fournisseur de pool d'employés afin que Google Cloud puisse actualiser régulièrement les attributs utilisateur et les appartenances aux groupes en arrière-plan :
- Pour les fournisseurs OIDC : configurez le flux de code d'autorisation OIDC avec le champ d'application
offline_access(qui utilise des jetons d'actualisation pour actualiser régulièrement les attributs utilisateur et les appartenances aux groupes) ou le provisionnement SCIM 2.0. Si les utilisateurs appartiennent à un grand nombre de groupes qui dépassent les limites de taille des jetons OIDC, configurez le provisionnement SCIM 2.0 pour synchroniser les appartenances aux groupes avec Google Cloud. - Pour les fournisseurs SAML : configurez le provisionnement SCIM 2.0 sur votre fournisseur de pool d'employés. Comme les assertions SAML ne fournissent pas de jetons d'actualisation de manière native, SCIM 2.0 est requis pour activer les envois planifiés et les alertes hors connexion.
- Pour les fournisseurs OIDC : configurez le flux de code d'autorisation OIDC avec le champ d'application
Configurez une règle de durée de session étendue pour votre pool d'employés à l'aide des liaisons cloud Access Context Manager, et définissez la règle sur 90 jours (7 776 000 secondes).
Cette règle définit la durée maximale de la session et la validité du jeton d'actualisation sur 90 jours. Si aucune règle de durée de session étendue n'est configurée ou si elle est définie sur une durée plus courte, la validité du jeton d'actualisation du pool d'employés prévaut sur les paramètres de durée de session de Looker. Par conséquent, les sessions de navigateur, les planifications hors connexion, les clés API utilisateur et les applications connectées nécessitent une nouvelle authentification à l'expiration du jeton d'actualisation.
Étape 2 : Accorder des autorisations IAM aux comptes principaux d'employés
Pour permettre aux utilisateurs du personnel de se connecter à votre instance Looker (Google Cloud Core), attribuez le rôle IAM d'utilisateur d'instance Looker (roles/looker.instanceUser) ou d'administrateur Looker (roles/looker.admin) à vos comptes principaux ou groupes du personnel.
Vous pouvez attribuer des rôles à des utilisateurs individuels, à des groupes entiers ou à tous les comptes principaux d'un pool de personnel à l'aide des identifiants principaux suivants :
Utilisateur unique de l'effectif :
principal://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/subject/SUBJECT_ID
Groupe d'employés :
principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/group/GROUP_ID
Tous les comptes principaux d'un pool d'employés :
principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/*
Pour en savoir plus sur l'attribution de rôles IAM, consultez la page de documentation Contrôle des accès avec IAM pour Looker (Google Cloud core).
Étape 3 : Sélectionnez la fédération des identités des employés comme méthode d'authentification principale
Vous pouvez sélectionner la fédération des identités des employés comme méthode d'authentification principale lorsque vous créez une instance Looker (Google Cloud Core) ou en modifiant une instance existante.
Lors de la création de l'instance
Lorsque vous créez une instance Looker (Google Cloud Core), vous pouvez sélectionner la fédération des identités des employés comme méthode d'authentification principale :
Console
- Dans la console Google Cloud, accédez à la page Looker (Google Cloud core).
- Cliquez sur CRÉER UNE INSTANCE.
- Configurez le nom, la région et l'édition de l'instance comme décrit dans la documentation sur la création d'instances qui utilisent des connexions sécurisées publiques, des connexions Private Service Connect ou des connexions d'accès aux services privés.
- Dans la section Authentification, sélectionnez Fédération des identités des employés (SAML/OIDC) comme méthode d'authentification principale.
- Cliquez sur Créer.
Pour définir OAuth comme méthode d'authentification secondaire, modifiez la configuration de l'instance après sa création.
gcloud
Utilisez la commande gcloud looker instances create avec l'option --workforce-auth-enabled pour créer une instance qui utilise la fédération des identités des employés comme méthode d'authentification principale :
gcloud looker instances create INSTANCE_NAME \ --project=PROJECT_ID \ --region=REGION \ --edition=EDITION \ --workforce-auth-enabled \ --async
Remplacez les éléments suivants :
INSTANCE_NAME: nom de votre instance Looker (Google Cloud Core). Il n'est pas associé à l'URL de l'instance.PROJECT_ID: ID du projet Google Cloud dans lequel vous créez l'instance Looker (Google Cloud Core).REGION: région dans laquelle votre instance Looker (Google Cloud Core) est hébergée. Les régions disponibles sont listées sur la page Emplacements Looker (Google Cloud Core).EDITION: édition de l'instance. Pour obtenir la liste des valeurs disponibles, consultez Créer une instance Looker (Google Cloud Core) avec des connexions sécurisées publiques.
Dans la Google Cloud CLI, l'authentification Google est activée par défaut lorsque vous ne spécifiez aucune option d'authentification. Chaque fois que l'authentification Google est activée, gcloud looker instances create nécessite --oauth-client-id et --oauth-client-secret. Lorsque vous spécifiez --workforce-auth-enabled sans --google-auth-enabled, la commande désactive l'authentification Google sur l'instance et vous n'avez pas besoin de fournir d'identifiants OAuth.
Pour autoriser également OAuth comme méthode d'authentification secondaire lorsque vous créez l'instance, ajoutez les options --google-auth-enabled, --oauth-client-id et --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
Remplacez OAUTH_CLIENT_ID et OAUTH_CLIENT_SECRET par l'ID client et le code secret du client de votre client OAuth.
Vous pouvez ajouter d'autres options à la commande pour appliquer d'autres paramètres d'instance, tels que des intervalles de maintenance et des canaux de publication, ou pour configurer un réseau privé :
- Pour les connexions sécurisées publiques, consultez Créer une instance Looker (Google Cloud Core) avec des connexions sécurisées publiques.
- Pour Private Service Connect, consultez Créer une instance Private Service Connect.
- Pour l'accès aux services privés, consultez Créer une instance de connexions privées (accès aux services privés).
Lorsque vous modifiez une instance existante
Si vous disposez d'une instance Looker (Google Cloud Core), vous pouvez modifier sa configuration pour sélectionner la fédération des identités des employés comme méthode d'authentification principale ou pour définir OAuth comme méthode d'authentification secondaire :
Console
- Dans la console Google Cloud, accédez à la page Looker (Google Cloud core).
- Cliquez sur le nom de l'instance que vous souhaitez modifier.
- Dans l'onglet Détails de l'instance, cliquez sur Modifier.
- Dans la section Authentification, sélectionnez Fédération des identités des employés (SAML/OIDC) comme méthode d'authentification principale.
- (Facultatif) Pour autoriser OAuth comme méthode d'authentification secondaire, activez le bouton Activer l'authentification OAuth secondaire.
- Cliquez sur Enregistrer.
gcloud
Utilisez la commande gcloud looker instances update avec l'option --workforce-auth-enabled pour sélectionner la fédération des identités des employés comme méthode d'authentification principale :
gcloud looker instances update INSTANCE_NAME \ --project=PROJECT_ID \ --region=REGION \ --workforce-auth-enabled \ --no-google-auth-enabled \ --async
Remplacez les éléments suivants :
INSTANCE_NAME: nom de votre instance Looker (Google Cloud Core).PROJECT_ID: ID du projet Google Cloud dans lequel se trouve l'instance Looker (Google Cloud Core).REGION: région dans laquelle votre instance Looker (Google Cloud Core) est hébergée.
L'option --no-google-auth-enabled désactive l'authentification Google sur l'instance. Pour conserver OAuth comme méthode d'authentification secondaire, remplacez l'option --no-google-auth-enabled par l'option --google-auth-enabled. Si l'instance ne dispose pas déjà d'un client OAuth, ajoutez également les options --oauth-client-id=OAUTH_CLIENT_ID et --oauth-client-secret=OAUTH_CLIENT_SECRET.
Étape 4 : Configurez les paramètres de Workforce Identity Federation dans Looker
Une fois votre instance Looker (Google Cloud Core) créée, un administrateur peut configurer les mappages d'attributs utilisateur, la mise en miroir des groupes et les options de connexion sur la page Authentification des employés du panneau d'administration Looker.
- Connectez-vous à votre instance Looker (Google Cloud Core) avec un compte disposant du rôle Looker Admin.
- Dans le menu de navigation, sélectionnez Admin > Authentification > Workforce Identity.
- Configurez les paramètres décrits dans les sections suivantes.
Pour en savoir plus sur les paramètres suivants, consultez la page de documentation Authentification des employés.
Fusionner des comptes utilisateur
Dans le champ Fusionner les utilisateurs à l'aide de, sélectionnez les systèmes d'authentification à partir desquels les comptes utilisateur existants doivent être fusionnés lorsqu'un utilisateur se connecte pour la première fois avec la fédération des identités des employés.
Les systèmes compatibles avec la fusion sont les suivants :
- SAML
- OIDC
Contourner la page de connexion
L'option Ignorer la page de connexion détermine si les utilisateurs non authentifiés sont automatiquement redirigés vers le portail SSO de votre entreprise :
- Activé (par défaut) : lorsque les utilisateurs accèdent à l'URL de votre instance, ils sont automatiquement redirigés vers l'écran de connexion de votre IdP sans voir la page de connexion Looker.
- Désactivé : les utilisateurs voient la page de connexion Looker et peuvent choisir parmi les options d'authentification disponibles.
Cliquez sur Enregistrer la configuration pour appliquer vos paramètres.
Mappage des attributs utilisateur
Mappez les revendications de votre assertion IdP aux attributs utilisateur Looker. Les attributs utilisateur peuvent être utilisés à de nombreuses fins, par exemple pour paramétrer les connexions à la base de données et appliquer des filtres de sécurité au niveau des lignes.
- Dans la section Mappage d'attributs, mappez les attributs de personnel Google aux attributs utilisateur Looker correspondants (par exemple, mappez
attribute.departmentà un attribut utilisateurdepartmentdans Looker).
Groupes et rôles
Vous pouvez gérer les rôles utilisateur via la mise en miroir des groupes ou l'attribution de rôles par défaut :
- Dupliquer les groupes de l'IdP : lorsque ce paramètre est activé, Looker (Google Cloud Core) crée des groupes Looker qui dupliquent les groupes transmis dans l'assertion du jeton de l'IdP.
- Dans le tableau Mappage des groupes, mappez les noms des groupes de l'IdP externe aux groupes Looker et attribuez les rôles Looker appropriés (par exemple, Lecteur, Utilisateur ou Développeur).
- Rôle par défaut des nouveaux utilisateurs : si la mise en miroir des groupes n'est pas utilisée ou ne correspond pas à un utilisateur, spécifiez le rôle par défaut à attribuer aux nouveaux utilisateurs lors de leur première connexion.
- Groupe par défaut pour les nouveaux utilisateurs : si la mise en miroir des groupes n'est pas utilisée ou ne correspond pas à un utilisateur, spécifiez le groupe par défaut à attribuer aux nouveaux utilisateurs.
Gestion des sessions et validité des jetons
Les sessions utilisateur et les jetons dans Looker (Google Cloud Core) sont régis par la durée de session et la validité du jeton d'actualisation configurées dans la stratégie de votre pool d'identités de personnel (par exemple, une stratégie de durée de session prolongée) :
- Sessions de navigateur : les paramètres de durée de session de Looker sont compatibles avec les sessions d'une durée maximale de 30 jours lorsque vous utilisez des sessions persistantes. Toutefois, la validité du jeton d'actualisation du pool d'identités des employés prévaut si elle est inférieure à la durée de session configurée dans Looker. Lorsque le jeton d'actualisation expire, l'utilisateur doit se reconnecter. Nous vous recommandons de définir une validité de jeton d'actualisation de 90 jours dans votre règle de durée de session prolongée.
- Livraisons et alertes planifiées (jobs hors connexion) : les jobs en arrière-plan s'exécutent tant que le propriétaire de la planification dispose d'un jeton IdP actif. Si un créateur de planification ou d'alerte ne se connecte pas à l'instance pendant plus de 90 jours (ou pendant la durée configurée dans la règle de session de votre pool d'employés), sa session hors connexion expire, et les envois planifiés ou les alertes appartenant à cet utilisateur sont mis en veille. Pour reprendre les planifications ou les alertes suspendues, le propriétaire doit se connecter à l'instance, ou un administrateur doit attribuer la propriété de la planification.
- Serveur et connecteurs OAuth Looker : les intégrations qui utilisent le serveur OAuth Looker (comme Data Studio, les feuilles connectées et les connecteurs tiers) utilisent un jeton d'actualisation de 30 jours (ou un jeton d'actualisation sans expiration dans Data Studio). Si la durée de session du pool d'employés est définie sur moins de 90 jours, les utilisateurs devront peut-être se réauthentifier auprès de Looker à l'expiration de la durée de session.
- Clés API utilisateur : les jetons d'accès API générés par les clés API utilisateur sont valides pendant une heure et nécessitent une session IdP utilisateur active. Si la session IdP de l'utilisateur expire (tous les 90 jours ou en fonction de la durée de la session du pool d'employés), l'utilisateur doit se reconnecter à l'instance pour continuer à utiliser ses clés API.
- Clés API de compte de service : les jetons d'accès API de compte de service ne sont pas affectés par les règles de session de pool d'employés.
Étapes suivantes
- Gérer les utilisateurs dans Looker (Google Cloud Core)
- Contrôle des accès Looker (Google Cloud Core) avec IAM
- Gérer les règles de maintenance d'une instance Looker (Google Cloud Core)