Authentifier l'agent distant avec la fédération d'identité de charge de travail

Compatible avec :

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 vers sts.googleapis.com, iamcredentials.googleapis.com et le point de terminaison de localisation de l'API Chronicle (REGION-chronicle.googleapis.com, configuré dans ONE_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.

  1. 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
  2. Cliquez sur Créer un pool.
  3. Saisissez un nom et une description pour le pool (par exemple, soar-remote-agent-pool).
  4. Cliquez sur Continuer.
  5. 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.
  6. 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.
  7. 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.

  1. Dans la console Google Cloud , accédez à la page Comptes de service.
  2. Sélectionnez votre compte de service d'agent distant.
  3. Cliquez sur l'onglet Comptes principaux avec accès.
  4. Cliquez sur Accorder l'accès.
  5. 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/*
  6. Dans la liste Sélectionner un rôle, sélectionnez Utilisateur Workload Identity (roles/iam.workloadIdentityUser).
  7. 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é)

  1. Dans la console Google Cloud , accédez à la page Pools d'identités de charge de travail.
  2. Sélectionnez votre pool d'identités de charge de travail, puis cliquez sur Accorder l'accès.
  3. 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.
  4. Dans la liste Sélectionner un compte de service, sélectionnez votre compte de service d'agent distant.
  5. 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).
  6. Cliquez sur Enregistrer.
  7. 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 + path dé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é en agent-key.json).
  8. Transférez le fichier agent-key.json vers 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 :

  1. Accédez à Paramètres > Gestion des accès > Mappage de groupes.
  2. Cliquez sur add Ajouter.
  3. 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.
  4. Sélectionnez les environnements appropriés que l'agent distant gérera.
  5. 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 :

  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 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
  4. 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
  5. 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 :

  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 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
  4. 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
  5. 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 :

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