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

Cloud KMS: tarefa de criptografia

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 - encrypt permite criptografar texto ou conteúdo binário usando uma chave do Cloud Key Management Service (Cloud KMS). O texto ou o conteúdo binário precisa ser codificado em Base64 antes de ser criptografado pelo Cloud KMS. Para recuperar os dados criptografados, use a tarefa Cloud KMS - encrypt.

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 - encrypt.

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 - Encrypt.
   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.useToEncrypt

   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 criptografia 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 - encryption no editor de integração.
6. Clique no elemento Cloud KMS - encrypt no designer para ver o painel de configuração de tarefas Cloud KMS - encrypt.
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 - encrypt:

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 criptografia.
Solicitação	JSON	Consulte Estrutura de solicitação JSON. Especifique o texto codificado em base64 a ser criptografado no campo plaintext do corpo da solicitação. 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 ver exemplos de linha de comando, consulte Codificação Base64 na documentação da API Cloud Vision.

Saída da tarefa

A tarefa Cloud KMS - encrypt retorna uma resposta que contém os dados criptografados em um formato codificado em base64.

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.