Configuration de HashiCorp Vault

Vous pouvez configurer HashiCorp Vault en tant qu'intégration d'outils dans votre chaîne d'outils pour accéder et faire référence à des secrets stockés de manière sécurisée dans un serveur Vault HashiCorp.

Avant de configurer l'intégration d'outils Vault HashiCorp pour votre chaîne d'outils, vous avez besoin de la méthode d'authentification et des données d'identification associées, ainsi que du droit d'accès au serveur Vault HashiCorp auquel vous souhaitez vous connecter. Par exemple, si authentication_method a pour valeur github, vous devez connaître vos données d'identification token. Vous devez également connaître les valeurs de server url, integration url et secrets path. Si le serveur HashiCorp Vault est lié à un port spécifique, incluez le numéro de port dans l'URL du serveur. Par exemple, https://192.168.0.100:8200.

L'intégration de l'outil HashiCorp Vault prend en charge uniquement les références de secrets par nom. Si vous souhaitez utiliser des références de secrets par CRN, vous devez utiliser une intégration d'outilsSecrets Manager.

Configurez HashiCorp Vault de manière à gérer de manière sécurisée des secrets tels que les clés d'API et les secrets qui font partie de votre chaîne d'outils ou de votre pipeline de distribution :

1. Si vous configurez cette intégration d'outils lorsque vous créez la chaîne d'outils et qu'une intégration d'outils HashiCorp Vault existe dans le modèle que vous configurez, cliquez sur l'onglet HashiCorp Vault. Vous pouvez également cliquer sur HashiCorp Vault dans la section Plus d'outils.

2. Si vous avez une chaîne d'outils et que vous y ajoutez cette intégration d'outils, à partir de la console IBM Cloud, cliquez sur l' Menu > Automatisation de la plateforme > Chaînes d'outils. Sur la page Chaînes d'outils, cliquez sur la chaîne d'outils afin d'ouvrir sa page Vue d'ensemble. Vous pouvez également, depuis votre page de présentation de l'application, sur la carte Distribution continue, cliquer sur Afficher la chaîne d'outils. Ensuite, cliquez sur Vue d'ensemble.

   a. Cliquez sur Ajouter un outil.

   b. Dans la section Intégrations d'outils, cliquez sur HashiCorp Vault.

3. Entrez le nom que vous voulez afficher pour cette intégration d'outils sur la carte HashiCorp Vault de votre chaîne d'outils. Le nom du secret peut comporter les caractères a-z, A-Z et 0-9, ainsi que le caractère espace. Les autres caractères ne sont pas admis et empêchent la résolution du secret. Par exemple, my.secret est un nom incorrect mais my-secret est valide.

4. Entrez l'URL du serveur HashiCorp Vault que vous voulez ouvrir lorsque vous cliquez sur la carte HashiCorp Vault depuis votre chaîne d'outils. Assurez-vous que cette URL est préfixée avec le protocole http ou https et se termine par le numéro de port HashiCorp Vault ; par exemple : https://www.acme.com:8200.

5. Entrez l'URL de l'intégration d'outil HashiCorp Vault. Cette valeur peut être n'importe quelle URL valide, telle qu'une URL spécifique à une organisation associée à la documentation ou à la console d'interface utilisateur Web du serveur HashiCorp Vault de votre organisation.

6. Entrez le chemin d'accès au secret sur le serveur HashiCorp Vault accessible lorsque vous utilisez la méthode d'authentification configurée et les données d'authentification associées. Cette valeur ne doit inclure que le chemin des secrets et ne peut pas comporter un nom de secret à la fin du chemin. Si vos données d'authentification contiennent le droit LIST approprié dans le chemin de secret spécifié, vous pouvez afficher la liste des secrets dans ce chemin.

7. Cliquez sur Créer une intégration.

8. Sur la page Présentation de la chaîne d'outils, sur la carte Outils tiers, cliquez sur HashiCorp Vault pour utiliser les composants Sélecteur de coffre-fort HashiCorp et Pusher pour sélectionner des secrets à utiliser au sein de votre chaîne d'outils ou de votre pipeline de livraison.