Utiliser la fédération d'identité de personnel pour l'authentification des utilisateurs Looker (Google Cloud Core)

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 :

  1. 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.
  2. É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.
  3. 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.
  4. 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 :

API requises

Activez les API suivantes dans votre projet Google Cloud  :

É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 :

  1. 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.
  2. 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) et attribute.family_name (nom). Ces mappages sont obligatoires pour renseigner les profils utilisateur Looker. L'authentification échouera si ces mappages sont manquants.
  3. 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'application groups si 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.

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 :

  1. 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.
  2. 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

  1. Dans la console Google Cloud, accédez à la page Looker (Google Cloud core).

    Accéder à Looker (Google Cloud Core)

  2. Cliquez sur CRÉER UNE INSTANCE.
  3. 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.
  4. Dans la section Authentification, sélectionnez Fédération des identités des employés (SAML/OIDC) comme méthode d'authentification principale.
  5. 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 :

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é :

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

  1. Dans la console Google Cloud, accédez à la page Looker (Google Cloud core).

    Accéder à Looker (Google Cloud Core)

  2. Cliquez sur le nom de l'instance que vous souhaitez modifier.
  3. Dans l'onglet Détails de l'instance, cliquez sur Modifier.
  4. Dans la section Authentification, sélectionnez Fédération des identités des employés (SAML/OIDC) comme méthode d'authentification principale.
  5. (Facultatif) Pour autoriser OAuth comme méthode d'authentification secondaire, activez le bouton Activer l'authentification OAuth secondaire.
  6. 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.

  1. Connectez-vous à votre instance Looker (Google Cloud Core) avec un compte disposant du rôle Looker Admin.
  2. Dans le menu de navigation, sélectionnez Admin > Authentification > Workforce Identity.
  3. 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 :

  • Google
  • 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 utilisateur department dans 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