Ir para o conteúdo

HMAC-SHA1 Generator

Introdução

O plugin HMAC-SHA1 Generator gera uma assinatura de mensagem usando a função de hash SHA-1. A assinatura é retornada como uma string codificada em hexadecimal na variável de saída Jitterbit.HMACSHA1.Signature.

Este plug-in está disponível por padrão em Jitterbit Grupos de Agentes em Nuvem e também pode ser associado a Grupos de Agentes Privados.

Importante

Os plug-ins fornecidos pelo Jitterbit estão obsoletos. Consulte Deprecação e suporte em Plugins.

Versões

A versão atual do plug-in é 1.1.1. Versões anteriores do plug-in também podem estar em uso:

  • 1.1.1: Executa em sistemas Linux além do Microsoft Windows.
  • 1.1.0: Aceita caracteres especiais como quebra de linha em teclas e mensagens. Adiciona suporte para chaves e mensagens codificadas em base64.
  • 1.0.0: Versão inicial.

Baixe e Adicione o Plug-in

O plugin HMAC-SHA1 Generator é um plugin Jitterbit padrão que já está disponível no Management Console Plugins e não precisa ser baixado ou adicionado à organização.

Se direcionado pelo Jitterbit Support, este plug-in pode ser baixado nos links fornecidos abaixo e adicionado à organização (consulte Adicionar novos plug-ins em Customizações > Plug-ins).

Associar o Plug-in a um Grupo de Agentes

As versões 1.1.1.0 e 1.0.0.0 do plug-in HMAC-SHA1 Generator estão associadas aos Grupos de Agentes em Nuvem Jitterbit por padrão. Recomendamos o uso da versão 1.1.1.0.

Se estiver usando um Grupo de Agentes Privados, antes de poder usar o plug-in, você deve associá-lo ao Grupo de Agentes Privados para disponibilizar o plug-in em todos os agentes do grupo (consulte Associar Grupos de Agente em Customizações > Plug-ins).

O plug-in está listado no Management Console Plugins com um nome de exibição de Jitterbit HMAC-SHA1 Generator.

Definir Variáveis e Usar o Plug-in em um Projeto

Consulte estes tópicos para obter informações sobre como usar plug-ins em um projeto:

Para usar o plug-in HMAC-SHA1 Generator, todas as variáveis globais necessárias devem ser definidas em um script para uso com o plug-in. A tabela de entrada abaixo documenta todas as variáveis possíveis para este plugin. A tabela de saída documenta a saída da variável de assinatura pelo plug-in.

Entrada

Nome Tipo Obrigatório Descrição
Jitterbit.HMACSHA1.Key Corda Obrigatório A chave secreta.
Jitterbit.HMACSHA1.Message Corda Obrigatório A mensagem para a qual criar uma assinatura.
Jitterbit.HMACSHA1.Encoding Corda Opcional A codificação a ser usada ao converter a chave e a mensagem em bytes. Por exemplo: UTF-8 ou ISO-8859-1. Se esse valor não for definido, a chave e a mensagem serão consideradas US-ASCII.
Jitterbit.HMACSHA1.Base64EncodedKey Booleano Opcional Definido como true para chaves codificadas em base64. O padrão é false. Se definido para true, o valor no Jitterbit.HMACSHA1.Key variável é tratada como um valor codificado em base64.

Nota

Disponível na versão 1.1 e posterior.
Jitterbit.HMACSHA1.Base64EncodedMessage Booleano Opcional Definido como true para mensagens codificadas em base64. O padrão é false. Se definido para true, o valor no Jitterbit.HMACSHA1.Message variável é tratada como um valor codificado em base64.

Nota

Disponível na versão 1.1 e posterior.

Saída

Nome Tipo Descrição
Jitterbit.HMACSHA1.Signature Corda A variável retorna a assinatura como uma string codificada em hexadecimal.

Exemplo

Este script de exemplo define as variáveis usadas como entrada para o plug-in HMAC-SHA1 Generator, bem como executa o plug-in.

<trans>
// Clear result:
$Jitterbit.HMACSHA1.Signature = "";

$Jitterbit.HMACSHA1.Key = "dGVzdA==";
$Jitterbit.HMACSHA1.Message = "Test";
$Jitterbit.HMACSHA1.Encoding = "UTF-8"; // optional
$Jitterbit.HMACSHA1.Base64EncodedKey = true;
$Jitterbit.HMACSHA1.Base64EncodedMessage = false;
eval(RunPlugin("<TAG>plugin:http://www.jitterbit.com/plugins/pipeline/user/HMACSHA1Generator</TAG>"), $error=GetLastError());
WriteToOperationLog("HMAC Signature: " + $Jitterbit.HMACSHA1.Signature);
</trans>

O resultado da execução deste script é HMAC Signature: 09106d4568a1c1205e900980482f932f170020b7.