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 :
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.
Cliquez sur
Cloud Code, puis développez l'explorateur Secret Manager.Si vous n'avez pas activé l'API Secret Manager, cliquez sur Activer 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:
Dans votre IDE, cliquez sur Cloud Code
, puis développez l'explorateur Secret Manager.Cliquez sur add Créer un secret dans l'explorateur Secret Manager.
Dans la boîte de dialogue Créer un secret, définissez le projet, le nom, la valeur et la région de votre secret, et spécifiez des libellés pour organiser vos secrets.
Vous pouvez également créer un secret à l'aide de l'éditeur:
- Dans l'éditeur, ouvrez un fichier contenant le texte que vous souhaitez stocker en tant que secret.
- Mettez en surbrillance le texte à stocker en tant que secret, effectuez un clic droit, puis cliquez sur Créer un secret dans Secret Manager.
- 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 version d'un secret à l'aide de Secret Manager, procédez comme suit:
Effectuez un clic droit sur un secret existant, puis choisissez Créer une version de secret.
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.
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.
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:
Dans l'éditeur, ouvrez un fichier et mettez en surbrillance le texte à stocker en tant que secret.
Effectuez un clic droit sur le texte en surbrillance, puis sélectionnez Ajouter une version au secret dans 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 des secrets, sélectionnez un secret dans la liste dans 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 sur le secret dans l'explorateur Secret Manager, puis en cliquant sur Ouvrir dans la console Cloud.
Afficher les secrets dans l'explorateur Kubernetes
Pour afficher les secrets dans l'explorateur Kubernetes, procédez comme suit:
- Cliquez sur Cloud Code, puis développez l'explorateur Kubernetes.
- Développez votre cluster, puis Secrets.
- 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:
Installez la bibliothèque cliente Secret Manager.
Cliquez sur
Cloud Code, puis développez l'explorateur d'API Cloud.Développez Cloud Security > API Secret Manager, puis suivez les instructions de la section "Installer la bibliothèque cliente" pour le langage que vous utilisez.
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.
Pour terminer la configuration de l'authentification, suivez le guide d'authentification des bibliothèques clientes :
- Développement local: si vous développez sur un cluster local (tel que Minikube ou Docker Desktop) ou sur un émulateur local, suivez les étapes illustrées dans la section Développement local de votre workflow.
- Développement à distance: si vous utilisez un cluster GKE ou un service Cloud Run dans votre application, vous devez suivre les étapes illustrées dans la section Développement à distance de votre workflow, y compris les instructions spécifiques à Secret Manager pour la configuration des 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:
- Cliquez sur Cloud Code, puis développez l'explorateur Kubernetes.
- Développez votre cluster minikube, puis Secrets.
- 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:
- Cliquez sur Cloud Code, puis développez l'explorateur Kubernetes.
- Développez votre cluster minikube, puis Secrets.
- 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
Pour supprimer un secret à l'aide de Secret Manager dans Cloud Code, procédez comme suit:
Cliquez sur
Cloud Code, puis développez l'explorateur Secret Manager.Effectuez un clic droit sur un secret existant, puis sélectionnez Ouvrir dans Cloud Console.
Sur la page Détails du secret, cliquez sur SUPPRIMER et suivez les instructions pour supprimer le secret.