Gérer les secrets avec Secret Manager dans Cloud Code pour Cloud Shell

L'intégration de Secret Manager (gestionnaire de secrets) à Cloud Code permet de créer, d'afficher, de mettre à jour et d'utiliser des secrets depuis votre IDE sans les stocker dans votre codebase.

Cette page explique comment accéder au gestionnaire de secret depuis votre IDE et comment s'y prendre pour créer et gérer des secrets.

Activer l'API Secret Manager

Lorsque vous gérez des secrets avec Cloud Code, ceux-ci sont stockés de manière sécurisée dans le gestionnaire de secrets. Ils peuvent être récupérés de manière automatisée lorsque vous en avez besoin. Les deux seuls prérequis sont l'activation de l'API Secret Manager et l'obtention des autorisations appropriées pour gérer les secrets :

1. Assurez-vous que vous travaillez dans le projet où se trouve votre code d'application. Votre secret doit se trouver dans le même projet que le code de votre application.

2. Cliquez sur Cloud Code, puis développez l'explorateur Secret Manager.

3. Si vous n'avez pas activé l'API Secret Manager, cliquez sur Activez l'API Secret Manager dans l'explorateur Secret Manager.

Créer des secrets

Pour créer un secret à l'aide de l'explorateur Secret Manager, procédez comme suit :

1. Dans votre IDE, cliquez sur Cloud Code, puis développez la Explorateur Secret Manager.

2. Cliquez sur add Créer un secret dans Explorateur Secret Manager.

   Dans la boîte de dialogue Créer un secret, définissez le projet, le nom, la valeur et une région et spécifiez des étiquettes pour organiser vos secrets.

Vous pouvez également créer un secret à l'aide de l'éditeur :

1. Dans l'éditeur, ouvrez un fichier contenant le texte que vous souhaitez stocker en tant que secret.
2. Mettez en surbrillance le texte à stocker en tant que secret, effectuez un clic droit, puis cliquez sur Créer un secret dans Secret Manager.
3. Dans la boîte de dialogue Créer un secret, personnalisez le projet, le nom, la valeur, la région et les libellés du secret.

Créer des versions de secrets

Pour créer une nouvelle version d'un secret à l'aide de Secret Manager, procédez comme suit : procédez comme suit:

1. Effectuez un clic droit sur un secret existant, puis choisissez Créer une version de secret.

2. Dans la boîte de dialogue Créer une version, définissez la nouvelle valeur de votre secret existant. à l'aide du champ Valeur du secret ou en important un fichier.

3. Pour supprimer toutes les versions précédentes de votre secret et ne conserver que la nouvelle version que vous êtes en train de créer, sélectionnez Désactiver toutes les versions précédentes.

4. Cliquez sur Créer une version. Votre version est ajoutée et vous pouvez afficher la dernière version du secret ainsi que les versions précédentes répertoriées dans les listes déroulantes des Versions.

Vous pouvez également créer une nouvelle version d'un secret dans l'éditeur:

1. Dans l'éditeur, ouvrez un fichier et mettez en surbrillance le texte à stocker en tant que secret.

2. Effectuez un clic droit sur le texte en surbrillance, puis choisissez Add Version to Secret in Secret Manager

Gérer les versions de secrets

Pour activer, désactiver ou détruire une version d'un secret, effectuez un clic droit sur le secret, puis sélectionnez la commande correspondant à l'action que vous souhaitez effectuer. Pour les versions de secrets activées, vous pouvez également afficher la valeur de la version.

Afficher les secrets

Pour afficher un secret, sélectionnez-le dans la liste de l'explorateur Secret Manager. Les détails du secret, tels que le nom, la règle de réplication, l'horodatage de création, et l'ID de ressource, figurent sous le nom du secret.

Afficher les secrets dans la console Google Cloud

Vous pouvez également afficher les secrets dans la console Google Cloud en effectuant un clic droit le secret dans l'explorateur Secret Manager, puis en cliquant sur Ouvrir dans Cloud.

Afficher les secrets dans l'explorateur Kubernetes

Pour afficher les secrets dans l'explorateur Kubernetes, procédez comme suit:

1. Cliquez sur Cloud Code, puis développez Kubernetes. un explorateur.
2. Développez votre cluster, puis Secrets.
3. Développez le secret pour en afficher les détails.

Accéder aux secrets depuis votre application

Une fois le secret créé, vous pouvez l'inclure dans le code et configurer l'authentification.

Pour accéder à un secret depuis votre application:

1. Installez la bibliothèque cliente Secret Manager.

   1. Cliquez sur Cloud Code, puis développez la section Explorateur d'API Cloud.

   2. Développez Sécurité Cloud > API Secret Manager, puis suivez les instructions de la section "Installer la bibliothèque cliente" pour le langage que vous utilisez.

2. Personnalisez et incluez l'extrait de code approprié dans le code de votre application.

   Pour obtenir le nom de la version du secret à utiliser dans le code, sélectionnez le secret dans le panneau Secret Manager, effectuez un clic droit, puis choisissez Copier l'ID de ressource.

3. Pour terminer la configuration de l'authentification, suivez le guide d'authentification des bibliothèques clientes :

   • Développement local: si vous effectuez le développement sur un cluster local (comme minikube ou Docker Desktop) ou un émulateur local, vous devez effectuer la les étapes illustrées dans le Section sur le développement local pertinentes pour votre flux de travail.
   • Développement à distance: si vous utilisez un cluster GKE ou Cloud Run dans votre application, vous devez suivre la procédure illustrée dans la section Développement à distance pertinentes pour votre workflow, y compris les règles spécifiques à Secret Manager pour configurer les rôles requis sur votre compte de service.

Ajouter un secret en tant que variable d'environnement

Pour ajouter un secret Kubernetes existant au déploiement en tant que variable d'environnement, procédez comme suit :

1. Cliquez sur Cloud Code, puis développez Kubernetes. un explorateur.
2. Développez votre cluster Minikube, puis développez Secrets.
3. Effectuez un clic droit sur un secret représentant un objet de déploiement, puis cliquez sur Add Secret as Environment Variable (Ajouter un secret en tant que variable d'environnement).

Installer un secret en tant que volume

Pour installer un secret Kubernetes existant en tant que volume dans le conteneur du déploiement, procédez comme suit:

1. Cliquez sur Cloud Code, puis développez Kubernetes. un explorateur.
2. Développez votre cluster Minikube, puis Secrets.
3. Effectuez un clic droit sur un secret représentant un objet de déploiement, puis cliquez sur Mount Secret as Volume (Installer un secret en tant que volume).

Supprimer les secrets

Remarque :La suppression d'un secret nécessite le rôle d'administrateur des secrets (roles/secretmanager.admin) sur le secret, le projet, le dossier ou l'organisation. Vous ne pouvez pas accorder de rôles IAM sur une version de secret.

Pour supprimer un secret à l'aide de Secret Manager dans Cloud Code, procédez comme suit :

1. Cliquez sur Cloud Code, puis développez la section Explorateur Secret Manager.

2. Effectuez un clic droit sur un secret existant, puis sélectionnez Ouvrir dans la console Cloud.

3. Sur la page Informations détaillées sur le secret, cliquez sur SUPPRIMER, puis suivez les instructions pour supprimer le secret.