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

Cloud KMS: tarefa de descriptografia

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 Cloud KMS - decrypt permite descriptografar texto criptografado ou dados criptografados com uma chave do Cloud Key Management Service (Cloud KMS). Para descriptografar os dados, use a mesma chave usada durante a criptografia. O texto descriptografado retornado do Cloud KMS é codificado em Base64.

O Cloud KMS é um serviço do Google Cloud que permite criar, importar e gerenciar chaves criptográficas e realizar operações criptográficas em um único serviço de nuvem centralizado.

Antes de começar

Execute as tarefas a seguir no projeto do Google Cloud antes de configurar a tarefa Cloud KMS - decrypt.

1. Ative a API Cloud Key Management Service (KMS) (cloudkms.googleapis.com).

   Ativar a API Cloud Key Management Service (KMS)

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 Cloud KMS - decrypt.
   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:

   • cloudkms.cryptoKeyVersions.useToDecrypt

   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 de descriptografia do Cloud KMS

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 Cloud KMS - Decrypt no editor de integração.
6. Clique no elemento Cloud KMS - decrypt no designer para conferir o painel de configuração de tarefas Cloud KMS - decrypt.
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 Cloud KMS - decrypt:

Propriedade	Tipo de dados	Descrição
Região	String	Local do Cloud KMS para o keyring.
ProjectsId	String	É o ID do seu projeto no Google Cloud.
KeyRingsId	String	Nome do keyring em que a chave estará localizada.
CryptoKeysId	String	Nome da chave a ser usada para descriptografia.
Solicitação	JSON	Consulte Estrutura de solicitação JSON. Especifique o texto a ser descriptografado no campo ciphertext do corpo da solicitação.

Saída da tarefa

A tarefa Cloud KMS - decrypt retorna uma resposta que contém os dados descriptografados em um formato codificado em base64. É 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.

A seguir

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