Neste guia de início rápido, mostramos como criar e acessar secrets usando o Secret Manager no Google Cloud.
Antes de começar
Configure o Secret Manager e o ambiente local, uma vez por projeto.
Criar e acessar uma versão do secret
Os exemplos a seguir demonstram como criar e acessar o conteúdo de uma versão do secret. Para mais informações, consulte Como gerenciar secrets.
IU da Web
Para criar o secret e a versão dele, faça o seguinte:
-
Acesse a página do Gerenciador de secrets no Console do Cloud:
-
Na página Gerenciador de secrets, clique em Criar secret.
-
Na página Criar secret, em Nome, digite
my-secret
. -
No campo Valor do secret, digite
my super secret data
. -
Deixe a seção Regiões inalterada.
-
Clique no botão Criar secret.
Para acessar o conteúdo da versão do secret:
-
Acesse a página do Gerenciador de secrets no Console do Cloud:
-
Na página do Gerenciador de secrets, clique em my-secret.
-
Na página Detalhes do secret, localize a versão 1 na tabela Versões.
-
Na coluna Ações, clique em Ver mais
. -
No menu, clique em Visualizar valor do secret.
-
Será exibida uma caixa de diálogo com o valor do secret. Clique em Concluído para fechar a caixa de diálogo.
Linha de comando
Para usar o Secret Manager na linha de comando, primeiro instale ou faça upgrade para a versão 305.0.0 ou posterior do SDK do Cloud.
Para criar um secret e armazenar uma string como o conteúdo da primeira versão do secret, faça o seguinte:
$ echo -n "my super secret data" | gcloud secrets create my-secret \
--replication-policy="replication-policy" \
--data-file=-
Em que replication-policy é automatic
ou user-managed
.
Para acessar o conteúdo de uma versão do secret específica, faça o seguinte:
$ gcloud secrets versions access 1 --secret="my-secret"
Para acessar o conteúdo da versão secreta mais recente, faça o seguinte:
$ gcloud secrets versions access latest --secret="my-secret"
C#
Para executar esse código, primeiro configure um ambiente de desenvolvimento em C# e instale o SDK do C# do Secret Manager.
Go
Para executar esse código, primeiro configure um ambiente de desenvolvimento do Go e instale o SDK do Go do Secret Manager.
Java
Para executar esse código, primeiro configure um ambiente de desenvolvimento do Java e instale o SDK do Java do Secret Manager.
Node.js
Para executar esse código, primeiro configure um ambiente de desenvolvimento do Node.js e instale o SDK do Node.js do Secret Manager.
PHP
Para executar este código, veja primeiro como usar o PHP no Google Cloud e instalar o SDK do PHP do Secret Manager.
Python
Para executar esse código, primeiro configure um ambiente de desenvolvimento do Python e instale o SDK do Python do Secret Manager.
Ruby
Para executar esse código, primeiro configure um ambiente de desenvolvimento em Ruby e instale o SDK do Ruby do Secret Manager.
API
Esses exemplos usam curl para demonstrar o uso da API.
Para criar o secret e armazenar uma string como o conteúdo de uma versão do secret, faça o seguinte:
$ curl "https://secretmanager.googleapis.com/v1/projects/project-id/secrets?secretId=my-secret" \
--request "POST" \
--header "authorization: Bearer $(gcloud auth print-access-token)" \
--header "content-type: application/json" \
--header "x-goog-user-project: project-id" \
--data "{\"replication\": {\"automatic\": {}}}"
Para acessar o conteúdo da versão do secret:
$ curl "https://secretmanager.googleapis.com/v1/projects/project-id/secrets/my-secret/versions/1:access" \
--request "GET" \
--header "authorization: Bearer $(gcloud auth print-access-token)" \
--header "content-type: application/json" \
--header "x-goog-user-project: project-id"
A seguir
- Saiba mais sobre o Secret Manager.
- Saiba mais sobre como gerenciar secrets.