Authentifier l'agent distant avec la fédération d'identité de charge de travail
Ce document explique comment configurer l'authentification sans clé pour les agents distants Google SecOps à l'aide de la fédération d'identité de charge de travail (WIF). La fédération d'identité de charge de travail élimine le besoin de télécharger, de gérer et de stocker des fichiers de clé JSON de compte de service de longue durée sur des environnements hôtes d'agents distants.
Avec la fédération d'identité de charge de travail, les agents distants exécutés sur des fournisseurs de services cloud externes, une infrastructure sur site, des clusters Kubernetes ou des pipelines de CI/CD utilisent des jetons d'accès fédérés Google Cloud de courte durée dérivés de leur fournisseur d'identité externe.
Avant de commencer
Avant de configurer la fédération d'identité de charge de travail, vérifiez les conditions préalables suivantes :
- Version minimale de l'agent distant : 2.6.2 ou ultérieure.
- L'utilisateur qui configure la fédération d'identité de charge de travail doit disposer des autorisations IAM requises dans Google Cloud pour créer et gérer des pools d'identités de charge de travail (
roles/iam.workloadIdentityPoolAdmin) et des comptes de service (roles/iam.serviceAccountAdmin). - Un compte de service dédié créé dans Google Cloud avec le rôle Agent distant Chronicle SOAR (
roles/chronicle.soarRemoteAgent). Pour savoir comment créer un compte de service, consultez Créer un compte de service. - Accès à votre fournisseur d'identité externe (AWS, Azure, Active Directory/ADFS, Kubernetes, pipeline CI/CD, CA X.509 ou fournisseur OIDC/SAML personnalisé).
- Votre pare-feu doit autoriser le trafic HTTPS sortant (port TCP
443) de l'hôte de l'agent distant verssts.googleapis.com,iamcredentials.googleapis.comet le point de terminaison de localisation de l'API Chronicle (REGION-chronicle.googleapis.com, configuré dansONE_PLATFORM_URL_DOMAIN). Pour obtenir des informations complètes sur la liste d'autorisation et Private Service Connect, consultez Exigences concernant le réseau et Private Service Connect et Exigences concernant le réseau et le pare-feu.
Étape 1 : Créer un pool d'identités de charge de travail et un fournisseur
Dans Google Cloud, les pools d'identités de charge de travail gèrent les identités externes, tandis que les fournisseurs d'identités de charge de travail définissent les paramètres de connexion entre votre IdP externe et Google Cloud.
- Dans la console Google Cloud , accédez à la page Pools d'identités de charge de travail. Accéder aux pools d'identités de charge de travail
- Cliquez sur Créer un pool.
- Saisissez un nom et une description pour le pool (par exemple,
soar-remote-agent-pool). - Cliquez sur Continuer.
- Dans la section Ajouter un fournisseur au pool, sélectionnez votre type de fournisseur et saisissez les informations de connexion du fournisseur (comme l'ID de compte AWS ou l'émetteur et l'audience OIDC) à partir du guide de votre fournisseur.
- Dans la section Configurer les mappages d'attributs, mappez les revendications de votre jeton externe (comme
google.subject=assertion.sub) aux attributs IAM Google Cloud , comme spécifié dans le guide de votre fournisseur. - Cliquez sur Enregistrer.
Étape 2 : Accorder des autorisations d'emprunt d'identité d'un compte de service
Autorisez les identités externes de votre pool d'identités de charge de travail à emprunter l'identité de votre compte de service d'agent distant.
- Dans la console Google Cloud , accédez à la page Comptes de service.
- Sélectionnez votre compte de service d'agent distant.
- Cliquez sur l'onglet Comptes principaux avec accès.
- Cliquez sur Accorder l'accès.
- Dans le champ Nouveaux comptes principaux, saisissez l'identifiant du compte principal correspondant à votre pool d'identités de charge de travail :
principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/*
- Dans la liste Sélectionner un rôle, sélectionnez Utilisateur Workload Identity (
roles/iam.workloadIdentityUser). - Cliquez sur Enregistrer.
Étape 3 : Téléchargez ou générez des identifiants de compte externe (agent-key.json)
Sur la machine hôte de l'agent distant, obtenez un fichier de configuration des identifiants de compte externe nommé agent-key.json à l'aide de l'une des options suivantes.
Option A : Télécharger depuis la console Google Cloud (recommandé)
- Dans la console Google Cloud , accédez à la page Pools d'identités de charge de travail.
- Sélectionnez votre pool d'identités de charge de travail, puis cliquez sur Accorder l'accès.
- Dans le panneau Accorder l'accès, sélectionnez Accorder l'accès par le biais de l'emprunt d'identité d'un compte de service.
- Dans la liste Sélectionner un compte de service, sélectionnez votre compte de service d'agent distant.
- Dans la section Sélectionner des comptes principaux (identités ayant accès au compte de service), spécifiez les identités qui peuvent accéder au compte de service (par exemple, en sélectionnant un nom et une valeur d'attribut).
- Cliquez sur Enregistrer.
- Dans la fenêtre Configure your application (Configurer votre application) :
- Sélectionnez votre fournisseur d'identité de charge de travail.
- Dans le champ Chemin d'accès au jeton d'ID OIDC, saisissez le chemin d'accès exact où votre jeton externe est installé ou stocké (pour les jetons projetés Kubernetes, il doit correspondre à
mountPath+pathdéfini dans votre fichier manifeste de pod, par exemple/var/run/secrets/tokens/gcp-kms-token). - Définissez Type de format sur Texte (chaîne JWT brute). Ne sélectionnez pas JSON pour les fichiers de jetons standards.
- Cliquez sur Télécharger la configuration et enregistrez le fichier sous le nom
agent-key.json(ou renommez le fichier téléchargé enagent-key.json).
- Transférez le fichier
agent-key.jsonvers votre machine hôte de l'agent distant.
Option B : Générer à l'aide de la gcloud CLI
Exécutez la commande gcloud iam workload-identity-pools create-cred-config pour générer le fichier de configuration des identifiants :
gcloud iam workload-identity-pools create-cred-config \ projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID \ --service-account=SERVICE_ACCOUNT_EMAIL \ --output-file=agent-key.json \ --credential-source-file=/var/run/secrets/tokens/gcp-kms-token
Documentation de référence sur les exemples de fichiers de configuration
Pour référence, le fichier agent-key.json généré contient une structure semblable à celle-ci :
{ "type": "external_account", "audience": "//iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID", "subject_token_type": "urn:ietf:params:oauth:token-type:jwt", "token_url": "https://sts.googleapis.com/v1/token", "credential_source": { "file": "/var/run/secrets/tokens/gcp-kms-token" }, "service_account_impersonation_url": "https://iamcredentials.googleapis.com/v1/projects/-/serviceAccounts/SERVICE_ACCOUNT_EMAIL:generateAccessToken" }
Étape 4 : Mapper le compte de service dans Google SecOps
Avant de déployer l'agent distant, autorisez l'adresse e-mail du compte de service dans Google SecOps :
- Accédez à Paramètres > Gestion des accès > Mappage de groupes.
- Cliquez sur add Ajouter.
- Dans la boîte de dialogue Ajouter un rôle, saisissez l'adresse e-mail complète du compte de service dans le champ Rôle IAM/Groupe IdP.
- Sélectionnez les environnements appropriés que l'agent distant gérera.
- Cliquez sur Ajouter.
Étape 5 : Déployez ou mettez à jour l'authentification de l'agent distant
Podman
Pour configurer l'authentification de l'agent distant sur Podman, procédez comme suit :
-
Répertoriez les conteneurs Podman en cours d'exécution :
podman ps -
Saisissez l'ID de conteneur de votre agent :
CONTAINER_ID
-
Utilisez la commande suivante pour copier le fichier de configuration des identifiants dans le chemin d'accès dédié du conteneur :
podman cp PATH_TO_AGENT_KEY/agent-key.json CONTAINER_ID:/opt/SiemplifyAgent/agent-key.json
-
Utilisez la commande suivante pour modifier le propriétaire du fichier de configuration des identifiants dans le conteneur :
podman exec -u 0 CONTAINER_ID chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json
-
Exécutez la commande suivante pour appliquer les modifications :
podman restart CONTAINER_ID
Docker
Pour configurer l'authentification de l'agent distant sur Docker, procédez comme suit :
-
Répertoriez les conteneurs Docker en cours d'exécution :
docker ps -
Saisissez l'ID de conteneur de votre agent :
CONTAINER_ID
-
Utilisez la commande suivante pour copier le fichier de configuration des identifiants dans le chemin d'accès dédié du conteneur :
docker cp PATH_TO_AGENT_KEY/agent-key.json CONTAINER_ID:/opt/SiemplifyAgent/agent-key.json
-
Utilisez la commande suivante pour modifier le propriétaire du fichier de configuration des identifiants dans le conteneur :
docker exec -u 0 CONTAINER_ID chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json
-
Exécutez la commande suivante pour appliquer les modifications :
docker restart CONTAINER_ID
Installateur
Pour configurer l'authentification de l'agent distant sur CentOS/RHEL, procédez comme suit :
-
Déplacez le fichier de configuration des identifiants vers le chemin d'accès attendu :
mv PATH_TO_AGENT_KEY/agent-key.json /opt/SiemplifyAgent/agent-key.json
-
Utilisez la commande suivante pour modifier le propriétaire du fichier de configuration des identifiants :
chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json
-
Exécutez la commande suivante pour redémarrer le service de l'agent :
supervisorctl restart siemplify_agent
Documentation associée
- Migrer l'infrastructure d'authentification de l'agent distant
- Présentation de la sécurité de l'agent distant
- Résoudre les problèmes liés aux agents distants
Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.