Consulte os conectores compatíveis com a integração de aplicativos.

Secret Manager: tarefa de acesso

Visualização

Esse recurso está sujeito aos "Termos de ofertas pré-GA" na seção "Termos de Serviço gerais" dos Termos específicos de serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

A tarefa Secret Manager - Access permite acessar versões do secret armazenadas no Cloud Secret Manager a partir da sua integração. O acesso a uma versão do secret retorna o conteúdo desse secret com metadados adicionais, como rótulos e informações de replicação.

O Cloud Secret Manager é um serviço do Google Cloud que permite armazenar, acessar e gerenciar dados de configuração confidenciais, como senhas de banco de dados, chaves de API ou certificados TLS exigidos por um aplicativo durante o tempo de execução.

Antes de começar

Execute as seguintes tarefas no projeto do Google Cloud antes de configurar a tarefa Secret Manager - Access:

1. Ative a API Secret Manager (secretmanager.googleapis.com).

   Ativar a API Secret Manager

2. Criar um perfil de autenticação. A integração de aplicativos usa um perfil de autenticação para se conectar a um endpoint de autenticação para a tarefa Secret Manager - Access.
   Observação: se você estiver criando um perfil de autenticação do tipo Conta de serviço, verifique se a conta de serviço está atribuída com o papel do IAM que contém as seguintes permissões do IAM:

   • secretmanager.secretAccessor

   Para saber mais sobre as permissões e os papéis predefinidos do IAM que as concedem, consulte a referência de permissões do IAM.

   Para informações sobre como conceder papéis ou permissões adicionais a uma conta de serviço, consulte Como conceder, alterar e revogar acesso.

Configurar a tarefa "Secret Manager: Access"

1. No console do Google Cloud, acesse a página Application Integration.

   Acessar o Application Integration

2. No menu de navegação, clique em Integrações.

   A página Integrações aparece listando todas as integrações disponíveis no projeto do Google Cloud.

3. Selecione uma integração ou clique em Criar integração para criar uma nova.

   Caso você esteja criando uma nova integração, siga estas etapas:

   1. Insira um nome e uma descrição no painel Criar integração.
   2. Selecione uma região para a integração.
      Observação: o menu suspenso Regiões lista apenas as regiões provisionadas no projeto do Google Cloud. Para provisionar uma nova região, clique em Ativar região. Consulte Ativar nova região para obter mais informações.
   3. Selecione uma conta de serviço para a integração. Você pode mudar ou atualizar os detalhes da conta de serviço de uma integração a qualquer momento no painel Resumo da integração na barra de ferramentas da integração.
      Observação: a opção de selecionar uma conta de serviço só vai aparecer se você tiver ativado a governança de integração para a região selecionada.
   4. Clique em Criar.

   Isso abre a integração na página do editor de integração.

4. Na barra de navegação do editor de integração, clique em Tarefas para conferir a lista de tarefas e conectores disponíveis.
5. Clique e coloque o elemento Secret Manager - Access no editor de integração.
6. Clique no elemento Secret Manager - Access no designer para ver o painel de configuração da tarefa Secret Manager - Access.
7. Acesse Autenticação e selecione o perfil de autenticação que você quer usar.

   Opcional. Se você não tiver criado um perfil de autenticação antes de configurar a tarefa, clique em + Novo perfil de autenticação e siga as etapas em Criar um novo perfil de autenticação.

8. Acesse Entrada de tarefas e configure os campos de entrada exibidos com a tabela Parâmetros de entrada de tarefas.

   As mudanças nos campos de entrada são salvas automaticamente.

Parâmetros de entrada da tarefa

A tabela a seguir descreve os parâmetros de entrada da tarefa Secret Manager - Access:

Propriedade	Tipo de dados	Descrição
Projectsid	String	É o ID do seu projeto no Google Cloud.
Secretsid	String	O ID do secret.
Versionsid	String	O ID da versão ou alias do seu secret. Para acessar a versão mais recente de um secret, especifique latest como o ID da versão.

Saída da tarefa

A tarefa Secret Manager - Access retorna a resposta payload.data, que contém o conteúdo codificado em Base64 da versão do secret. É necessário decodificar o valor codificado em base64 para receber a string de saída.

Dica: é possível codificar ou decodificar dados em base64 usando o comando base64 no Linux ou macOS ou Base64.exe no Windows. As linguagens de programação e de script normalmente incluem bibliotecas para codificação em Base64. Para exemplos de linha de comando, consulte Decodificar base64 na documentação do Cloud Text-to-Speech.

Estratégia de solução de erros

A estratégia de solução de erros para uma tarefa especifica a ação a ser realizada se a tarefa falhar devido a um erro temporário. Para mais informações sobre como usar uma estratégia de tratamento de erros e conhecer os diferentes tipos de estratégias de tratamento de erros, consulte Estratégias de tratamento de erros.

Cotas e limites

Para informações sobre o assunto, consulte Cotas e limites.

A seguir

• Adicione bordas e condições de borda.
• Teste e publique sua integração.
• Configure um gatilho.
• Adicione uma tarefa de mapeamento de dados.
• Confira todas as tarefas para os serviços do Google Cloud.