Habilita la API de Secret Manager

Secret Manager expone una API de REST y una API de gRPC para usar y administrar secretos directamente o en tus aplicaciones. En esta página, se describe cómo habilitar la API de Secret Manager y configurar tu proyecto de Cloud de Confiance by S3NS para usar Secret Manager por primera vez.

Cuando te familiarices con Secret Manager, te recomendamos que uses un proyecto Cloud de Confiance independiente. Si borras el proyecto, también se borran todos los recursos creados durante las pruebas, incluidos los recursos facturables.

Si estás desarrollando una aplicación en un IDE con Cloud Code instalado, Secret Manager está integrado a la extensión. Esto significa que puedes crear, ver, actualizar y usar secretos sin tener que salir de tu IDE. Si deseas obtener más información sobre el uso de Secret Manager con Cloud Code, consulta la guía de administración de secretos para tu IDE preferido, VS Code, IntelliJ, o Editor de Cloud Shell.

Antes de comenzar

  1. En la consola de Cloud de Confiance , ve a la página del selector de proyectos.

    Ir al selector de proyectos

  2. Selecciona o crea un proyecto de Cloud de Confiance .

    Roles necesarios para seleccionar o crear un proyecto

    • Selecciona un proyecto: Para seleccionar un proyecto, no se requiere un rol de IAM específico. Puedes seleccionar cualquier proyecto en el que se te haya otorgado un rol.
    • Crea un proyecto: Para crear un proyecto, necesitas el rol de Creador de proyectos (roles/resourcemanager.projectCreator), que contiene el permiso resourcemanager.projects.create. Obtén más información para otorgar roles.

Habilita la API de Secret Manager

Console

  1. En la consola de Cloud de Confiance , ve a la página de la API de Secret Manager.

    Ir a la API de Secret Manager

  2. Verifica que el nombre de tu proyecto aparezca en el selector de proyectos en la parte superior de la página.

    Si no ves el nombre de tu proyecto, haz clic en el selector de proyectos y, luego, selecciona tu proyecto.

  3. Haz clic en Habilitar.

gcloud

  1. En la consola de Cloud de Confiance , activa Cloud Shell.

    Activa Cloud Shell

    En la parte inferior de la consola de Cloud de Confiance , se inicia una sesión de Cloud Shell en la que se muestra una ventana de línea de comandos. Cloud Shell es un entorno de shell con Google Cloud CLI ya instalada y con valores ya establecidos para el proyecto actual. La sesión puede tardar unos segundos en inicializarse.

  2. Para configurar tu proyecto de Cloud de Confiance by S3NS en la sesión de gcloud, ejecuta el comando gcloud config set project. Reemplaza PROJECT_ID por el ID del proyecto de Cloud de Confiance . 
    gcloud config set project PROJECT_ID
  3. Para habilitar la API de Secret Manager, ejecuta el comando gcloud services enable: 
    gcloud services enable secretmanager.googleapis.com
  4. Para verificar que la API de Secret Manager esté habilitada, ejecuta el comando gcloud services list: 
    gcloud services list --enabled

    Verifica que la API de Secret Manager aparezca en la lista de APIs habilitadas.

Accede a los Secrets regionales en tu entorno

Para crear y administrar secretos regionales, tu configuración usa un extremo central que depende del balanceador de cargas de servidores global (GSLB) para enrutar las solicitudes. Esto es diferente de Cloud de Confiance by S3NSestándar, que requiere configurar un extremo regional específico.

Con este método, se garantiza que tus cargas de trabajo puedan cumplir con los requisitos de residencia de datos y soberanía de los datos especificando de forma explícita la ubicación en la que se debe almacenar un secreto en tus llamadas a la API o comandos de Google Cloud CLI.

Para asegurarte de que tus secretos se almacenen en una ubicación geográfica específica, debes especificar la región en tus solicitudes.

  • Cloud de Confiance by S3NS: Cuando uses Cloud de Confiance by S3NS, agrega la marca --location a tus comandos.
  • API de REST: Cuando uses la API de REST, incluye la ubicación directamente en la URL de la solicitud.

Configura roles y permisos

Para obtener los permisos que necesitas para configurar Secret Manager, pídele a tu administrador que te otorgue el rol de IAM Administrador de Secret Manager (roles/secretmanager.admin) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Para obtener más información sobre el control de acceso de Secret Manager, consulta Control de acceso con IAM.

¿Qué sigue?