Guide de validation préalable à la migration

Compatible avec :

Ce document décrit une approche de diagnostic systématique et par étapes pour valider l'instance Google Security Operations et la configuration de l'authentification avant la migration SOAR. Ce guide se concentre sur les normes SAML et OIDC utilisées pour l'authentification et l'autorisation des utilisateurs.

Validation de la configuration de l'API Chronicle

Pour vérifier si l'API Chronicle est correctement configurée dans votre projet Google Cloud , procédez comme suit :

  1. Connectez-vous à la consoleGoogle Cloud et sélectionnez le projet Google Cloud approprié dans la liste des projets de la barre de navigation supérieure.
  2. Ouvrez le menu de navigation (≡) et accédez à API et services > API et services activés.
  3. Accédez à la liste des API et services activés pour trouver Chronicle API.
  4. Si elle est listée, l'API est activée.

    Si elle n'est PAS listée : cliquez sur + ACTIVER LES API ET LES SERVICES en haut de la page, recherchez Chronicle API, puis cliquez sur Activer.

Pour vérifier si le compte de service a été créé, procédez comme suit :

  1. Accédez à la page IAM dans la console Google Cloud .
  2. Afficher les comptes masqués (étape cruciale) : vous devez cocher la case Inclure les attributions de rôles fournies par Google située à droite de la barre de filtre.
  3. Recherchez l'agent : dans la barre de filtre, saisissez chronicle. Vous recherchez une adresse e-mail correspondant à ce format spécifique : service-[PROJECT_NUMBER]@gcp-sa-chronicle.iam.gserviceaccount.com.
  4. Vérifier les autorisations : assurez-vous qu'il dispose du rôle Agent de service Chronicle. Si le rôle est manquant, cliquez sur edit Modifier et ajoutez-le à nouveau.

Validation de la configuration de Google SecOps

  1. Dans la console Google Cloud , sélectionnez le projet Google Cloud approprié dans la liste.
  2. Accédez à Sécurité > Google SecOps. L'onglet Authentification unique s'affiche.
  3. Si Google SecOps est activé, un onglet intitulé Authentification unique doit s'afficher. Si ce n'est pas le cas, l'initiation du prospect est incomplète. Indiquez l'ID du projet Google Cloud dans le formulaire Google Forms accessible via la notification dans le produit. Confirmez la date et le créneau horaire de la migration, puis envoyez le formulaire. Si vous ne recevez pas de réponse dans les 72 heures suivant l'envoi, contactez soar-migration-to-gcom@google.com.
  4. Si l'onglet existe, cliquez sur Accéder à SecOps. Une connexion réussie confirme que la configuration de l'authentification est correcte. Si la connexion échoue, vérifiez que votre pare-feu ou votre proxy autorise les domaines de la liste d'autorisation des accès réseau et des domaines. Si le problème persiste, passez à la section suivante pour déboguer la configuration.

Flux SAML et dépannage

Cette section présente le processus d'authentification SAML et décrit une approche systématique pour diagnostiquer et résoudre les problèmes de configuration courants.

Architecture du workflow d'authentification

Il est essentiel de comprendre le flux de requêtes pour isoler les points de défaillance. Le diagramme suivant illustre le cheminement séquentiel d'une connexion réussie.

Architecture du workflow d'authentification

Procédure de dépannage étape par étape

Pour diagnostiquer et tracer efficacement le processus d'authentification SAML, vous pouvez utiliser les utilitaires Web listés dans les sections suivantes.

Bien que Google ne recommande aucun produit en particulier, les outils suivants sont connus pour faciliter le processus de dépannage :

  • Validation SAML : samltool.io
    • Objectif : décoder et valider les requêtes et réponses SAML brutes.
  • Inspection JWT : jwt.io
    • Objectif : permet d'inspecter les revendications et le contenu des jetons Web JSON (JWT).

Phase 1 : Préparation de l'environnement

Avant de commencer, assurez-vous que votre environnement de navigateur est prêt à capturer le trafic réseau en procédant comme suit :

  1. Ouvrez un nouvel onglet dans votre navigateur ou utilisez une fenêtre de navigation privée.
  2. Ouvrez les outils pour les développeurs à l'aide du raccourci correspondant à votre système d'exploitation :

    • Windows : appuyez sur F12.
    • Linux : appuyez sur Ctrl+Maj+I.
    • macOS : appuyez sur Cmd+Option+I.
  3. Accédez à l'onglet Réseau.

  4. Cochez la case Conserver le journal pour vous assurer qu'aucune donnée n'est perdue lors des redirections.

    Conserver le journal

  5. Accédez à l'URL de votre environnement Google SecOps pour lancer le processus de connexion. Vous recevrez cette URL par e-mail une fois que vous aurez terminé la configuration de Google SecOps à l'étape 5 de la phase 1 de la migration pour les clients SOAR autonomes. L'objet de l'e-mail est Your Google SecOps instance is ready.

Phase 2 : Valider la requête SAML auprès du fournisseur d'identité

Cette étape permet de vérifier le message initial envoyé par Google Cloud à votre fournisseur d'identité (IdP).

  1. Localisez la requête : dans la barre de filtre de l'onglet Réseau, recherchez saml.

    Localiser la requête

  2. Extraire les données : sélectionnez la requête, puis cliquez sur l'onglet Payload (Charge utile). Recherchez le paramètre de chaîne de requête intitulé SAMLRequest.

    Extraire les données

  3. Décodage : copiez la valeur de la requête et collez-la dans l'outil de validation SAML (samltool.io) pour la décoder.

    Decode

  4. Validation :

    • Vérifiez la destination de la requête.
    • Vérifiez que cette URL correspond aux paramètres de configuration de votre IdP.

Phase 3 : Valider la réponse SAML du fournisseur d'identité

Cette étape permet de vérifier les attributs renvoyés par le fournisseur d'identité à Google Cloud après l'authentification.

  1. Localisez la réponse : dans la barre de filtre de l'onglet Réseau, recherchez signin-callback.

    Localiser la réponse

  2. Extraire les données : sélectionnez la requête, puis cliquez sur l'onglet Payload (Charge utile). Recherchez les données SAMLResponse.

    Localiser les données de la réponse SAML

  3. Décoder : copiez la valeur de la réponse et collez-la dans l'outil de validation SAML.

  4. Validation :

    • Examinez les revendications (attributs) renvoyées, telles que groups, first name, last name et email.
    • Important : Assurez-vous que ces attributs correspondent à la configuration des paramètres du pool d'employés dans Google Cloud.
    • Vérifiez que les valeurs sont correctes pour l'utilisateur qui tente de se connecter.

      Paramètres du pool d'employés

L'image suivante montre un mappage d'attributs :

attribute-mapping

Le mappage dans l'image est le suivant :

  • google.subject = assertion.subject
  • attribute.last_name = assertion.attributes.last_name[0]
  • attribute.user_email = assertion.attributes.user_email[0]
  • attribute.first_name = assertion.attributes.first_name[0]
  • google.groups = assertion.attributes.groups

La partie gauche est toujours la même : il s'agit de la syntaxe Google. La partie droite correspond aux clés d'attribut de revendication affichées dans la réponse SAML.

Le [0] est essentiel pour les attributs spécifiques indiqués (last_name, user_email , first_name), mais n'est pas pertinent pour subject et groups.

Phase 4 : Valider l'authentification Google SecOps

Cette étape vérifie si Google Cloud authentifie l'utilisateur pour qu'il se connecte à Google SecOps SOAR.

  1. Localisez le jeton dans le navigateur de l'utilisateur : dans la barre de filtre de l'onglet Réseau, recherchez le point de terminaison auth/siem.

    Localiser le jeton dans le navigateur de l'utilisateur

  2. Extraire les données : sélectionnez la requête et affichez l'onglet Charge utile. Recherchez la chaîne jwt.

  3. Décoder : copiez la chaîne JWT et collez-la dans l'outil d'inspection JWT (jwt.io).

    Copiez la chaîne JWT et collez-la

  4. Validation :

    • Comparez les revendications décodées pour given_name, family_name, email et idpgroups.
    • Confirmation de correspondance : ces valeurs doivent correspondre exactement aux attributs validés à l'étape 3 (Réponse SAML).
    • Si les valeurs correspondent et que vous n'avez toujours pas accès, vérifiez l'attribution des rôles dans IAM. Assurez-vous que tous vos utilisateurs se voient attribuer l'un des rôles Chronicle prédéfinis en utilisant le format de compte principal approprié pour votre configuration d'identité (fédération des identités des employés ou Cloud Identity pour les comptes gérés par Google).

Phase 5 : Valider l'accès aux autorisations SOAR

Cette étape permet de confirmer que le système attribue correctement les autorisations dans SOAR via la page Mappage de groupe de la plate-forme.

Les administrateurs accèdent automatiquement à SOAR, car la page Mappage de groupe active l'accès par défaut.

Vous pouvez valider l'accès au groupe pour vos utilisateurs en ajoutant quelques mappages de groupes IDP dans cette nouvelle instance SOAR. Par défaut, les nouvelles instances ont une page Mappage de groupes vide. Pour valider l'accès au groupe pour d'autres utilisateurs, ajoutez des mappages de groupes IDP à la nouvelle instance SOAR en procédant comme suit :

  1. Copiez les mappages de groupes depuis la page Mappages de groupes de votre instance SOAR existante.
  2. Demandez à un utilisateur du groupe IdP d'accéder à la nouvelle URL Google SecOps.
  3. Si l'utilisateur ne peut pas accéder à SOAR, suivez ces étapes de dépannage :

    a. Inspectez la réponse : ouvrez la requête auth/siem de la phase 4 et sélectionnez l'onglet Aperçu.

    b. Vérifier les autorisations : recherchez l'objet permissions dans la réponse JSON.

Facultatif : Pour gagner du temps, copiez ces mappages dans votre instance Google SecOps existante sous Paramètres > Avancé > Mappage de groupes.

Flux OIDC et dépannage

Cette section présente le processus d'authentification OIDC et décrit une approche systématique pour diagnostiquer et résoudre les problèmes d'intégration courants.

Architecture du workflow d'authentification

Il est essentiel de comprendre le flux de requêtes pour isoler les points de défaillance. Le diagramme suivant illustre le cheminement séquentiel d'une connexion réussie.

Architecture du workflow d'authentification

Procédure de dépannage OIDC étape par étape

Pour diagnostiquer et tracer efficacement le processus d'authentification OIDC, vous pouvez utiliser les outils pour les développeurs du navigateur et des décodeurs JWT en ligne.

  • Inspection des jetons JWT : jwt.io
    • Objectif : permet d'inspecter les revendications et le contenu des jetons Web JSON (JWT).

Phase 1 : Préparation de l'environnement

Avant de commencer, assurez-vous que votre environnement de navigateur est prêt à capturer le réseau en procédant comme suit :

  1. Ouvrez un nouvel onglet vide dans votre navigateur ou une fenêtre de navigation privée.
  2. Ouvrez les outils pour les développeurs à l'aide du raccourci correspondant à votre système d'exploitation :

    • Windows : appuyez sur F12.
    • Linux : appuyez sur Ctrl+Maj+I.
    • macOS : appuyez sur Cmd+Option+I.
  3. Accédez à l'onglet Réseau.

  4. Cochez la case Conserver le journal pour vous assurer qu'aucune donnée n'est perdue lors des redirections.

    Conserver le journal

  5. Accédez à l'URL de votre environnement Google SecOps pour lancer le processus de connexion. Vous recevrez cette URL par e-mail une fois que vous aurez terminé la configuration de Google SecOps à l'étape 5 de la phase 1 de la migration pour les clients SOAR autonomes. L'objet de l'e-mail est YourGoogle SecOps instance is ready.

Phase 2 : Valider la demande d'autorisation auprès d'un fournisseur OIDC

Cette étape vérifie la redirection initiale de Google Cloud vers votre fournisseur OpenID Connect (IdP).

  1. Localisez la requête : dans l'onglet Réseau, recherchez la redirection initiale vers le point de terminaison d'autorisation de votre fournisseur OIDC. L'URL contient généralement des paramètres tels que client_id, redirect_uri, scope, response_type et state.

    Localiser la requête

  2. Validation :

    • Vérifiez que l'client_id correspond à celui configuré dans votre fournisseur OIDC.
    • Assurez-vous que redirect_uri correspond exactement à https://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/POOL_ID/provider/PROVIDER_ID, en remplaçant POOL_ID et PROVIDER_ID par votre pool et votre fournisseur de la fédération d'identité de personnel.
    • Vérifiez que response_type est défini sur "code".
    • Notez le paramètre de niveau d'accès, qui doit inclure openid et tous les autres niveaux d'accès requis pour publier les revendications nécessaires (par exemple, e-mail, profil).

Phase 3 : Valider le rappel et l'échange de jetons

Cette étape vérifie la réponse du fournisseur d'identité à Google Cloud.

  1. Localisez le rappel : dans l'onglet Réseau, recherchez la requête envoyée à l'URL de rappel de connexion (.../signin-callback/...).

    Localiser le rappel

  2. Vérifier les données : vérifiez les paramètres d'URL de cette requête. Il doit contenir un paramètre de code fourni par votre IdP OIDC.

  3. En coulisses : la fédération d'identité des employés échange ce code contre des jetons (jeton d'ID, jeton d'accès) provenant du point de terminaison de jeton du fournisseur OIDC. Les erreurs à ce stade sont souvent visibles dans Cloud Logging pour la fédération des identités des employés.

    • Vérifier la propagation des attributs et le jeton complet : pour vérifier que le mappage d'attributs dans la fédération des identités des employés produit les résultats attendus :
      • Ajoutez l'URI de redirection, fourni dans la configuration du fournisseur de la fédération des identités des employés, aux URI de redirection de votre fournisseur (par exemple, https://auth.cloud.google/signin-callback/locations/global/workforcePools/POOL_ID/providers/PROVIDER_ID).
      • Accédez à votre fournisseur de fédération des identités des employés pour déboguer le jeton IdP. Vous pouvez également vérifier le jeton complet. Pour en savoir plus, consultez Vérifier la configuration de votre produit.

    Afficher le jeton complet Valider les attributs

Phase 4 : Valider l'authentification Google SecOps

Cette étape vérifie si Google Cloud authentifie l'utilisateur pour qu'il se connecte à Google SecOps SOAR.

  1. Localisez le jeton dans le navigateur de l'utilisateur : dans la barre de filtre de l'onglet Réseau, recherchez le point de terminaison auth/siem.

    Localiser le jeton dans le navigateur de l'utilisateur

  2. Extraire les données : sélectionnez la requête et affichez l'onglet Charge utile. Recherchez la chaîne jwt.

  3. Décoder : copiez la chaîne JWT et collez-la dans l'outil d'inspection JWT (jwt.io).

    Copiez la chaîne JWT et collez-la

  4. Validation :

    • Comparez les revendications décodées pour sub, given_name, family_name, email et idpgroups.
    • Confirmation de correspondance : ces valeurs doivent correspondre aux attributs publiés par votre fournisseur OIDC et à la façon dont ils sont mappés dans les mappages d'attributs de la fédération d'identité de personnel. Par exemple, attribute.first_name dans Google Cloud doit correspondre à given_name dans le jeton JWT.
    • Rôles IAM : si les revendications sont correctes, mais que l'accès est refusé avec un message tel que Cannot Authenticate user, because user does not have access to the GCP project...,, vérifiez les attributions de rôles IAM. Assurez-vous que les groupes de l'utilisateur (idp_groups dans le jeton JWT) disposent des rôles nécessaires au format principalSet approprié (par exemple, principalSet://iam.googleapis.com/locations/global/workforcePools/POOL_ID/group/IDP_GROUP_NAME).

Phase 5 : Valider l'accès aux autorisations SOAR

Cette étape permet de confirmer que le système attribue correctement les autorisations dans SOAR via la page Mappage de groupe de la plate-forme.

Les administrateurs accèdent automatiquement à SOAR, car la page Mappage de groupe active l'accès par défaut.

Vous pouvez valider l'accès au groupe pour vos utilisateurs en ajoutant quelques mappages de groupes IDP dans cette nouvelle instance SOAR. Par défaut, les nouvelles instances ont une page Mappage de groupes vide. Pour valider l'accès au groupe pour d'autres utilisateurs, ajoutez des mappages de groupes IDP à la nouvelle instance SOAR en procédant comme suit :

  1. Copiez les mappages de groupes depuis la page Mappages de groupes de votre instance SOAR existante.
  2. Demandez à un utilisateur du groupe IdP d'accéder à la nouvelle URL Google SecOps.
  3. Si l'utilisateur ne peut pas accéder à SOAR, suivez ces étapes de dépannage :

    a. Inspectez la réponse : ouvrez la requête auth/siem de la phase 4 et sélectionnez l'onglet Aperçu.

    b. Vérifier les autorisations : recherchez l'objet permissions dans la réponse JSON.

Facultatif : Pour gagner du temps, copiez ces mappages dans votre instance Google SecOps existante sous Paramètres > Avancé > Mappage de groupes.

Erreurs OIDC courantes :

  • invalid_redirect_uri de l'IdP : assurez-vous que l'URI de redirection configuré dans votre IdP correspond exactement à https://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/POOL_ID/provider/PROVIDER_ID, en remplaçant POOL_ID et PROVIDER_ID par votre pool et votre fournisseur de la fédération d'identité de personnel. Même une barre oblique finale ou une différence entre http et https peut déclencher cette erreur.
  • Revendications manquantes dans le jeton JWT :

    1. Côté IdP : vérifiez que le client OIDC est configuré pour libérer les revendications requises (mappées dans la fédération d'identité de charge de travail, telles que sub, groups, email, given_name, family_name) dans le jeton d'ID.

    2. Côté WIF : assurez-vous que ces revendications entrantes sont correctement mappées dans la section "Mappage d'attributs WIF" (par exemple, google.groups=assertion.groups). Si une revendication est présente dans le jeton, mais n'est pas mappée dans WIF, la plate-forme SOAR peut ne pas autoriser l'utilisateur. Pour vérifier que votre mappage d'attributs produit les résultats attendus, consultez Vérifier la configuration de votre fournisseur.

Mappages de groupes après la migration

Le mappage de groupes reste crucial dans Google SecOps une fois la migration terminée

Après la migration, l'instance migrée conserve les mappages de groupes. Ils servent de base pour déterminer l'accès des utilisateurs à SOAR. Vous devez vous assurer que chaque utilisateur est mappé sur cette page pour pouvoir accéder à Google SecOps. Pour en savoir plus, consultez Accéder à une instance.

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