Migrer l'infrastructure d'authentification de l'agent distant

Compatible avec :

Google SecOps SOAR

Ce document explique comment migrer votre infrastructure d'agents à distance à l'aide de comptes de service Google Cloud . Cette migration ne concerne que l'infrastructure d'authentification. Vous n'êtes pas obligé de migrer ni de remplacer vos instances ou hôtes d'agent à distance.

Authentification sans clé : pour configurer l'authentification sans clé pour les agents à distance sans stocker les fichiers de clé JSON du compte de service sur les machines hôtes, consultez Authentifier l'agent à distance avec la fédération d'identité de charge de travail.

Avant de commencer

Assurez-vous de disposer des éléments suivants :

• Autorisations nécessaires pour créer des comptes de service dans Google Cloud.
• Rôles requis pour créer des clés de compte de service.
• Version minimale requise de l'agent à distance : 2.6.2 ou ultérieure.

Créer un compte de service

Un compte de service est un type particulier de compte Google utilisé par une application pour effectuer des appels d'API autorisés.

Important : Attribuez un compte de service unique à chaque agent distant. Étant donné que les comptes de service sont soumis à des quotas et des limites de débit d'API individuels, le fait de partager un compte de service entre plusieurs agents peut épuiser les quotas et entraîner des échecs de communication.

Pour créer un compte de service, procédez comme suit :

1. Dans la console Google Cloud , accédez à la page Comptes de service.
Accéder à la page "Comptes de service"
2. Cliquez sur Créer un compte de service.
3. Dans la section Détails du compte de service, procédez comme suit :
   1. Saisissez un nom pour le compte de service.
   2. Saisissez une description pour le compte de service.
   3. Cliquez sur Créer et continuer.
4. Dans la section Autorisations, procédez comme suit :
   1. Dans la liste Sélectionner un rôle, sélectionnez le rôle Agent distant Chronicle SOAR.
   2. Cliquez sur Continuer.
5. Dans la section Autoriser les utilisateurs à accéder à ce compte de service, cliquez sur OK.

Créer une clé de compte de service

La clé du compte de service est requise pour authentifier l'agent distant. Pour créer cette clé, procédez comme suit :

1. Dans la console Google Cloud , accédez à la page Comptes de service.
Accéder à la page "Comptes de service"
2. Cliquez sur le nom du compte de service que vous avez créé.
3. Cliquez sur l'onglet Clés.
4. Cliquez sur Ajouter une clé> Créer une clé.
5. Sélectionnez le type de clé JSON, puis cliquez sur Créer.

   A JSON file containing the key is downloaded to your computer.
   

6. Cliquez sur Fermer.

Stocker le fichier de clé de manière sécurisée

Après avoir téléchargé la clé du compte de service, vous devez la déplacer vers la machine hôte sur laquelle l'agent à distance s'exécutera.

Avertissement : N'effectuez pas de commit de ce fichier de clé vers votre dépôt de code source. Traitez-le comme un mot de passe confidentiel.

Podman

1. Recherchez le fichier JSON téléchargé sur votre ordinateur.
2. Stockez le fichier dans un emplacement sécurisé sur la machine hôte où le processus de l'agent peut y accéder.
3. Saisissez le chemin d'accès complet à la clé du compte de service de votre agent sur la machine hôte.

   AGENT_SERVICE_ACCOUNT_PATH

Docker

1. Recherchez le fichier JSON téléchargé sur votre ordinateur.
2. Stockez le fichier dans un emplacement sécurisé sur la machine hôte où le processus de l'agent peut y accéder.
3. Saisissez le chemin d'accès complet à la clé du compte de service de votre agent sur la machine hôte.

   AGENT_SERVICE_ACCOUNT_PATH

Installateur

1. Recherchez le fichier JSON téléchargé sur votre ordinateur.
2. Stockez le fichier à l'emplacement suivant :

   AGENT_SERVICE_ACCOUNT_PATH

3. Notez le chemin d'accès complet à ce fichier, car vous en aurez besoin pour configurer l'agent distant.

Mapper le compte de service de l'agent distant

Après avoir créé le compte de service pour votre agent distant, vous devez l'autoriser dans la plate-forme pour vous assurer qu'il peut communiquer avec Google SecOps.

Pour accorder l'accès à un compte de service ou l'accès à la fédération d'identité de charge de travail à Google SecOps, vous devez mapper l'identité aux paramètres de contrôle des accès de la plate-forme. Ce mappage est une étape obligatoire pour fournir à l'identité l'accès nécessaire aux rôles SOC et aux environnements requis pour effectuer des tâches automatisées ou des opérations d'API.

1. Accédez à Paramètres SOAR > Avancé > Mappage de groupe.
2. Cliquez sur Ajouter Ajouter.

3. Remplissez les champs de la boîte de dialogue Ajouter un mappage pour mapper l'identité aux paramètres de contrôle des accès de la plate-forme.

   1. Dans le champ IdP / User group (IdP/Groupe d'utilisateurs), saisissez l'une des valeurs suivantes :
      • Adresse e-mail complète de votre compte de service, si l'identité a été configurée à l'aide de Cloud Identity.
      • Chaîne principale Workload Identity, si l'identité a été configurée à l'aide de la fédération d'identité de personnel.

   2. Configurez les champs de contrôle des accès suivants :

      Champ	Description
      Groupes d'autorisations	Sélectionnez les groupes d'autorisations pour définir les modules et sous-modules auxquels l'identité peut accéder.
      Rôles SOC	Sélectionnez les rôles SOC pour définir le rôle de l'identité (par exemple, "Niveau 1").
      Environnements	Sélectionnez les environnements ou les groupes d'environnements auxquels l'identité peut accéder (par exemple, Tous les environnements).
      Membres du groupe	Saisissez les adresses e-mail des utilisateurs requis, le cas échéant. Appuyez sur Entrée après avoir ajouté chaque adresse e-mail.
      Actions limitées	Sélectionnez les actions restreintes pour limiter des opérations spécifiques dans les modules.

4. Cliquez sur Ajouter.

Configurer l'authentification de l'agent distant sur Google Cloud

Podman

Si vous déployez un nouvel agent, consultez Déployer un agent avec Podman.

Si vous mettez à niveau un agent, consultez Mettre à niveau un agent avec Podman.

Docker

Si vous déployez un nouvel agent, consultez Déployer un agent avec Docker.

Si vous mettez à niveau un agent, consultez Mettre à niveau un agent avec Docker.

Installateur

Si vous déployez un nouvel agent, consultez Déployer un agent avec CentOS ou Déployer un agent avec RHEL.

Si vous mettez à niveau un agent, consultez Mettre à niveau un agent avec CentOS ou Mettre à niveau un agent avec RHEL .

Migrer les variables d'environnement d'un agent existant

Remarque : Vous pouvez ignorer cette étape pour les agents à distance installés après le 10 mai 2026, car les variables d'environnement sont présentes dans le fichier de commande du conteneur/.env.

Accédez à Paramètres SOAR> Avancé> Agents à distance, puis cliquez sur Afficher plus sur l'agent à distance requis.

Copiez les valeurs suivantes du champ Commande Docker et collez-les dans les commandes suivantes.
Vous les utiliserez dans la procédure de migration :

• ONE PLATFORM URL DOMAIN.

  ONE_PLATFORM_URL_DOMAIN

• ONE PLATFORM URL PROJECT

  ONE_PLATFORM_URL_PROJECT

• ONE PLATFORM URL LOCATION

  ONE_PLATFORM_URL_LOCATION

• ONE PLATFORM URL INSTANCE.

  ONE_PLATFORM_URL_INSTANCE

Podman

Pour migrer les variables d'environnement de l'agent à distance, procédez comme suit :

1. Répertoriez les conteneurs Podman en cours d'exécution.

   podman ps

2. Saisissez l'ID de conteneur de votre agent :

   CONTAINER_ID

3. Collez les variables d'environnement suivantes issues des procédures précédentes, puis exécutez cette commande :

   podman exec CONTAINER_ID sh -c 'printf "export ONE_PLATFORM_URL_DOMAIN=ONE_PLATFORM_URL_DOMAIN\nexport ONE_PLATFORM_URL_PROJECT=ONE_PLATFORM_URL_PROJECT\nexport ONE_PLATFORM_URL_LOCATION=ONE_PLATFORM_URL_LOCATION\nexport ONE_PLATFORM_URL_INSTANCE=ONE_PLATFORM_URL_INSTANCE\nexport GOOGLE_APPLICATION_CREDENTIALS=/opt/SiemplifyAgent/agent-key.json" >> /home/siemplify_agent/.bash_profile'

Docker

Pour migrer les variables d'environnement de l'agent à distance, procédez comme suit :

1. Répertoriez les conteneurs Docker en cours d'exécution.

   docker ps

2. Saisissez l'ID de conteneur de votre agent :

   CONTAINER_ID

3. Collez les variables d'environnement suivantes issues des procédures précédentes, puis exécutez cette commande :

   docker exec CONTAINER_ID sh -c 'printf "export ONE_PLATFORM_URL_DOMAIN=ONE_PLATFORM_URL_DOMAIN\nexport ONE_PLATFORM_URL_PROJECT=ONE_PLATFORM_URL_PROJECT\nexport ONE_PLATFORM_URL_LOCATION=ONE_PLATFORM_URL_LOCATION\nexport ONE_PLATFORM_URL_INSTANCE=ONE_PLATFORM_URL_INSTANCE\nexport GOOGLE_APPLICATION_CREDENTIALS=/opt/SiemplifyAgent/agent-key.json" >> /home/siemplify_agent/.bash_profile'

Installateur

Pour migrer les variables d'environnement de l'agent distant, procédez comme suit :

Collez les variables d'environnement suivantes issues des procédures précédentes et exécutez cette commande :

cat << EOF >> /home/siemplify_agent/.bash_profile
export ONE_PLATFORM_URL_DOMAIN=ONE_PLATFORM_URL_DOMAIN
export ONE_PLATFORM_URL_PROJECT=ONE_PLATFORM_URL_PROJECT
export ONE_PLATFORM_URL_LOCATION=ONE_PLATFORM_URL_LOCATION
export ONE_PLATFORM_URL_INSTANCE=ONE_PLATFORM_URL_INSTANCE
export GOOGLE_APPLICATION_CREDENTIALS=/opt/SiemplifyAgent/agent-key.json
EOF

Migrer le compte de service vers l'agent distant

Une fois cette étape terminée et toutes les variables d'environnement présentes dans l'agent distant, la migration est terminée et l'agent distant communique via Google Cloud .

Podman

Pour migrer l'infrastructure d'authentification de l'agent à distance, procédez comme suit :

1. Répertoriez les conteneurs Podman en cours d'exécution.

   podman ps

2. Saisissez l'ID de conteneur de votre agent :

   CONTAINER_ID

3. Utilisez la commande suivante pour copier la clé du compte de service dans un chemin d'accès dédié du conteneur.

   podman cp AGENT_SERVICE_ACCOUNT_PATH CONTAINER_ID:/opt/SiemplifyAgent/agent-key.json

4. Utilisez la commande suivante pour modifier le propriétaire de la clé du compte de service dans le conteneur :

   podman exec -u 0 CONTAINER_ID chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json

5. Exécutez la commande suivante pour appliquer les modifications :

   podman restart CONTAINER_ID

Docker

Pour migrer l'infrastructure d'authentification de l'agent à distance, procédez comme suit :

1. Répertoriez les conteneurs Docker en cours d'exécution.

   docker ps

2. Saisissez l'ID de conteneur de votre agent :

   CONTAINER_ID

3. Utilisez la commande suivante pour copier la clé du compte de service dans un chemin d'accès dédié du conteneur.

   docker cp AGENT_SERVICE_ACCOUNT_PATH CONTAINER_ID:/opt/SiemplifyAgent/agent-key.json

4. Utilisez la commande suivante pour modifier le propriétaire de la clé du compte de service dans le conteneur :

   docker exec -u 0 CONTAINER_ID chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json

5. Exécutez la commande suivante pour appliquer les modifications :

   docker restart CONTAINER_ID

Installateur

Pour migrer l'infrastructure d'authentification de l'agent distant, procédez comme suit :

1. Déplacez le compte de service vers le chemin d'accès attendu.

   mv AGENT_SERVICE_ACCOUNT_PATH /opt/SiemplifyAgent/agent-key.json

2. Utilisez la commande suivante pour modifier le propriétaire de la clé de compte de service dans le conteneur :

   chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json

3. Exécutez la commande suivante pour redémarrer le service de l'agent :

   supervisorctl restart siemplify_agent

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