Esta página foi traduzida pela API Cloud Translation.
Switch to English

Como gerenciar secrets com o Gerenciador de secrets

Com a integração do Secret Manager do Cloud Code, é possível criar, ver, atualizar e usar secrets no seu ambiente de desenvolvimento integrado sem precisar deles na sua base de código.

Nesta página, você aprenderá como acessar o Gerenciador de secrets no seu ambiente de desenvolvimento integrado e como começar a criar e gerenciar secrets.

Como ativar o Gerenciador de secrets

Ao gerenciar secrets com o Cloud Code, os secrets são armazenados com segurança no Gerenciador de secrets e podem ser recuperados programaticamente quando você precisar deles. Você só precisa da API Secret Manager ativada e das permissões corretas para gerenciar secrets:

  1. Para iniciar o Secret Manager, clique na guia Secret Manager na barra lateral direita do Cloud Code.

    A guia "Gerenciador de secrets" do Cloud Code destacada na barra lateral direita e no painel do Gerenciador de secrets é aberta com os três segredos listados e os detalhes da versão do "teste" secreto no painel inferior.

  2. Se você não tiver ativado a API Secret Manager, o Cloud Code solicitará que você a ative no painel do Gerenciador de secrets clicando em "Ativar API".

    Seu secret também precisa estar no mesmo projeto que o código do aplicativo. Verifique se o projeto certo está selecionado ou alterne usando o seletor de projetos no painel do Gerenciador de secrets.

    Ativar o link da API no painel Gerenciador de secrets

Como criar e ver secrets

Como criar secrets

É possível criar um secret com um dos seguintes métodos:

Como usar o painel do Gerenciador de secrets

  1. Navegue até o painel do Gerenciador de secrets.

  2. Clique no ícone "Adicionar".

    Isso abre uma caixa de diálogo "Criar secret" em que é possível definir o projeto, o nome e o valor do secret, além de escolher uma região para armazenar o secret e os rótulos para organizá-los.

    A caixa de diálogo "Criar secret" é aberta com o campo "Name" preenchido como "life" e o "Secret Value" preenchido como "42".

Como usar o editor

  1. Abra um arquivo contendo o texto que você quer armazenar como um secret no editor.
  2. Destaque e clique com o botão direito do mouse neste texto.

    No menu, selecione o item de menu Create Secret in Secret Manager.... Isso abre a caixa de diálogo "Criar secret" com o valor do secret preenchido com o texto destacado. É possível personalizar o projeto, o nome, o valor, a região e os rótulos dele.

Como usar o explorador de projetos

  1. No explorador de projetos, sem destacar o texto, clique com o botão direito do mouse.
  2. No menu, selecione o item de menu Create Secret in Secret Manager.... Isso abre a caixa de diálogo "Criar secret". Escolha o projeto, o nome, o valor, a região e os rótulos do secret aqui e clique em "OK" quando terminar.

Como criar novas versões de secrets

Se você já tiver um secret e quiser atualizá-lo, acesse a guia "Versões" do painel do Gerenciador de secrets:

  1. Clique no ícone "Adicionar" na guia "Versões".

    Isso abre uma caixa de diálogo "Adicionar nova versão", em que é possível definir o valor do secret atual usando o campo "Valor do secret" ou importando um arquivo.

    Uma caixa de diálogo "Nova versão" é aberta com o campo de valor do secret "test-secret" atualizado como "bar"

  2. Se preferir remover todas as versões anteriores do secret e manter apenas a nova versão que está sendo criada, escolha "Desativar todas as versões anteriores".

  3. Depois de clicar em "OK" e sua versão for adicionada, será possível ver a versão do secret mais recente e, se aplicável, todas as versões do secret listadas na guia "Versões".

Como visualizar secrets

Para visualizar os secrets, no painel do Gerenciador de secrets, selecione um secret na lista exibida na seção "Nome do secret". Seus detalhes, como nome, política de replicação, carimbo de data/hora da criação e código do recurso, são listados na guia "Visão geral".

Outra opção é clicar com o botão direito do mouse no secret e escolher "Abrir no Cloud Code" para ver e gerenciar o secret no navegador.

Como acessar secrets do seu aplicativo

Depois da criação do secret, é possível incluí-la no seu código e configurar a autenticação.

Guia "Código" do painel do Gerenciador de secrets listando as etapas necessárias para acessar o secret em seu código

Para acessar o secret recém-criado no seu aplicativo, siga estas etapas:

  1. Instale a biblioteca de cliente do Secret Manager.

    Navegue até Ferramentas > Cloud Code > Adicionar bibliotecas do Cloud e gerenciar APIs do Cloud e selecione Gerenciador de secrets > API Secret Manager da árvore de APIs do Google Cloud. Siga as instruções específicas da linguagem descritas na seção "Instalar biblioteca de cliente".

  2. Personalize e inclua o snippet de código relevante no código do seu aplicativo.

    Se você estiver usando uma conta de serviço, também precisará atribuir à sua conta de serviço do Google o papel necessário para acessar o secret do Secret Manager. Para saber mais sobre os papéis do IAM disponíveis para o Gerenciador de secrets, consulte o Guia de controle de acesso do Secret Manager.

  3. Siga as instruções detalhadas na seção Como configurar a autenticação do guia "Bibliotecas de cliente" para concluir a configuração da autenticação.

Como receber suporte

Acesse o GitHub para enviar feedback e informar problemas ou o Stack Overflow (ambos em inglês) para fazer perguntas.