Ativar a API Secret Manager

O Secret Manager expõe uma API REST e uma API gRPC para usar e gerenciar secrets diretamente ou nos seus aplicativos. Esta página descreve como ativar a API Secret Manager e configurar seu Cloud de Confiance by S3NS projeto para usar o Secret Manager pela primeira vez.

Quando você estiver familiarizado com o Secret Manager, recomendamos usar um projeto Cloud de Confiance separado. A exclusão do projeto também exclui todos os recursos criados durante o teste, incluindo recursos faturáveis.

Se você estiver desenvolvendo um aplicativo em um ambiente de desenvolvimento integrado com o Cloud Code instalado, o Gerenciador de secrets será integrado à extensão. Isso significa que você pode criar, ver, atualizar e usar secrets sem precisar sair do ambiente de desenvolvimento integrado. Para mais informações sobre como usar o Secret Manager com o Cloud Code, consulte o guia de gerenciamento de secrets do ambiente de desenvolvimento integrado de sua preferência, VS Code, IntelliJ, ou editor do Cloud Shell.

Antes de começar

  1. No Cloud de Confiance console do, acesse a página Seletor de Projetos.

    Acessar o seletor de projetos

  2. Selecione ou crie um Cloud de Confiance projeto do.

    Papéis necessários para selecionar ou criar um projeto

    • Selecionar um projeto: a seleção de um projeto não exige um papel específico do IAM. Você pode selecionar qualquer projeto em que tenha recebido um papel.
    • Criar um projeto: para criar um projeto, você precisa do papel de Criador de projetos (roles/resourcemanager.projectCreator), que contém a resourcemanager.projects.create permissão. Saiba como conceder papéis.

Ativar a API Secret Manager

Console

  1. No Cloud de Confiance console, acesse a página API Secret Manager.

    Acessar a API Secret Manager

  2. Verifique se o nome do projeto aparece no seletor de projetos, na parte superior da página.

    Se você não vir o nome do projeto, clique no seletor de projetos para selecioná-lo.

  3. Clique em Ativar.

gcloud

  1. No Cloud de Confiance console, ative o Cloud Shell.

    Ativar o Cloud Shell

    Na parte inferior do Cloud de Confiance console do Cloud Shell, uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. O Cloud Shell é um ambiente shell com a Google Cloud CLI já instalada e com valores já definidos para o projeto atual. A inicialização da sessão pode levar alguns segundos.

  2. Para definir seu Cloud de Confiance by S3NS projeto na sessão gcloud, execute o gcloud config set project comando. Substitua PROJECT_ID pelo ID do seu Cloud de Confiance projeto. 
    gcloud config set project PROJECT_ID
  3. Para ativar a API Secret Manager, execute o gcloud services enable comando: 
    gcloud services enable secretmanager.googleapis.com
  4. Para verificar se a API Secret Manager está ativada, execute o gcloud services list comando: 
    gcloud services list --enabled

    Verifique se a API Secret Manager está listada na lista de APIs ativadas.

Acessar secrets regionais no seu ambiente

Para criar e gerenciar secrets regionais, sua configuração usa um endpoint central que depende do balanceador de carga de servidor global (GSLB, na sigla em inglês) para encaminhar solicitações. Isso é diferente do padrão Cloud de Confiance by S3NS, que exige a configuração de um endpoint regional específico.

O uso desse método garante que suas cargas de trabalho ainda possam obedecer aos requisitos de residência e soberania de dados, especificando explicitamente o local em que um secret precisa ser armazenado nas chamadas de API ou nos comandos da Google Cloud CLI.

Para garantir que seus secrets sejam armazenados em uma localização geográfica específica, especifique a região nas solicitações.

  • Cloud de Confiance by S3NS: ao usar o Cloud de Confiance by S3NS, adicione a --location flag aos comandos.
  • API REST: ao usar a API REST, inclua o local diretamente no URL da solicitação.

Configurar papéis e permissões

Para receber as permissões necessárias para configurar o Secret Manager, peça ao administrador para conceder a você o papel do IAM de Administrador do Secret Manager (roles/secretmanager.admin) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando personalizados papéis ou outros predefinidos papéis.

Para mais informações sobre o controle de acesso do Secret Manager, consulte Controle de acesso com o IAM.

A seguir