Consulte os conetores suportados para a solução Application Integration.

Cloud KMS – Tarefa de desencriptação

Pré-visualização

Esta funcionalidade está sujeita aos "Termos das Ofertas de Pré-DG" na secção Termos Gerais de Serviço dos Termos Específicos do Serviço. As funcionalidades de pré-DG estão disponíveis "tal como estão" e podem ter apoio técnico limitado. Para mais informações, consulte as descrições das fases de lançamento.

A tarefa Cloud KMS – desencriptar permite-lhe desencriptar texto cifrado ou dados que foram encriptados com uma chave do Cloud Key Management Service (Cloud KMS). Para desencriptar os dados encriptados, tem de usar a mesma chave que foi usada durante a encriptação. O texto descifrado devolvido pelo Cloud KMS está codificado em base64.

O Cloud KMS é um serviço do Google Cloud que lhe permite criar, importar e gerir chaves criptográficas, bem como realizar operações criptográficas num único serviço na nuvem centralizado.

Antes de começar

Certifique-se de que realiza as seguintes tarefas no seu projeto do Google Cloud antes de configurar a tarefa Cloud KMS – desencriptar:

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

   Ative a API Cloud Key Management Service (KMS)

2. Crie um perfil de autenticação. A integração de aplicações usa um perfil de autenticação para se ligar a um ponto final de autenticação para a tarefa Cloud KMS – desencriptar.
   Nota: se estiver a criar um perfil de autenticação do tipo Conta de serviço, certifique-se de que a conta de serviço tem atribuída a função do IAM que contém as seguintes autorizações do IAM:

   • cloudkms.cryptoKeyVersions.useToDecrypt

   Para saber mais sobre as autorizações de IAM e as funções de IAM predefinidas que as concedem, consulte a referência de autorizações de IAM.

   Para informações sobre como conceder funções ou autorizações adicionais a uma conta de serviço, consulte o artigo Conceder, alterar e revogar o acesso.

Configure a tarefa de desencriptação do Cloud KMS

1. Na Google Cloud consola, aceda à página Application Integration.

   Aceda à solução Application Integration

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

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

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

   Se estiver a criar uma nova integração:

   1. Introduza um nome e uma descrição no painel Criar integração.
   2. Selecione uma região para a integração.
      Nota: o menu pendente Regiões apenas apresenta as regiões aprovisionadas no seu projeto do Google Cloud. Para aprovisionar uma nova região, clique em Ativar região. Consulte o artigo Ative uma nova região para mais informações.
   3. Selecione uma conta de serviço para a integração. Pode alterar ou atualizar os detalhes da conta de serviço de uma integração em qualquer altura no painel Resumo da integração na barra de ferramentas de integração.
      Nota: a opção para selecionar uma conta de serviço é apresentada apenas se tiver ativado a gestão da integração para a região selecionada.
   4. Clique em Criar. A integração recém-criada é aberta no editor de integração.

4. Na barra de navegação do editor de integração, clique em Tasks para ver a lista de tarefas e conetores disponíveis.
5. Clique e coloque o elemento Cloud KMS – desencriptar no editor de integração.
6. Clique no elemento Cloud KMS – desencriptar no criador para ver o painel de configuração da tarefa Cloud KMS – desencriptar.
7. Aceda a Autenticação e selecione um perfil de autenticação existente que quer usar.

   Opcional. Se não tiver criado um perfil de autenticação antes de configurar a tarefa, clique em + Novo perfil de autenticação e siga os passos mencionados em Crie um novo perfil de autenticação.

8. Aceda a Entrada de tarefas e configure os campos de entrada apresentados através da seguinte tabela de parâmetros de entrada de tarefas.

   As alterações aos campos de entrada são guardadas automaticamente.

Parâmetros de entrada da tarefa

A tabela seguinte descreve os parâmetros de entrada da tarefa Cloud KMS – desencriptar:

Propriedade	Tipo de dados	Descrição
Região	String	Localização do Cloud KMS para o conjunto de chaves.
ProjectsId	String	O ID do seu projeto do Google Cloud.
KeyRingsId	String	Nome do conjunto de chaves onde a chave vai estar localizada.
CryptoKeysId	String	Nome da chave a usar para a desencriptação.
Pedido	JSON	Consulte a estrutura JSON do pedido. Especifique o texto encriptado (cifrado) a desencriptar no campo ciphertext do corpo do pedido.

Resultado da tarefa

A tarefa Cloud KMS - desencriptar devolve uma resposta que contém os dados desencriptados num formato codificado em base64. Tem de descodificar o valor codificado em base64 para obter a string de saída.

Sugestão: pode codificar ou descodificar dados em base64 através do comando base64 no Linux ou macOS, ou do comando Base64.exe no Windows. Normalmente, as linguagens de programação e scripting incluem bibliotecas para codificação base64. Para ver exemplos de linhas de comandos, consulte o artigo Descodifique base64 na documentação da Cloud Text-to-Speech.

Estratégia de processamento de erros

Uma estratégia de processamento de erros para uma tarefa especifica a ação a realizar se a tarefa falhar devido a um erro temporário. Para obter informações sobre como usar uma estratégia de processamento de erros e conhecer os diferentes tipos de estratégias de processamento de erros, consulte o artigo Estratégias de processamento de erros.

O que se segue?

1. Adicione limites e condições de limite.
2. Teste e publique a sua integração.
3. Configure um acionador.
4. Adicione uma tarefa de mapeamento de dados.
5. Veja todas as tarefas para os serviços Google Cloud.