HashiCorp Vault

Ce document explique comment intégrer HashiCorp Vault à Google SecOps.

Intégrer HashiCorp Vault à Google Security Operations

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

Entrées d'intégration

Pour configurer l'intégration, utilisez les paramètres suivants :

Paramètres
API Root Valeur

Racine de l'API à laquelle se connecter.

La valeur par défaut est https://IP_ADDRESS:8200..
Token Optional

Jeton à utiliser pour la connexion. Vous pouvez vous authentifier à l'aide d'un jeton ou de la combinaison nom d'utilisateur/mot de passe.
Username Optional

Nom d'utilisateur à utiliser pour la connexion. Vous pouvez vous authentifier à l'aide d'un jeton ou de la combinaison nom d'utilisateur/mot de passe.
Password Optional

Mot de passe à utiliser pour la connexion. Vous pouvez vous authentifier à l'aide d'un jeton ou de la combinaison nom d'utilisateur/mot de passe.

Verify SSL Optional

Si cette option est cochée, le certificat configuré pour la racine de l'API est validé.

Cette option est décochée par défaut.
Key-Value Secret Engine Path Valeur

Chemin d'accès utilisé pour le stockage des secrets clé-valeur. Seule la version 2 est compatible. Ce paramètre permet d'interagir avec les secrets stockés dans un espace de stockage et de créer des URL telles que https://IP_ADDRESS:8200/v1/secret/data/ .

La valeur par défaut est secret.

Actions

Générer des identifiants AWS

Générez des identifiants basés sur le rôle AWS stocké dans HashiCorp Vault.

Entités

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

Entrées de l'action

Pour configurer l'intégration, utilisez les paramètres suivants :

Paramètres
AWS Secret Engine Path Optional

Chemin d'accès utilisé pour le stockage des secrets AWS. Seule la version 2 est compatible. Ce paramètre permet d'interagir avec les secrets stockés dans un espace de stockage et de créer des URL telles que http://IP_ADDRESS:8200/v1/aws/roles/ .

La valeur par défaut est aws.
AWS Role Name Valeur

Nom du rôle pour lequel générer des identifiants.
AWS Role ARN Optional

ARN du rôle à assumer si le credential_type du rôle Vault est défini sur assumed_role.

Ce paramètre doit correspondre à l'un des ARN de rôle autorisés dans le rôle Vault.
AWS Role Session Name Optional

Nom de la session de rôle à associer à l'ARN du rôle assumé. Si aucune valeur n'est fournie, elle est générée de manière dynamique par défaut.
TTL (seconds) Optional

Valeur TTL en secondes pour l'utilisation du jeton STS.

Ce paramètre est spécifié sous forme de chaîne avec un suffixe de durée et n'est valide que lorsque le rôle AWS credential_type dans un coffre est assumed_role ou federation_token.

Lorsque ce paramètre n'est pas spécifié, la valeur default_sts_ttl définie pour le rôle est utilisée.

Si la valeur default_sts_ttl n'est pas non plus définie, la valeur par défaut de 3 600 secondes est utilisée.
JSON Expression Builder Optional

Expression JSON permettant de filtrer un sous-ensemble spécifique de données d'un secret.

Exemple : | "data" | "data" | "key0".

Sorties de l'action

Type de sortie de l'action
Pièce jointe au mur des cas N/A
Lien vers le mur des cas N/A
Tableau du mur des cas N/A
Table d'enrichissement N/A
Insight sur l'entité N/A
Insight N/A
Résultat JSON Disponible
Widget prêt à l'emploi N/A
Résultat du script Disponible
Résultat du script
Nom du résultat du script Valeur
is_success Vrai/Faux
Résultat JSON
{
"request_id": "08fe0196-fd51-8c32-9a90-a245ad6ade29",
"lease_id": "aws/creds/my-role/MWLgJVdR2n8YwQuuX1dVN3Nv",
"renewable": true,
"lease_duration": 2764800,
"data": {
"access_key": "AKIAWP5MI7…",
"secret_key": "CwYA8StJ8r+Oe0AKS8JnBvOWNOF…",
"security_token": null
},
"wrap_info": null,
"warnings": null,
"auth": null
}
Mur des cas

L'action fournit les messages de sortie suivants :

Message de sortie Description du message
Successfully generated credentials for the ROLE_NAME role. Action effectuée.
Error executing action "Generate AWS Credentials". Reason: Incorrect JSON value is provided for the Expression Builder.

Échec de l'action.

Vérifiez la valeur du paramètre JSON Expression Builder.
Error executing action "Generate AWS Credentials". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.

Lister les rôles AWS

Répertoriez les rôles AWS disponibles dans HashiCorp Vault en fonction des critères fournis.

Entités

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

Entrées de l'action

Pour configurer l'intégration, utilisez les paramètres suivants :

Paramètres
AWS Secret Engine Path Optional

Chemin d'accès utilisé pour le stockage des secrets AWS. Seule la version 2 est compatible. Ce paramètre permet d'interagir avec les secrets stockés dans un espace de stockage et de créer des URL telles que http://IP_ADDRESS:8200/v1/aws/roles/ .

La valeur par défaut est aws.
Max Records To Return Optional

Nombre d'enregistrements à renvoyer. Si aucune valeur n'est fournie, l'action renvoie 50 enregistrements par défaut.

Sorties de l'action

Type de sortie de l'action
Pièce jointe au mur des cas N/A
Lien vers le mur des cas N/A
Tableau du mur des cas N/A
Table d'enrichissement N/A
Insight sur l'entité N/A
Insight N/A
Résultat JSON Disponible
Widget prêt à l'emploi N/A
Résultat du script Disponible
Résultat du script
Nom du résultat du script Valeur
is_success Vrai/Faux
Résultat JSON
{
"request_id": "7356485b-4186-3873-72e3-d2e588dc6fb6",
"lease_id": "",
"renewable": false,
"lease_duration": 0,
"data": {
"keys": [
"m",
"my-other-role",
"my-role"
]
},
"wrap_info": null,
"warnings": null,
"auth": null
}
Mur des cas

L'action fournit les messages de sortie suivants :

Message de sortie Description du message
Successfully found AWS roles in the AWS_SECRET_ENGINE_PATH store. Action effectuée.
Error executing action "List AWS Roles". Reason: Invalid value was provided for "Max Records to Return": PROVIDED_VALUE . Positive number should be provided.

Échec de l'action.

Vérifiez la valeur du paramètre Max Records to Return.
Error executing action "List AWS Roles". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.

Lister les clés secrètes clé-valeur

Répertoriez les clés secrètes disponibles dans HashiCorp Vault en fonction des critères fournis. L'action renvoie les noms de clés stockés dans un chemin d'accès de secret sans valeurs. Les noms de dossier doivent être spécifiés pour le chemin d'accès du secret. L'action ne fonctionne pas si la clé secrète est fournie.

Entités

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

Entrées de l'action

Pour configurer l'intégration, utilisez les paramètres suivants :

Paramètres
Key-Value Secret Engine Path Optional

Chemin d'accès utilisé pour le stockage des secrets clé-valeur. Seule la version 2 est compatible. Ce paramètre permet d'interagir avec les secrets stockés dans un espace de stockage et de créer des URL telles que https://IP_ADDRESS:8200/v1/secret/data/SECRET_TO_FETCH_FROM_THE_KV_STORE.

La valeur par défaut est secret.
Secret Path Optional

Chemin d'accès au secret à récupérer. L'action accepte les noms de dossiers.

Exemple : si le nom du dossier du chemin d'accès au secret est my-secret et que le chemin d'accès au magasin de clés-valeurs est secret, le chemin d'accès complet à récupérer est https://IP_ADDRESS:8200/v1/secret/data/my-secret.

Si aucune valeur n'est fournie, l'action renvoie toutes les clés secrètes stockées dans le moteur de secrets.

La valeur par défaut est https://IP_ADDRESS:8200..
Max Records To Return Optional

Nombre d'enregistrements à renvoyer.

La valeur par défaut est 50.

Sorties de l'action

Type de sortie de l'action
Pièce jointe au mur des cas N/A
Lien vers le mur des cas N/A
Tableau du mur des cas N/A
Table d'enrichissement N/A
Insight sur l'entité N/A
Insight N/A
Résultat JSON Disponible
Widget prêt à l'emploi N/A
Résultat du script Disponible
Résultat du script
Nom du résultat du script Valeur
is_success Vrai/Faux
Résultat JSON
{
 "request_id": "ed5d30ed-0fe9-a3b5-36d1-cc81b9175fe9",
 "lease_id": "",
 "renewable": false,
 "lease_duration": 0,
 "data": {
   "keys": [
     "hello",
     "tesr2",
     "test"
   ]
 },
 "wrap_info": null,
 "warnings": null,
 "auth": null
}
Mur des cas

L'action fournit les messages de sortie suivants :

Message de sortie Description du message
Successfully found the following secret keys for the provided criteria in the key-value store KEY-VALUE_SECRET_ENGINE_PATH. Action effectuée.
Error executing action "List Key-Value Secret Keys". Reason: Invalid value was provided for "Max Records to Return": PROVIDED_VALUE. Positive number should be provided.

Échec de l'action.

Vérifiez la valeur du paramètre Max Records to Return.
Error executing action "List Key-Value Secret Keys". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.

Ping

Testez la connectivité à l'installation HashiCorp Vault avec les paramètres fournis sur la page de configuration de l'intégration dans la page du Hub de contenus Google SecOps.

Entités

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

Entrées de l'action

N/A

Sorties de l'action

Type de sortie de l'action
Pièce jointe au mur des cas N/A
Lien vers le mur des cas N/A
Tableau du mur des cas N/A
Table d'enrichissement N/A
Insight sur l'entité N/A
Insight N/A
Résultat JSON N/A
Widget prêt à l'emploi N/A
Résultat du script Disponible
Résultat du script
Nom du résultat du script Valeur
is_success Vrai/Faux
Résultat JSON

N/A

Mur des cas

L'action fournit les messages de sortie suivants :

Message de sortie Description du message
Successfully connected to the HashiCorp Vault installation with the provided connection parameters! Action effectuée.
Failed to connect to the HashiCorp Vault installation! Error is ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.

Lire le secret clé-valeur

Lit le secret clé-valeur stocké dans HashiCorp Vault en fonction des critères fournis.

Entités

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

Entrées de l'action

Pour configurer l'intégration, utilisez les paramètres suivants :

Paramètres
Key-Value Secret Engine Path Optional

Chemin d'accès utilisé pour le stockage des secrets clé-valeur. Seule la version 2 est compatible. Ce paramètre permet d'interagir avec les secrets stockés dans un espace de stockage et de créer des URL telles que https://IP_ADDRESS:8200/v1/secret/data/SECRET_TO_FETCH_FROM_THE_KV_STORE.

La valeur par défaut est secret.
Secret Path Valeur

Chemin d'accès au secret à récupérer. L'action accepte les noms de dossiers.

Exemple : si le nom du dossier du chemin d'accès au secret est my-secret et que le chemin d'accès au magasin de clés-valeurs est secret, le chemin d'accès complet à récupérer est https://IP_ADDRESS:8200/v1/secret/data/my-secret.

Si aucune valeur n'est fournie, l'action renvoie toutes les clés secrètes stockées dans le moteur de secrets.

La valeur par défaut est https://IP_ADDRESS:8200..
Secret Version Optional

Version du secret à récupérer.
JSON Expression Builder Optional

Expression JSON permettant de filtrer un sous-ensemble spécifique de données d'un secret.

Exemple : | "data" | "data" | "key0".

Sorties de l'action

Type de sortie de l'action
Pièce jointe au mur des cas N/A
Lien vers le mur des cas N/A
Tableau du mur des cas N/A
Table d'enrichissement N/A
Insight sur l'entité N/A
Insight N/A
Résultat JSON Disponible
Widget prêt à l'emploi N/A
Résultat du script Disponible
Résultat du script
Nom du résultat du script Valeur
is_success Vrai/Faux
Résultat JSON
{
 "request_id": "8b020faf-808f-34c2-5348-c04871ee6594",
 "lease_id": "",
 "renewable": false,
 "lease_duration": 0,
 "data": {
   "data": {
     "key0": "value0"
   },
   "metadata": {
     "created_time": "2023-04-11T10:56:34.766417394Z",
     "custom_metadata": null,
     "deletion_time": "",
     "destroyed": false,
     "version": 1
   }
 },
 "wrap_info": null,
 "warnings": null,
 "auth": null
}
Mur des cas

L'action fournit les messages de sortie suivants :

Message de sortie Description du message
Successfully fetched secret SECRET_PATH. Action effectuée.
Error executing action "Read Key-Value Secret". Reason: Incorrect JSON value is provided for the Expression Builder.

Échec de l'action.

Vérifiez la valeur du paramètre JSON Expression Builder.
Error executing action "Read Key-Value Secret". Reason: ERROR_REASON

Échec de l'action.

Vérifiez la connexion au serveur, les paramètres d'entrée ou les identifiants.

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