Crear y acceder a un secreto con Secret Manager
Consulta cómo crear y acceder a secretos con Secret Manager en Google Cloud.
Para seguir las instrucciones paso a paso de esta tarea directamente en la Google Cloud consola, haz clic en Ayúdame:
Antes de empezar
- Habilita la API Secret Manager una vez por proyecto.
- Asigna el rol de administrador de Secret Manager (
roles/secretmanager.admin) en el proyecto, la carpeta o la organización. Autentícate en la API Secret Manager de una de las siguientes formas:
- Si usas bibliotecas de cliente para acceder a la API Secret Manager, configura las credenciales predeterminadas de la aplicación.
- Si usas Google Cloud CLI para acceder a la API Secret Manager, utiliza tus credenciales de Google Cloud CLI para autenticarte.
- Para autenticar una llamada REST, usa las credenciales de Google Cloud CLI o las credenciales predeterminadas de la aplicación.
Crear un secreto y acceder a una versión de secreto
En los siguientes ejemplos se muestra cómo crear un secreto y acceder al contenido de la versión de un secreto.
Consola
Para crear el secreto y la versión del secreto, sigue estos pasos:
-
Ve a la página Secret Manager en la Google Cloud consola.
-
En la página Secret Manager, haz clic en Crear secreto.
-
En la página Crear secreto, en Nombre, introduce
my-secret. -
En el campo Valor secreto, introduce
my super secret data. -
Haz clic en el botón Crear secreto.
Para acceder al contenido de la versión del secreto, sigue estos pasos:
-
Ve a la página Secret Manager en la Google Cloud consola.
-
En la página Secret Manager, haz clic en my-secret.
-
En la página Detalles del secreto, en la tabla Versiones, busca la versión 1.
-
En la columna Acciones, haga clic en Ver más.
-
En el menú, haz clic en Ver valor del secreto.
-
Aparecerá un cuadro de diálogo que muestra el valor del secreto. Haz clic en Hecho para cerrar el cuadro de diálogo.
gcloud
Para usar Secret Manager en la línea de comandos, primero debes instalar o actualizar a la versión 378.0.0 o una posterior de la CLI de Google Cloud. En Compute Engine o GKE, debes autenticarte con el ámbito cloud-platform.
Para crear un secreto y almacenar una cadena como contenido de la primera versión del secreto, sigue estos pasos:
$ echo -n "my super secret data" | gcloud secrets create my-secret \
--replication-policy="replication-policy" \
--data-file=-
replication-policy puede ser automatic o user-managed.
Para acceder al contenido de una versión específica de un secreto, sigue estos pasos:
$ gcloud secrets versions access 1 --secret="my-secret"
Para acceder al contenido de la versión más reciente del secreto, sigue estos pasos:
$ gcloud secrets versions access latest --secret="my-secret"
C#
Para ejecutar este código, primero debes configurar un entorno de desarrollo de C# e instalar el SDK de Secret Manager para C#. En Compute Engine o GKE, debes autenticarte con el ámbito cloud-platform.