Ir para o conteúdo

Plugin gerador de HMAC-SHA1 (descontinuado) para grupos de agentes em nuvem e privados do Jitterbit

Introdução

O plugin gerador de HMAC-SHA1 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 plugin está disponível por padrão nos grupos de agentes em nuvem do Jitterbit e também pode ser associado aos grupos de agentes privados.

Importante

Os plugins fornecidos pelo Jitterbit são descontinuados.

Para gerar uma assinatura HMAC em um projeto do Studio sem usar um plugin, consulte Gerar uma assinatura HMAC-SHA256.

Versões

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

  • 1.1.1: Funciona em sistemas Linux além de Microsoft Windows.
  • 1.1.0: Aceita caracteres especiais como retornos de carro em chaves e mensagens. Adiciona suporte para chaves e mensagens codificadas em base64.
  • 1.0.0: Versão inicial.

Fazer download e adicionar o plugin

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

Se direcionado pelo suporte, este plugin pode ser baixado nos links fornecidos abaixo e adicionado à organização.

Associar o plugin a um grupo de agentes

As versões 1.1.1.0 e 1.0.0.0 do plugin gerador de HMAC-SHA1 são associadas aos grupos de agentes em nuvem do Jitterbit por padrão. Recomenda-se usar a versão 1.1.1.0.

Ao usar um grupo de agentes privados, antes de poder usar o plugin, você deve associá-lo ao grupo de agentes privados para disponibilizá-lo em todos os agentes do grupo.

O plugin está listado na página Plugins do Management Console com um nome de exibição de Jitterbit HMAC-SHA1 Generator.

Definir variáveis e usar o plugin em um projeto

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

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

Entrada

Nome Tipo Obrigatório Descrição
Jitterbit.HMACSHA1.Key String Obrigatório A chave secreta.
Jitterbit.HMACSHA1.Message String Obrigatório A mensagem para a qual criar uma assinatura.
Jitterbit.HMACSHA1.Encoding String Opcional A codificação a usar ao converter a chave e a mensagem em bytes. Por exemplo: UTF-8 ou ISO-8859-1. Se este valor não for definido, assume-se que tanto a chave quanto a mensagem são US-ASCII.
Jitterbit.HMACSHA1.Base64EncodedKey Boolean Opcional Defina como true para chaves codificadas em base64. O padrão é false. Se definido como true, o valor na variável Jitterbit.HMACSHA1.Key será tratado como um valor codificado em base64.

Nota

Disponível na versão 1.1 e posteriores.
Jitterbit.HMACSHA1.Base64EncodedMessage Boolean Opcional Defina como true para mensagens codificadas em base64. O padrão é false. Se definido como true, o valor na variável Jitterbit.HMACSHA1.Message será tratado como um valor codificado em base64.

Nota

Disponível na versão 1.1 e posteriores.

Saída

Nome Tipo Descrição
Jitterbit.HMACSHA1.Signature String 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 plugin HMAC-SHA1 Generator e também executa o plugin.

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