Ir para o conteúdo

Plugin Gerador HMAC-SHA1 (obsoleto) para grupos de agentes Jitterbit em nuvem e privados

Introdução

O plugin Gerador HMAC-SHA1 gera uma assinatura de mensagem usando a função 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 Jitterbit e também pode ser associado a grupos de agentes privados.

Importante

Plugins fornecidos pela Jitterbit estão obsoletos.

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 do Microsoft Windows.
  • 1.1.0: Aceita caracteres especiais, como quebras de linha, em chaves e mensagens. Adiciona suporte para chaves e mensagens codificadas em base64.
  • 1.0.0: Versão inicial.

Baixar e adicionar o plugin

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

Se solicitado 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 HMAC-SHA1 estão associadas por padrão aos grupos de agentes em nuvem Jitterbit. Recomendamos o uso da versão 1.1.1.0.

Se estiver usando um grupo de agentes privado, antes de usar o plugin, é necessário associá-lo ao grupo de agentes privado para torná-lo disponível em todos os agentes do grupo.

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

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 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 ser usada ao traduzir a chave e a mensagem em bytes. Por exemplo: UTF-8 ou ISO-8859-1. Se este valor não for definido, tanto a chave quanto a mensagem são assumidas como 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 é 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 é 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 Gerador HMAC-SHA1, além de executar 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.