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. Nesta página, descrevemos como ativar a API Secret Manager e configurar seu projeto do Cloud de Confiance by S3NS para usar o Secret Manager pela primeira vez.

Ao se familiarizar com o Secret Manager, recomendamos usar um projeto do 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 console do Cloud de Confiance , acesse a página Seletor de Projetos.

    Acessar o seletor de projetos

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

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

    • Selecionar um projeto: não é necessário ter um papel específico do IAM para selecionar um projeto. É possível selecionar qualquer projeto em que você tenha um papel.
    • Criar um projeto: para criar um projeto, é necessário ter o papel de Criador de projetos (roles/resourcemanager.projectCreator), que contém a permissão resourcemanager.projects.create. Saiba como conceder papéis.

Ativar a API Secret Manager

Console

  1. No console do Cloud de Confiance , acesse a página da 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 o nome do projeto não aparecer, clique no seletor e selecione o projeto.

  3. Clique em Ativar.

gcloud

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

    Ativar o Cloud Shell

    Na parte inferior do console do Cloud de Confiance , uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. O Cloud Shell é um ambiente shell com a CLI do Google Cloud 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 projeto Cloud de Confiance by S3NS na sessão da gcloud, execute o comando gcloud config set project. Substitua PROJECT_ID pelo ID do projeto Cloud de Confiance . 
    gcloud config set project PROJECT_ID
  3. Para ativar a API Secret Manager, execute o comando gcloud services enable: 
    gcloud services enable secretmanager.googleapis.com
  4. Para verificar se a API Secret Manager está ativada, execute o comando gcloud services list: 
    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 rotear solicitações. Isso é diferente do Cloud de Confiance by S3NSpadrão, que exige a configuração de um endpoint regional específico.

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

Para garantir que os 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 flag --location aos seus 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 papéis personalizados ou outros papéis predefinidos.

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

A seguir