Intégrer Akeyless à Google SecOps

Ce document explique comment intégrer Akeyless à Google Security Operations.

Cas d'utilisation

L'intégration d'Akeyless utilise les fonctionnalités de Google SecOps pour prendre en charge les cas d'utilisation suivants :

  • Synchroniser les identifiants d'intégration : mettez à jour automatiquement les identifiants et les paramètres sensibles dans les instances d'intégration, les connecteurs et les jobs Google SecOps à l'aide de secrets stockés dans Akeyless.

  • Récupérer des secrets dans des playbooks : récupérez des secrets statiques ou des versions de secrets spécifiques depuis Akeyless à la demande lors de l'exécution du playbook pour vous authentifier auprès de services externes.

  • Automatisez la rotation des identifiants : propagez les clés API, les jetons et les mots de passe renouvelés d'Akeyless vers les intégrations, les connecteurs et les jobs Google SecOps en mappant les paramètres à la version secrète latest, ce qui évite les interruptions causées par les identifiants expirés.

  • Contrôlez les mises à jour des identifiants avec l'épinglage de version : épinglez les paramètres d'intégration, de connecteur ou de job à une version secrète spécifique dans Akeyless pour valider les modifications des identifiants ou revenir à une version précédente si nécessaire.

  • Éliminer les secrets codés en dur dans les workflows : centralisez les identifiants sensibles dans Akeyless au lieu de les intégrer directement dans les entrées de playbook ou les scripts personnalisés, ce qui réduit l'exposition des identifiants dans les workflows du SOC.

Avant de commencer

Avant de configurer l'intégration dans la plate-forme Google SecOps, vérifiez que vous disposez des éléments suivants :

  • Identifiants de clé API : un ID d'accès et une clé d'accès Akeyless pour l'authentification.

    Pour en savoir plus, consultez Authentification par clé API Akeyless.

  • Autorisations d'accès : autorisations de lecture accordées à votre méthode d'authentification pour les secrets récupérés par Google SecOps.

    Pour en savoir plus, consultez Contrôle des accès basé sur les rôles (RBAC) Akeyless.

  • Connectivité réseau : accès réseau depuis votre instance Google SecOps ou votre agent distant à l'URL de votre API Gateway Akeyless.

Paramètres d'intégration

L'intégration Akeyless nécessite les paramètres suivants :

Paramètre Description
API Gateway URL

Facultatif.

URL de votre passerelle d'API Akeyless.

La valeur par défaut est https://api.akeyless.io.
Access ID

Obligatoire.

ID d'accès pour votre méthode d'authentification par clé API Akeyless.
Access Key

Obligatoire.

La clé d'accès associée à votre ID d'accès Akeyless.
Verify SSL

Obligatoire.

Si cette option est sélectionnée, l'intégration valide le certificat SSL lors de la connexion au serveur Akeyless.

Cette option est activée par défaut.

Pour obtenir des instructions sur la configuration d'une intégration dans Google SecOps, consultez Configurer des intégrations.

Vous pourrez apporter des modifications ultérieurement si nécessaire. Une fois que vous avez configuré une instance d'intégration, vous pouvez l'utiliser dans des playbooks. Pour en savoir plus sur la configuration et la prise en charge de plusieurs instances, consultez Prendre en charge plusieurs instances.

Actions

Pour en savoir plus sur les actions, consultez Répondre aux actions en attente depuis Votre espace de travail et Effectuer une action manuelle.

Obtenir la valeur du secret

Utilisez l'action Obtenir la valeur du secret pour récupérer une valeur de secret depuis Akeyless et l'utiliser dans des playbooks.

Cette action ne s'applique pas aux entités Google SecOps.

Entrées de l'action

L'action Obtenir la valeur du secret nécessite les paramètres suivants :

Paramètre Description
Secret Name

Obligatoire.

Nom ou chemin d'accès du secret à récupérer depuis Akeyless.

Pour récupérer la dernière version, saisissez SECRET_NAME ou SECRET_NAME:latest.

Pour récupérer une version spécifique, saisissez SECRET_NAME:VERSION_NUMBER, où VERSION_NUMBER est un nombre entier positif (par exemple, /prod/api-key:2).

Sorties de l'action

L'action Obtenir la valeur du secret fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Disponible
Messages de sortie Disponible
Résultat du script Disponible
Résultat JSON

L'exemple suivant montre le résultat JSON obtenu lors de l'utilisation de l'action Obtenir la valeur du secret :

{
  "secret_name": "/secops/integrations/example-api-key",
  "version": "latest",
  "secret_value": "EXAMPLE_SECRET_VALUE"
}
Messages de sortie

Sur le mur des demandes, l'action Obtenir la valeur du secret fournit les messages de sortie suivants :

Message de sortie Description du message
Successfully retrieved secret 'SECRET_NAME' (version: 'SECRET_VERSION') from Akeyless Security. L'action a réussi.
Failed to retrieve secret 'SECRET_NAME' (version: 'SECRET_VERSION') from Akeyless Security. Reason: ERROR_REASON

Échec de l'action.

Vérifiez que le chemin d'accès et la version du secret existent dans Akeyless, et que vos identifiants d'authentification disposent d'un accès en lecture au secret.
Error executing action 'Get Secret Value'. Reason: Invalid credential mapping format for value 'SECRET_NAME'. Expected format: 'secret_name' or 'secret_name:version' (where version is a positive integer or 'latest').

Échec de l'action.

Vérifiez le format du paramètre Secret Name.
Résultat du script

Le tableau suivant liste la valeur de la sortie du résultat du script lorsque vous utilisez l'action Obtenir la valeur du secret :

Nom du résultat du script Valeur
is_success true ou false

Ping

Utilisez l'action Ping pour tester la connectivité au serveur Akeyless.

Cette action ne s'exécute pas sur les entités Google SecOps.

Entrées d'action

Aucune.

Sorties de l'action

L'action Ping fournit les résultats suivants :

Type de sortie de l'action Disponibilité
Pièce jointe au mur des cas Non disponible
Lien vers le mur des cas Non disponible
Tableau du mur des cas Non disponible
Table d'enrichissement Non disponible
Résultat JSON Non disponible
Messages de sortie Disponible
Résultat du script Disponible
Messages de sortie

Sur le mur des demandes, l'action Pinger fournit les messages de sortie suivants :

Message de sortie Description du message
Successfully connected to the Akeyless server with the provided connection parameters! L'action a réussi.
Failed to connect to the Akeyless server! Reason: ERROR_REASON

Échec de l'action.

Vérifiez vos paramètres API Gateway URL, Access ID, Access Key et SSL.
Résultat du script

Le tableau suivant indique la valeur du résultat du script lors de l'utilisation de l'action Ping :

Nom du résultat du script Valeur
is_success true ou false

Jobs

Pour en savoir plus sur les jobs, consultez Configurer un nouveau job et Planification avancée.

Tâche de synchronisation des identifiants d'intégration

Utilisez le job de synchronisation des identifiants d'intégration pour synchroniser automatiquement les secrets stockés dans Akeyless avec vos instances d'intégration, connecteurs et jobs Google SecOps configurés.

Paramètres du job

La tâche de synchronisation des identifiants d'intégration nécessite les paramètres suivants :

Paramètre Description
API Gateway URL

Facultatif.

URL de votre passerelle d'API Akeyless.

La valeur par défaut est https://api.akeyless.io.
Access ID

Obligatoire.

ID d'accès pour votre méthode d'authentification par clé API Akeyless.
Access Key

Obligatoire.

La clé d'accès associée à votre ID d'accès Akeyless.
Verify SSL

Obligatoire.

Si cette option est sélectionnée, l'intégration valide le certificat SSL lors de la connexion au serveur Akeyless.

Cette option est activée par défaut.
Environment Name

Obligatoire.

Environnement Google SecOps dans lequel les instances d'intégration, les connecteurs et les jobs cibles sont configurés.

La valeur par défaut est Default Environment.
Credential Mapping

Obligatoire.

Dictionnaire JSON ou YAML qui mappe les instances d'intégration, les connecteurs et les jobs cibles aux secrets Akeyless contenant leurs valeurs de paramètre.

Incluez au moins un paramètre mappé sous les clés integration_instances, connectors ou jobs.

Pour voir un exemple, consultez Exemple de Credential Mapping.

La valeur par défaut est {"integration_instances": {"Integration_Instance_Name": {"Parameter_Name": "Secret_Name"}}}.

Exemple Credential Mapping

L'exemple suivant montre comment mapper des paramètres pour les instances d'intégration, les connecteurs et les jobs dans le paramètre Credential Mapping :

{
  "integration_instances": {
    "VirusTotal_Prod": {
      "API Key": "/secops/prod/virustotal-api-key"
    },
    "Jira_Instance_1": {
      "API Token": "/secops/prod/jira-api-token:2"
    }
  },
  "connectors": {
    "CrowdStrike Falcon Alerts Connector": {
      "Client Secret": "/secops/prod/crowdstrike-client-secret:latest"
    }
  },
  "jobs": {
    "ServiceNow Sync Closed Cases": {
      "Password": "/secops/prod/servicenow-password:1"
    }
  }
}

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