Configurer l'identité tierce

Compatible avec :

Ce guide s'adresse aux administrateurs Google Security Operations qui souhaitent authentifier leur personnel (utilisateurs et groupes) sur Google SecOps à l'aide d'un fournisseur d'identité (IdP) tiers. Ce processus est possible grâce à laGoogle Cloud fédération des identités des employés.

La fédération des identités des employés est compatible avec tous les IdP qui utilisent Security Assertion Markup Language (SAML 2.0) ou OpenID Connect (OIDC), tels qu'Okta, Microsoft Entra ID et Microsoft Active Directory Federation Services (AD FS).

Ce document décrit les étapes générales de configuration de l'authentification via un IdP basé sur SAML ou OIDC à l'aide de la fédération des identités des employés :

  1. Planifiez les ressources requises. Choisissez les détails de votre pool d'identités des employés et de votre fournisseur, puis identifiez les attributs et les groupes d'utilisateurs nécessaires pour configurer l'accès aux fonctionnalités de Google SecOps.
  2. Configurez l'application du fournisseur d'identité tiers. Créez une application SAML ou OIDC de fournisseur d'identité à intégrer à la fédération des identités des employés et à Google SecOps.
  3. Configurer la fédération des identités des employés Configurez votre pool d'identités d'employés et votre fournisseur d'identité, puis attribuez des rôles IAM (Identity and Access Management) Google Cloud aux groupes et aux utilisateurs du fournisseur d'identité.
  4. Configurez l'authentification unique (SSO) à l'aide du fournisseur que vous venez de créer.

Après avoir suivi ces étapes, vous pouvez vous connecter à Google SecOps avec votre fournisseur d'identité et gérer l'accès des utilisateurs via le contrôle des accès basé sur les rôles (RBAC) à l'aide d'IAM.

Cas d'utilisation courants

Google SecOps nécessite l'utilisation de la fédération des identités des employés en tant qu'agent SSO pour un ensemble varié de cas d'utilisation.

Respecter des normes de sécurité strictes

  • Objectif : respecter des normes réglementaires strictes pour l'accès au système et au cloud.
  • Valeur : aide à respecter les exigences de conformité FedRAMP High (ou supérieures) en négociant l'authentification unique de manière sécurisée.

Gérer le contrôle des accès d'entreprise

  • Objectif : contrôler l'accès aux fonctionnalités et aux données de manière centralisée dans l'ensemble de l'organisation.
  • Valeur : active le RBAC au niveau de l'entreprise dans Google SecOps à l'aide d'IAM.

Terminologie clé

  • Pool d'employés : ressource Google Cloud unique au monde définie au niveau de l'organisation qui accorde à vos employés l'accès à Google SecOps.
  • Fournisseur de personnel : sous-ressource du pool d'identités de personnel qui stocke les détails de configuration d'un seul IdP externe.
  • Mappage d'attributs : processus de traduction des attributs d'assertion fournis par votre IdP en attributs Google Cloud à l'aide du langage CEL (Common Expression Language).
  • URL ACS (Assertion Consumer Service) : URL spécifique (parfois appelée URL d'authentification unique selon le fournisseur) utilisée pour configurer une application SAML afin qu'elle communique avec Google SecOps.
  • ID d'entité : URL d'identifiant unique qui identifie une application ou un service spécifique, comme Google SecOps, et configure l'application SAML dans votre IdP.

Présentation du processus

Google SecOps est compatible avec l'authentification unique SAML ou OIDC initiée par le fournisseur de services (SP). Cette fonctionnalité vous permet d'accéder directement à Google SecOps. Google SecOps envoie une requête au fournisseur d'identité tiers via la fédération des identités des employés IAM.

Une fois que l'IdP a authentifié l'identité de l'utilisateur, celui-ci est renvoyé vers Google SecOps avec une assertion d'authentification SAML ou un jeton d'ID OIDC. Google Cloud La fédération des identités des employés sert d'intermédiaire dans le flux d'authentification.

Communication entre Google SecOps, la fédération des identités des employés IAM Google Cloud et l'IdP

Communication entre Google SecOps, la fédération des identités des employés IAM et l'IdP

De manière générale, la communication se déroule comme suit :

  1. L'utilisateur accède à Google SecOps.
  2. Google SecOps recherche les informations du fournisseur d'identité dans le pool d'identités de personnel Google Cloud.
  3. Une requête est envoyée au fournisseur d'identité.
  4. L'assertion SAML ou le jeton d'ID OIDC est envoyé au pool d'identités des employés Google Cloud .
  5. Si l'authentification réussit, Google SecOps ne reçoit que les attributs SAML ou les revendications OIDC définis lorsque vous avez configuré le fournisseur d'employés dans le pool d'identités des employés.

En tant qu'administrateur Google SecOps, vous créez des groupes dans votre fournisseur d'identité, configurez l'application SAML ou OIDC pour transmettre les informations d'appartenance au groupe dans l'assertion ou le jeton d'ID, et associez les utilisateurs et les groupes aux rôles prédéfinis dans IAM ou aux rôles personnalisés que vous avez créés.

Avant de commencer

Planifier l'implémentation

Cette section décrit les décisions que vous devez prendre et les informations que vous devez définir avant d'effectuer les étapes de ce document.

Définir le pool d'identités de personnel et le fournisseur de personnel

Pour configurer l'authentification via un IdP, vous devez configurer la fédération des identités des employés en tant qu'intermédiaire dans le flux d'authentification. Avant de configurer la fédération des identités des employés, définissez les ressourcesGoogle Cloud suivantes :

  • Pool d'employés : un pool d'identités d'employés permet à vos employés d'accéder à Google SecOps.
  • Fournisseur d'employés : sous-ressource du pool d'identités d'employés qui stocke les détails d'un seul IdP.

La relation entre le pool d'identités des employés, les fournisseurs d'identités des employés et une instance Google SecOps, identifiée par un seul sous-domaine client, est la suivante :

  • Un pool d'identités d'employés est défini au niveau de l'organisation.
  • Chaque instance Google SecOps est associée à un pool d'identités d'employés configuré.
  • Un pool d'identités de personnel peut avoir plusieurs fournisseurs de personnel.
  • Chaque fournisseur d'employés intègre un IdP tiers au pool d'identités des employés.

  • Le pool d'identités des employés doit être dédié à Google SecOps. Vous ne pouvez pas partager le pool créé pour Google SecOps à d'autres fins.

  • Le pool d'identités de personnel doit se trouver dans la même organisationGoogle Cloud que celle qui contient le projet lié à Google SecOps.

Voici les consignes à suivre pour définir les valeurs des identifiants clés du pool d'employés et du fournisseur d'employés :

  • ID du pool d'employés (WORKFORCE_POOL_ID) : définissez une valeur qui indique le champ d'application ou l'objectif du pool d'identités d'employés. La valeur doit répondre aux exigences suivantes :
    • Il doit être unique.
    • Il ne doit contenir que des caractères minuscules [a-z], des chiffres [0-9] et des tirets [-].
    • Doit commencer par une lettre minuscule [a-z].
    • Doit se terminer par un caractère minuscule [a-z] ou un chiffre [0-9].
    • Il peut comporter entre 4 et 61 caractères.
  • Nom à afficher du pool d'employés (WORKFORCE_POOL_DISPLAY_NAME) : définissez un nom convivial pour le pool d'identités d'employés.
  • Description du pool de personnel (WORKFORCE_POOL_DESCRIPTION) : définissez une description détaillée du pool d'identités de personnel.
  • ID du fournisseur de personnel (WORKFORCE_PROVIDER_ID) : définissez une valeur qui indique le fournisseur d'identité qu'il représente. La valeur doit répondre aux exigences suivantes :
    • Il ne doit contenir que des caractères minuscules [a-z], des chiffres [0-9] et des tirets [-].
    • Il peut comporter entre 4 et 32 caractères.
  • Nom à afficher du fournisseur pour le personnel (WORKFORCE_PROVIDER_DISPLAY_NAME) : définissez un nom convivial pour le fournisseur pour le personnel. Il doit comporter moins de 32 caractères.
  • Description du fournisseur de personnel (WORKFORCE_PROVIDER_DESCRIPTION) : définissez une description détaillée du fournisseur de personnel.

Définir des attributs utilisateur et des groupes dans l'IdP

Avant de créer l'application SAML ou OIDC dans l'IdP, identifiez les attributs utilisateur ou les revendications et groupes OIDC nécessaires pour configurer l'accès aux fonctionnalités dans Google SecOps. Les attributs utilisateur standards sont les suivants :

  • Objet
  • E-mail
  • Prénom
  • Nom
  • Nom à afficher

Vous aurez besoin des informations sur les groupes d'utilisateurs et les attributs ou les revendications OIDC lors des phases suivantes de ce processus :

  • Lors de la configuration de l'application SAML ou OIDC, vous créez les groupes définis lors de la planification. Vous configurez l'application IdP pour qu'elle transmette les appartenances aux groupes dans l'assertion SAML ou le jeton d'ID OIDC.

  • Lorsque vous créez le fournisseur d'employés, vous mappez les attributs d'assertion SAML ou les revendications et groupes OIDC aux attributsGoogle Cloud . Ces informations sont envoyées dans l'assertion ou le jeton d'ID dans le cadre de l'identité d'un utilisateur.

Configurer l'application IdP

Cette section ne décrit que la configuration spécifique requise dans une application SAML ou OIDC d'IdP pour l'intégration à la fédération des identités des employés Google Cloudet à Google SecOps. Pour connaître la procédure détaillée, consultez la documentation de votre IdP.

Configurer une application SAML dans votre IdP

  1. Créez des groupes dans votre IdP, s'ils n'existent pas déjà.

    Nous vous recommandons d'utiliser des groupes plutôt que des comptes utilisateur individuels pour gérer l'accès à votre instance Google SecOps. Google recommande de créer des groupes dans votre IdP qui correspondent directement aux rôles Google SecOps par défaut.

    Reportez-vous à l'exemple suivant :

    Rôle Google SecOps Groupe IdP (suggéré)
    Administrateur de l'API Chronicle chronicle_secops_admins
    Éditeur de l'API Chronicle chronicle_secops_editor
    Lecteur de l'API Chronicle chronicle_secops_viewer
  2. Créez une application SAML dans votre IdP.

  3. Configurez l'application avec les éléments suivants :

    1. Spécifiez l'URL ACS (Assertion Consumer Service), également appelée "URL d'authentification unique" selon le fournisseur de services.

      https://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID
      

      Remplacez les éléments suivants :

      • WORKFORCE_POOL_ID : identifiant que vous avez défini pour le pool d'identités de personnel.
      • WORKFORCE_PROVIDER_ID : identifiant que vous avez défini pour le fournisseur d'employés.

      Pour obtenir une description des valeurs, consultez Définir le pool d'identités de personnel et le fournisseur de personnel.

    2. Spécifiez l'ID d'entité suivant (également appelé ID d'entité du fournisseur de services).

      https://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID
      
    3. Configurez l'identifiant de nom dans votre IdP pour vous assurer que le champ NameID est renvoyé dans la réponse SAML.

      Vous pouvez définir cette valeur sur une valeur compatible avec vos règles d'administration, comme une adresse e-mail ou un nom d'utilisateur. Consultez la documentation de votre IdP pour savoir comment configurer cette valeur. Pour en savoir plus sur cette exigence, consultez Résoudre les problèmes liés à la fédération des identités des employés.

  4. Ajoutez les instructions d'attribut qui vous permettent de transmettre les informations utilisateur de l'IdP à vos Application Integrations. Vous avez défini les attributs lorsque vous avez planifié l'implémentation de l'IdP.

    Par exemple, utilisez le tableau suivant pour mapper les attributs dans les IdP couramment utilisés, tels qu'Okta, Microsoft AD FS ou Entra ID :

    Nom de l'attribut Valeur Okta AD FS/Entra ID (attribut source)
    subject user.email user.mail ou user.userprincipalname
    emailaddress user.email user.mail
    first_name user.firstName user.givenname
    last_name user.lastName user.surname
    display_name user.displayName user.displayname
    groups Configuré à l'aide d'un filtre de groupe dans l'IdP, tel que Correspond à l'expression régulière avec .* Extrait du mappage de groupe dans l'IdP

    Si vous configurez une application IdP Okta, veillez à sélectionner Non spécifié comme format lors de l'ajout des attributs. Laissez l'espace de noms vide si vous utilisez Microsoft AD FS ou Entra ID comme IdP.

  5. Attribuez les groupes et les utilisateurs appropriés à l'application dans votre IdP.

    Ces groupes et utilisateurs seront autorisés à accéder à Google SecOps.

  6. Téléchargez le fichier XML de métadonnées de l'application.

    Dans la section suivante, vous utiliserez ce fichier de métadonnées pour configurer votre fournisseur d'identité des employés. Si vous utilisez Google Cloud CLI, vous devez importer ce fichier depuis votre système local vers votre répertoire d'accueil Google Cloud à l'aide de Cloud Shell.

Configurer une application OIDC dans votre IdP

Pour configurer une application OIDC dans votre IdP afin de l'intégrer à la fédération des identités des employés et à Google SecOps, procédez comme suit :

  1. Si vous n'avez pas encore créé de groupes, créez-les dans votre IdP. Nous vous recommandons d'utiliser des groupes plutôt que des comptes utilisateur individuels pour gérer l'accès à votre instance Google SecOps.

  2. Créez une application OIDC dans votre IdP et suivez les étapes de préparation de l'IdP dans Créer un fournisseur de pools de personnel OIDC.

  3. Configurez l'application avec les deux URI de redirection suivants, que certains IdP appellent "URL de rappel" ou "URI de redirection de connexion" :

    • Pour la connexion à Google SecOps :

      https://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID
      
    • Pour la validation du jeton et du mappage d'attributs de la fédération des identités des employés :

      https://auth.cloud.google/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID
      

    Remplacez les éléments suivants :

    • WORKFORCE_POOL_ID : identifiant que vous avez défini pour le pool d'identités de personnel.
    • WORKFORCE_PROVIDER_ID : identifiant que vous avez défini pour le fournisseur d'employés.

    Pour obtenir une description des valeurs, consultez Définir le pool d'identités de personnel et le fournisseur de personnel.

  4. Sélectionnez le type d'autorisation dans votre application IdP : le flux avec code d'autorisation recommandé ou le flux implicite. Si vous utilisez le flux implicite, assurez-vous que l'application est configurée pour renvoyer le jeton d'ID.

  5. Configurez votre application IdP pour qu'elle renvoie la revendication sub, ainsi que les revendications d'utilisateur et de groupe que vous avez identifiées lorsque vous avez planifié l'implémentation de l'IdP.

    Par exemple, utilisez le tableau suivant pour mapper les revendications dans les IdP couramment utilisés, tels qu'Okta, Microsoft AD FS ou Entra ID :

    Nom de la demande Valeur Okta AD FS/Entra ID (attribut source)
    sub user.email user.mail ou user.userprincipalname
    email user.email user.mail
    given_name user.firstName user.givenname
    family_name user.lastName user.surname
    name user.displayName user.displayname
    groups Configuré à l'aide d'un filtre de groupe dans l'IdP, tel que Correspond à l'expression régulière avec .* Extrait du mappage de groupe dans l'IdP

    Si vous configurez une application IdP Okta ou Entra ID, assurez-vous que les champs d'application standards (tels que openid, profile et email) sont accordés pour transmettre ces revendications. Si vous utilisez Microsoft AD FS ou Entra ID, configurez les mappages de revendications en conséquence.

    Si votre application Okta OIDC utilise un serveur d'autorisation d'organisation, vous devez également transmettre groups en tant que champ d'application supplémentaire lorsque vous créez le fournisseur de fédération des identités des employés afin qu'Okta renvoie la revendication groups. Pour en savoir plus, consultez Configurer la fédération des identités des employés avec Okta.

  6. Attribuez les groupes et les utilisateurs appropriés à l'application OIDC dans votre IdP.

  7. Enregistrez les identifiants suivants de votre application IdP pour les utiliser lorsque vous créez un fournisseur de pools d'identités des employés OIDC :

    • Flux avec code d'autorisation : ID client, URI de l'émetteur et code secret du client.
    • Flux implicite : ID client et URI de l'émetteur.

Configurer la fédération des identités des employés

Cette section ne décrit que les étapes spécifiques nécessaires pour configurer la fédération des identités des employés avec l'application IdP SAML ou OIDC que vous avez créée dans la section précédente. Pour en savoir plus sur la gestion des pools d'identités de personnel, consultez Gérer les fournisseurs de pools d'identités de personnel.

Définir le projet de facturation et de quota

  1. Ouvrez la console Google Cloud en tant qu'utilisateur disposant des autorisations requises sur le projet lié à Google SecOps. Vous avez identifié ou créé cet utilisateur précédemment. Consultez la section Avant de commencer.

  2. Lancez une session Cloud Shell.

  3. Définissez le projet Google Cloud de facturation/quotas pour les opérations effectuées à l'aide de gcloud CLI. Utilisez la commande gcloud suivante à titre d'exemple :

    gcloud config set billing/quota_project PROJECT_ID
    

    Remplacez PROJECT_ID par l'ID du projet lié à Google SecOps que vous avez créé dans Configurer un projet Google Cloud pour Google SecOps. Pour obtenir une description des champs qui identifient un projet, consultez Créer et gérer des projets.

    Pour en savoir plus sur les quotas, consultez les documents suivants :

    Si vous rencontrez une erreur, consultez Résoudre les erreurs de quota.

Créer et configurer un pool d'identités de personnel

Vous pouvez configurer un pool d'identités de personnel pour l'intégrer à un fournisseur d'identité externe, ou à Google Workspace ou Cloud Identity.

Console

Pour créer le pool d'identités de personnel, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Pools d'identités de personnel :

    Accéder aux pools d'identités de personnel

  2. Sélectionnez l'organisation de votre pool d'identités d'employés. Les pools d'identités de personnel sont disponibles pour tous les projets et dossiers d'une organisation.

  3. Cliquez sur Créer un pool et procédez comme suit :

    1. Dans le champ Nom, saisissez le nom à afficher du pool. L'ID du pool est automatiquement dérivé du nom au fur et à mesure de la saisie, et s'affiche sous le champ Nom. Vous pouvez modifier l'ID du pool en cliquant sur Modifier à côté de l'ID du pool.

    2. Facultatif : Dans le champ Description, saisissez une description du pool.

  4. Cliquez sur Suivant.

La durée de session du pool d'identités de personnel est d'une heure par défaut. Cette durée détermine la validité des jetons d'accès Google Cloud , de la console de fédération des identités des employésGoogle Cloud et des sessions de connexion à gcloud CLI. Vous pouvez mettre à jour le pool pour définir une durée de session personnalisée comprise entre 15 minutes et 12 heures.

gcloud

  1. Créez un pool d'identités de personnel.

    Utilisez la commande gcloud suivante à titre d'exemple :

    gcloud iam workforce-pools create WORKFORCE_POOL_ID\
      --location="global" \
      --organization=ORGANIZATION_ID \
      --description="WORKFORCE_POOL_DESCRIPTION" \
      --display-name="WORKFORCE_POOL_DISPLAY_NAME" \
      --session-duration=SESSION_DURATION
    

    Remplacez les éléments suivants :

    • WORKFORCE_POOL_ID : valeur que vous avez définie pour l'ID du pool d'identités d'employés.
    • ORGANIZATION_ID : ID d'organisation.
    • WORKFORCE_POOL_DESCRIPTION : description facultative du pool d'identités de personnel.
    • WORKFORCE_POOL_DISPLAY_NAME : nom convivial facultatif pour le pool d'identités de personnel.
    • SESSION_DURATION : valeur facultative pour la durée de la session, exprimée sous la forme d'un nombre suivi de s (par exemple, 3600s). Cette durée détermine la validité des jetons d'accès Google Cloud, de la console de fédération des identités des employésGoogle Cloud et des sessions de connexion à la gcloud CLI. Vous pouvez mettre à jour le pool pour définir une durée de session personnalisée comprise entre 15 minutes et 12 heures.

    Pour utiliser Google Workspace ou Cloud Identity pour vous connecter à Google SecOps, ajoutez les options --allowed-services domain=backstory.chronicle.security et --disable-programmatic-signin à la commande.

    gcloud iam workforce-pools create WORKFORCE_POOL_ID\
          --location="global" \
          --organization="ORGANIZATION_ID" \
          --description="WORKFORCE_POOL_DESCRIPTION" \
          --display-name="WORKFORCE_POOL_DISPLAY_NAME" \
          --session-duration=SESSION_DURATION \
          --allowed-services domain=backstory.chronicle.security \
          --disable-programmatic-signin
    

    Cette commande crée un pool d'identités de personnel qui n'est pas compatible avec la connexion à Google Cloud. Pour activer la fonctionnalité de connexion, vous devez utiliser les options appropriées pour chaque scénario.

  2. Si vous êtes invité à activer l'API Chronicle, saisissez Yes.

Créer un fournisseur de pools d'identités de personnel

Un fournisseur de pools d'identités de personnel décrit une relation entre votre organisationGoogle Cloud et votre IdP. Choisissez la section correspondant à votre protocole d'authentification :

Créer un fournisseur de pools d'identités de personnel SAML

Console

Pour configurer le fournisseur de pool d'identités de personnel, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Pools d'identités de personnel :

    Accéder aux pools d'identités de personnel

  2. Dans le tableau Pools d'identités de personnel, sélectionnez le pool pour lequel vous souhaitez créer le fournisseur.

  3. Dans la section Fournisseurs, cliquez sur  Ajouter un fournisseur.

  4. Dans Sélectionner un fournisseur, sélectionnez votre IdP.

    Si votre IdP ne figure pas dans la liste, sélectionnez Fournisseur d'identité générique.

  5. Dans Sélectionner un protocole d'authentification, sélectionnez SAML.

  6. Dans la section Créer un fournisseur, procédez comme suit :

    1. Dans Nom, saisissez un nom pour le fournisseur.

    2. Facultatif : Dans le champ Description, saisissez une description du fournisseur.

    3. Dans Fichier de métadonnées IdP (XML), sélectionnez le fichier XML de métadonnées que vous avez généré précédemment dans ce guide.

    4. Assurez-vous que l'option Activer le fournisseur est activée.

    5. Cliquez sur Continuer.

  7. Dans la section Partager les informations de votre fournisseur, copiez les URL :

    • Configurez la première URL (https://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID) en tant qu'ID d'entité dans votre IdP.
    • La deuxième URL (https://auth.cloud.google/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID) est utilisée pour la validation des jetons et du mappage de la fédération des identités des employés (à l'aide de la fonctionnalité Déboguer le jeton IdP). Assurez-vous que votre IdP inclut à la fois cette URL et l'URL de connexion ACS Google SecOps (https://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID) que vous avez configurée dans Configurer une application SAML dans votre IdP.
  8. Cliquez sur Continuer.

  9. Dans la section Configurer le fournisseur, procédez comme suit :

    1. Dans Mappage des attributs, saisissez les mappages dans les champs correspondants. Exemple :

      Google X (où X est un nombre) SAML X (où X est un nombre)
      google.subject assertion.subject
      google.groups assertion.attributes.groups
      google.display_name assertion.attributes.display_name[0]
      attribute.first_name assertion.attributes.first_name[0]
      attribute.last_name assertion.attributes.last_name[0]
      attribute.user_email assertion.attributes.emailaddress[0]

      Si vous effectuez cette configuration pour Google Security Operations, qui inclut Google Security Operations SIEM et Google SecOps SOAR, mappez les attributs suivants requis par Google SecOps SOAR :

      • attribute.first_name
      • attribute.last_name
      • attribute.user_email
      • google.groups
      • google.display_name
    2. Facultatif : Si vous avez sélectionné Microsoft Entra ID comme IdP, vous pouvez augmenter le nombre de groupes en procédant comme suit :

      1. Sélectionnez Utiliser des attributs supplémentaires.
      2. Dans le champ URI de l'émetteur des attributs supplémentaires, saisissez l'URL de l'émetteur.
      3. Dans le champ ID client des attributs supplémentaires, saisissez l'ID client.
      4. Dans le champ Code secret du client pour les attributs supplémentaires, saisissez le code secret du client.
      5. Dans la liste Type d'attributs supplémentaires, sélectionnez un type d'attribut pour les attributs supplémentaires.
      6. Dans le champ Filtre d'attributs supplémentaires, saisissez une expression de filtre utilisée pour rechercher des groupes avec l'API Microsoft Graph.
    3. Facultatif : pour ajouter une condition d'attribut, cliquez sur Ajouter une condition, puis saisissez une expression CEL représentant une condition d'attribut. Par exemple, pour limiter l'attribut ipaddr à une certaine plage d'adresses IP, vous pouvez définir la condition assertion.attributes.ipaddr.startsWith('98.11.12.'). Cet exemple de condition garantit que seuls les utilisateurs dont l'adresse IP commence par 98.11.12. peuvent se connecter en utilisant ce fournisseur de personnel.

    4. Pour activer la journalisation d'audit détaillée, dans Journalisation détaillée, cliquez sur le bouton Activer la journalisation d'audit des valeurs d'attribut.

  10. Pour créer le fournisseur, cliquez sur Envoyer.

gcloud

Pour configurer le fournisseur de pool d'identités de personnel :

  1. Importez le fichier de métadonnées de l'application SAML dans votre répertoire d'accueil Cloud Shell en cliquant sur Plus >. Les fichiers ne peuvent être importés que dans votre répertoire d'accueil. Pour découvrir d'autres options de transfert de fichiers entre Cloud Shell et votre poste de travail local, consultez Importer et télécharger des fichiers et des dossiers depuis Cloud Shell.

  2. Notez le chemin d'accès au répertoire dans lequel vous avez importé le fichier XML de métadonnées de l'application SAML dans Cloud Shell. Vous en aurez besoin à l'étape suivante.

  3. Créez un fournisseur de pools d'identités de personnel et spécifiez les informations sur l'IdP.

    Utilisez la commande gcloud suivante à titre d'exemple :

    gcloud iam workforce-pools providers create-saml WORKFORCE_PROVIDER_ID \
      --workforce-pool="WORKFORCE_POOL_ID" \
      --location="global" \
      --display-name="WORKFORCE_PROVIDER_DISPLAY_NAME" \
      --description="WORKFORCE_PROVIDER_DESCRIPTION" \
      --idp-metadata-path=PATH_TO_METADATA_XML \
      --attribute-mapping="ATTRIBUTE_MAPPINGS"
    

    Consultez Planifier l'implémentation pour obtenir une description des valeurs.

    Remplacez les éléments suivants :

    • WORKFORCE_PROVIDER_ID : valeur que vous avez définie pour l'ID du fournisseur de personnel.
    • WORKFORCE_POOL_ID : valeur que vous avez définie pour l'ID du pool d'identités d'employés.
    • WORKFORCE_PROVIDER_DISPLAY_NAME : nom convivial facultatif pour le fournisseur de personnel. Il doit comporter moins de 32 caractères.
    • WORKFORCE_PROVIDER_DESCRIPTION : description facultative du fournisseur de personnel.
    • PATH_TO_METADATA_XML : emplacement du répertoire Cloud Shell du fichier XML de métadonnées de l'application que vous avez importé à l'aide de Cloud Shell, par exemple : /path/to/sso_metadata.xml.
    • ATTRIBUTE_MAPPINGS : définition de la manière de mapper les attributs d'assertion aux attributsGoogle Cloud . Le langage d'expression commun est utilisé pour interpréter ces mappages. Exemple :
    google.subject=assertion.subject,google.display_name=assertion.attributes.name[0],google.groups=assertion.attributes.groups
    

    L'exemple précédent mappe les attributs suivants :

    • assertion.subject à google.subject. Il s'agit d'une exigence minimale.
    • assertion.attributes.name[0] à google.display_name.
    • assertion.attributes.groups à l'attribut google.groups.

    Si vous effectuez cette configuration pour Google Security Operations, qui inclut Google Security Operations SIEM et Google SecOps SOAR, mappez les attributs suivants requis par Google SecOps SOAR :

    • attribute.first_name
    • attribute.last_name
    • attribute.user_email
    • google.groups
    • google.display_name

    Le mappage complet est donc le suivant :

    google.subject=assertion.subject,google.groups=assertion.attributes.groups,attribute.first_name=assertion.attributes.first_name[0],attribute.last_name=assertion.attributes.last_name[0],attribute.user_email=assertion.attributes.emailaddress[0],google.display_name=assertion.attributes.display_name[0]
    

    Pour en savoir plus, consultez Provisionner et mapper des utilisateurs pour Google SecOps SOAR.

    Lorsque vous configurez votre application SAML pour transmettre des informations d'appartenance à un groupe, les noms d'attributs de groupe courants incluent groups, idpGroup et memberOf. Dans le mappage d'attributs de la fédération des identités des employés, assurez-vous que le nom de l'attribut dans assertion.attributes.ATTRIBUTE_NAME correspond exactement au nom configuré dans votre IdP (sensible à la casse).

    L'exemple suivant mappe plusieurs groupes à l'attribut google.groups :

    google.groups="(has(assertion.attributes.idpGroup) ? assertion.attributes.idpGroup : []) + (has(assertion.attributes.groups) ? assertion.attributes.groups : []) + (has(assertion.attributes.memberOf) ? assertion.attributes.memberOf : [])"
    

    L'exemple suivant mappe le groupe http://schemas.xmlsoap.org/ws/2005/05/identity/claims/group contenant des caractères spéciaux sur google.groups :

    google.groups="assertion.attributes['http://schemas.xmlsoap.org/ws/2005/05/identity/claims/group']"
    

    Pour en savoir plus sur le mappage d'attributs, consultez Mappages d'attributs.

Créer un fournisseur de pools d'identités de personnel OIDC

Pour créer un fournisseur de pools d'identités des employés OIDC à l'aide de la consoleGoogle Cloud ou de la gcloud CLI, procédez comme suit :

  1. Suivez les instructions de la section Créer un fournisseur de pools d'employés OIDC pour créer le fournisseur dans votre pool d'identités des employés.

  2. Lorsque vous configurez le fournisseur OIDC, appliquez les paramètres Google SecOps suivants :

    • URI de redirection : assurez-vous que votre application IdP OIDC inclut les deux URI de redirection suivants, comme décrit dans Configurer une application OIDC dans votre IdP :

      • URI de redirection de connexion Google SecOps (https://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID)
      • URI de redirection de validation de la fédération des identités des employés (https://auth.cloud.google/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID)
    • Mappages d'attributs : mappez vos revendications OIDC aux attributsGoogle Cloud à l'aide du langage CEL (Common Expression Language). Au minimum, mappez google.subject sur assertion.sub et google.groups sur assertion.groups pour que le RBAC Google SecOps fonctionne comme prévu :

      google.subject=assertion.sub,google.groups=assertion.groups
      

      Si vous configurez Google Security Operations, qui inclut Google Security Operations SIEM et Google SecOps SOAR, mappez également les attributs requis par Google SecOps SOAR. Exemple :

      google.subject=assertion.sub,google.groups=assertion.groups,attribute.first_name=assertion.given_name,attribute.last_name=assertion.family_name,attribute.user_email=assertion.email,google.display_name=assertion.name
      

      Exemples de mappage de groupe avancé

      Lorsque vous configurez votre application OIDC pour transmettre des informations d'appartenance à un groupe, les noms de revendication de groupe courants incluent groups, idpGroup et memberOf. Dans le mappage d'attributs de la fédération des identités des employés, assurez-vous que le nom de la revendication dans assertion.CLAIM_NAME correspond exactement au nom sensible à la casse configuré dans votre IdP.

      L'exemple suivant mappe plusieurs groupes à l'attribut google.groups :

      google.groups="(has(assertion.idpGroup) ? assertion.idpGroup : []) + (has(assertion.groups) ? assertion.groups : []) + (has(assertion.memberOf) ? assertion.memberOf : [])"
      

      L'exemple suivant mappe une revendication de groupe contenant des caractères spéciaux (comme un schéma d'URI) à google.groups :

      google.groups="assertion['http://schemas.xmlsoap.org/ws/2005/05/identity/claims/group']"
      
  3. Facultatif : Créez une condition d'attribut. Si votre IdP mutualisé ne comporte qu'un seul URI d'émetteur, vous devez utiliser des conditions d'attribut pour vous assurer que l'accès est limité au bon locataire. Par exemple, vous pouvez limiter la connexion aux utilisateurs disposant d'un rôle ou d'un domaine de messagerie spécifique. Pour en savoir plus, consultez Utiliser des conditions d'attribut lors de la fédération avec des fournisseurs d'identité mutualisés.

  4. Après avoir créé le fournisseur d'identité des employés OIDC, nous vous recommandons de valider vos mappages de jetons et d'attributs à l'aide de l'option Déboguer votre jeton IdP, puis de passer à la section Attribuer un rôle pour activer la connexion à Google SecOps pour terminer les sections restantes de ce document.

Attribuer un rôle pour permettre la connexion à Google SecOps

Les étapes suivantes décrivent comment attribuer un rôle spécifique à l'aide d'IAM afin que les groupes et les utilisateurs de votre pool d'identités des employés puissent se connecter à Google SecOps. Effectuez la configuration à l'aide du projet Google Cloud lié à Google SecOps que vous avez créé précédemment.

Console

  1. Dans la console Google Cloud , accédez à la page IAM.

    Accéder à IAM

  2. Sélectionnez le projet Google Cloud lié à Google SecOps.

  3. Dans l'onglet Afficher par compte principal, cliquez sur  Accorder l'accès.

  4. Dans la section Ajouter des comptes principaux, saisissez un identifiant de compte principal dans le champ Nouveaux comptes principaux.

    Exemple :

    • Pour ajouter toutes les identités gérées à l'aide du pool d'identités de personnel et du fournisseur d'employés que vous avez créés précédemment, saisissez ce qui suit :

      principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID

    • Pour ajouter un groupe spécifique en tant que principal, saisissez la commande suivante :

      principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/group/GROUP_ID

    Remplacez les éléments suivants :

    • WORKFORCE_POOL_ID : valeur que vous avez définie pour l'ID du pool d'identités d'employés.
    • GROUP_ID : groupe de la revendication google.groups mappée. Vous devez avoir créé ce groupe dans votre IdP.
  5. Dans la section Attribuer des rôles, sélectionnez ou recherchez un rôle d'API Chronicle applicable, tel que Lecteur de l'API Chronicle (roles/chronicle.viewer).

  6. Cliquez sur Enregistrer.

  7. Répétez les étapes 3 à 5 pour chaque compte principal auquel vous souhaitez attribuer des rôles.

gcloud

  1. Attribuez le rôle Lecteur de l'API Chronicle (roles/chronicle.viewer) aux utilisateurs ou aux groupes qui doivent avoir accès à l'application Google SecOps.

    • L'exemple suivant attribue le rôle de lecteur de l'API Chronicle aux identités gérées à l'aide du pool d'employés et du fournisseur d'employés que vous avez créés précédemment.
    gcloud projects add-iam-policy-binding PROJECT_ID \
      --role roles/chronicle.viewer \
      --member "principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/*"
    

    Remplacez les éléments suivants :

    • PROJECT_ID : ID du projet lié à Google SecOps que vous avez configuré dans Configurer un projet Google Cloud pour Google SecOps. Pour obtenir une description des champs qui identifient un projet, consultez Créer et gérer des projets.
    • WORKFORCE_POOL_ID : valeur que vous avez définie pour l'ID du pool d'identités d'employés.

    • Pour attribuer le rôle de lecteur de l'API Chronicle à un groupe spécifique, exécutez la commande suivante :

    gcloud projects add-iam-policy-binding PROJECT_ID \
      --role roles/chronicle.viewer \
      --member "principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/group/GROUP_ID"
    

    Remplacez GROUP_ID par le groupe de la revendication google.groups mappée Vous devez avoir créé ce groupe dans votre IdP.

  2. Configurez des stratégies IAM supplémentaires pour répondre aux exigences de votre organisation.

  3. Obligatoire : Pour terminer l'authentification et permettre aux utilisateurs d'accéder à la plate-forme Google SecOps, vous devez configurer l'accès utilisateur depuis le côté SOAR de Google SecOps. Pour en savoir plus, consultez Mapper les utilisateurs dans la plate-forme Google SecOps.

Répétez les étapes précédentes pour accorder d'autres rôles.

Configurer le SSO pour votre instance Google SecOps

La dernière tâche d'intégration de votre IdP tiers à Google SecOps consiste à configurer le SSO. Une fois cette étape terminée, les utilisateurs pourront se connecter à Google SecOps à l'aide de leurs identifiants IdP.

Voici les étapes à suivre pour configurer l'authentification unique :

  1. Dans la console Google Cloud , accédez à la page Sécurité > Google SecOps.
  2. Cliquez sur l'onglet Authentification unique, puis sélectionnez Fédération des identités des employés.
  3. Dans la liste des fournisseurs disponibles, sélectionnez le fournisseur de fédération des identités des employés que vous avez créé à l'étape Créer un fournisseur de pool d'identités des employés.
  4. Facultatif : Pour tester votre configuration SSO, cliquez sur Test SSO Setup (Tester la configuration SSO). Si la configuration réussit, vous serez redirigé vers l'écran de connexion de votre IdP.
  5. Cliquez sur Enregistrer.

Gérer la configuration de la fédération des identités des employés

Cette section explique comment mettre à jour les paramètres de votre fournisseur et vérifier que les niveaux d'accès des utilisateurs sont correctement configurés.

Vérifier ou configurer le contrôle des accès aux fonctionnalités Google SecOps

Si vous avez configuré la fédération des identités des employés avec des attributs ou des groupes mappés à l'attribut google.groups, ces informations sont transmises à Google SecOps afin que vous puissiez configurer le RBAC pour les fonctionnalités Google SecOps.

Si l'instance Google SecOps dispose d'une configuration RBAC existante, vérifiez que la configuration d'origine fonctionne comme prévu.

Si vous n'avez pas encore configuré le contrôle des accès, consultez Configurer le contrôle des accès aux fonctionnalités à l'aide d'IAM pour savoir comment contrôler l'accès aux fonctionnalités.

Modifier la configuration de la fédération des identités des employés

Si vous devez mettre à jour le pool d'identités de personnel ou le fournisseur de personnel, consultez Gérer les fournisseurs de pools d'identités de personnel pour savoir comment modifier la configuration.

La section Gestion des clés de la page Créer un fournisseur de pools d'employés SAML explique comment mettre à jour les clés de signature du fournisseur d'identité, puis comment mettre à jour la configuration du fournisseur d'employés avec le dernier fichier XML de métadonnées de l'application. Pour les fournisseurs OIDC, consultez Mettre à jour un fournisseur et Gérer les JWK OIDC.

Console

Pour mettre à jour un pool d'employés spécifique :

  1. Accédez à la page Pools d'identités de personnel:

    Accéder aux pools d'identités de personnel

  2. Dans le tableau, sélectionnez le pool.

  3. Mettez à jour les paramètres du pool.

  4. Cliquez sur Enregistrer le pool.

Pour mettre à jour un fournisseur, procédez comme suit :

  1. Accédez à la page Pools d'identités de personnel:

    Accéder aux pools d'identités de personnel

  2. Dans le tableau, sélectionnez le pool pour lequel vous souhaitez mettre à jour le fournisseur.

  3. Dans le tableau Fournisseurs, cliquez sur Modifier.

  4. Mettez à jour les informations du fournisseur.

  5. Pour enregistrer les informations mises à jour sur le fournisseur, cliquez sur Enregistrer.

gcloud

Voici un exemple de commande gcloud qui met à jour la configuration du fournisseur d'employés :

gcloud iam workforce-pools providers update-saml WORKFORCE_PROVIDER_ID \
  --workforce-pool=WORKFORCE_POOL_ID \
  --location="global" \
  --display-name="WORKFORCE_PROVIDER_DISPLAY_NAME" \
  --description="WORKFORCE_PROVIDER_DESCRIPTION" \
  --idp-metadata-path=PATH_TO_METADATA_XML \
  --attribute-mapping="ATTRIBUTE_MAPPINGS"

Remplacez les éléments suivants :

  • WORKFORCE_PROVIDER_ID : valeur que vous avez définie pour l'ID du fournisseur de personnel.
  • WORKFORCE_POOL_ID : valeur que vous avez définie pour l'ID du pool d'identités d'employés.
  • WORKFORCE_PROVIDER_DISPLAY_NAME : nom convivial pour le fournisseur de personnel. La valeur doit comporter moins de 32 caractères.
  • WORKFORCE_PROVIDER_DESCRIPTION : description du fournisseur de personnel.
  • PATH_TO_METADATA_XML : emplacement du fichier XML de métadonnées de l'application mis à jour, par exemple /path/to/sso_metadata_updated.xml.
  • ATTRIBUTE_MAPPINGS : attributs d'assertion mappés aux attributsGoogle Cloud . Exemple :

google.subject=assertion.subject,google.display_name=assertion.attributes.name[0],google.groups=assertion.attributes.memberOf

Résoudre les problèmes de configuration

Si vous rencontrez des erreurs au cours de ce processus, consultez Résoudre les problèmes liés à la fédération des identités des employés pour résoudre les problèmes courants. Si votre organisation utilise des pare-feu ou des proxys Web, vérifiez que votre liste d'autorisation réseau inclut les domaines d'authentification et de fédération des identités des employés requis, tels que auth.backstory.chronicle.security, iam.googleapis.com, accounts.google.com et les domaines régionaux accounts.google.ccTLD. Pour en savoir plus, consultez Accès réseau et liste d'autorisation de domaines. La section suivante fournit des informations sur les problèmes courants rencontrés lors de l'exécution des étapes de ce document.

Si vous rencontrez toujours des problèmes, contactez votre représentant Google SecOps et fournissez votre fichier journal réseau Chrome.

Commande introuvable

  • Lorsque vous créez un fournisseur de pool d'identités de personnel et que vous spécifiez les détails de l'IdP, l'erreur suivante s'affiche :

    Error: bash: --attribute-mapping=google.subject=assertion.subject,
    google.display_name=assertion.attributes.name[0],
    google.groups=assertion.attributes.groups: command not found
    

Vérifiez que PATH_TO_METADATA_XML est l'emplacement où vous avez importé le fichier XML de métadonnées de l'application SAML dans votre répertoire d'accueil Cloud Shell.

L'appelant n'a pas l'autorisation requise

  • Lorsque vous exécutez la commande gcloud projects add-iam-policy-binding pour attribuer des rôles à des utilisateurs ou à des groupes, l'erreur suivante s'affiche :

    ERROR: (gcloud.organizations.add-iam-policy-binding) User [ ] does not have
    permission to access organizations instance [538073083963:getIamPolicy]
    (or it may not exist): The caller does not have permission
    

Vérifiez que vous disposez des autorisations requises. Pour en savoir plus, consultez la section Rôles requis.

Échec de la validation : ID de session manquant dans la requête

  • Lorsque vous essayez de vous authentifier, l'erreur suivante s'affiche dans le navigateur :

    Verification failure: missing session ID in request
    

Vérifiez que les URL de base de l'ACS et de l'ID d'entité sont correctes. Pour en savoir plus, consultez Configurer l'application IdP.

Déboguer votre jeton IdP

Vous pouvez utiliser la fonctionnalité Déboguer le jeton IdP dans la fédération des identités des employés pour vérifier que votre fournisseur d'identité transmet les attributs et les revendications appropriés. Nous vous recommandons vivement de le faire avant que les utilisateurs ne tentent de se connecter à Google SecOps, car cela peut aider à éviter les erreurs de connexion et de mappage d'attributs.

Pour déboguer votre jeton :

  1. Dans la console Google Cloud , accédez à Fédération des identités des employés.
  2. Sélectionnez votre pool, puis votre fournisseur.
  3. Cliquez sur Déboguer le jeton IdP.

Pour obtenir un guide détaillé sur l'utilisation de cette fonctionnalité pour valider votre configuration, consultez le guide de validation avant migration.

Déboguer un jeton JWT de plus de 4 ko

Si vous rencontrez des problèmes pour vous connecter à Google SecOps, assurez-vous que vos jetons Web JSON (JWT) ne dépassent pas la limite de 4 Ko pour Google SecOps. Si un utilisateur reçoit un message d'erreur indiquant "Authentication JWT larger than 4KB. Réduisez les données d'appartenance au groupe envoyées par l'IdP pour résoudre cette erreur.", suivez ces étapes de dépannage :

  1. Déboguer votre jeton : vous pouvez déboguer votre jeton sur la page d'informations du fournisseur dans la fédération des identités des employés (en accédant à Fédération des identités des employés > Pools d'employés > POOL_NAME > PROVIDER_NAME et en cliquant sur Déboguer le jeton IdP). Pour utiliser cette fonctionnalité, vous devez d'abord ajouter l'URL Google Cloud aux URL de redirection de votre fournisseur d'identité. Cela s'applique aux protocoles SAML et OIDC. Pour en savoir plus, consultez Résoudre les problèmes liés à la fédération des identités des employés.
  2. Filtrer les revendications de groupes : si votre fournisseur d'identité envoie de nombreux groupes sans rapport avec Google SecOps, filtrez la revendication de groupes au niveau de votre fournisseur. En configurant votre fournisseur externe pour qu'il n'envoie que l'ensemble minimal de groupes requis pour Google SecOps, vous réduisez la taille du JWT et évitez les erreurs d'authentification.

    • Exemple (Microsoft Entra ID) : vous pouvez utiliser le filtrage de groupes Microsoft Entra pour n'envoyer qu'un ensemble minimal de groupes pertinents. Dans votre application d'entreprise Entra, sous "Authentification unique", modifiez la revendication Groupes pour appliquer un filtre (par exemple, à l'aide d'une correspondance de préfixe) afin que seuls les groupes requis soient envoyés à Google SecOps. Pour en savoir plus, consultez Filtrage des groupes Microsoft Entra.

Étapes suivantes

Après avoir suivi les étapes de ce document, procédez comme suit :

Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.