Plugin gerador HMAC-SHA256 (obsoleto) para grupos de agentes Jitterbit em nuvem e privados

Introdução

O plugin gerador HMAC-SHA256 gera uma assinatura de mensagem usando a função hash SHA-256. A assinatura é retornada como uma string codificada em hexadecimal na variável de saída Jitterbit.HMACSHA256.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.

Baixar e adicionar o plugin

O plugin gerador HMAC-SHA256 é 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.

Harmony

• Jitterbit HMAC-SHA256 Generator 1.2.0.0 (ZIP)
• Jitterbit HMAC-SHA256 Generator 1.1.0.0 (ZIP)
• Jitterbit HMAC-SHA256 Generator 1.0.0.0 (ZIP)

v5.x

• Jitterbit HMAC-SHA256 Generator 1.0.0 (ZIP)

Associar o plugin a um grupo de agentes

Todas as versões Harmony do plugin gerador HMAC-SHA256 estão associadas por padrão aos grupos de agentes em nuvem Jitterbit. Recomenda-se usar a versão 1.2.0.0.

Se estiver usando um grupo de agentes privados, antes de usar o plugin, é necessário associá-lo ao grupo de agentes privados 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 exibido Gerador HMAC-SHA256 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:

• Plugins (Estúdio de Integração)
• Plugins (Estúdio de Design)

Para usar o plugin Gerador HMAC-SHA256, 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

Output

Exemplo 1

Este script de exemplo define as variáveis usadas como entrada para o plugin HMAC-SHA256 Generator e executa o plugin.

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

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

O resultado da execução deste script é HMAC Signature: 52d7189b38b924d7ff81e70f1825993363df5bac2ffb2a03c73a0dbb4638759d.

Exemplo 2 (AWS)

Este exemplo utiliza scripting para autenticar com a API REST da AWS usando a Versão 4 da Assinatura AWS. O primeiro script define as variáveis usadas como entrada para o plugin HMAC-SHA256 Generator e executa o plugin. O segundo script é para obter a Assinatura AWS usando o primeiro script.

Exemplos dos valores que você precisa passar para a Versão 4 da Assinatura AWS podem ser encontrados na documentação da AWS Autenticando solicitações (versão 4 da assinatura AWS). Para assistência adicional, por favor entre em contato com o suporte.

<trans>
ArgumentList(key, message, encoding, keyEncoded, messageEncoded);

encoding = IfEmpty(encoding, "UTF-8");
keyEncoded = IfEmpty(keyEncoded, False);
messageEncoded = IfEmpty(messageEncoded, False);

$Jitterbit.HMACSHA256.Key = key;
$Jitterbit.HMACSHA256.Message = message;
$Jitterbit.HMACSHA256.Encoding = encoding;
$Jitterbit.HMACSHA256.Base64EncodedKey = keyEncoded;
$Jitterbit.HMACSHA256.Base64EncodedMessage = messageEncoded;
eval(RunPlugin("<TAG>plugin:http://www.jitterbit.com/plugins/pipeline/user/HMACSHA256Generator</TAG >"), $error=GetLastError());
$Jitterbit.HMACSHA256.Signature;
</trans>

<trans>
ArgumentList(key, dateStamp, regionName, serviceName, package);

keySecret = ("AWS4" + key);
keyDate = RunScript("<TAG>Scripts/Get HMAC-SHA256 Signature</TAG>", keySecret, dateStamp, "", False, False);
keyRegion = RunScript("<TAG>Scripts/Get HMAC-SHA256 Signature</TAG>", Base64Encode(HexToBinary(keyDate)), regionName, "", True, False);
keyService = RunScript("<TAG>Scripts/Get HMAC-SHA256 Signature</TAG>", Base64Encode(HexToBinary(keyRegion)), serviceName, "", True, False);
keySigned = RunScript("<TAG>Scripts/Get HMAC-SHA256 Signature</TAG>", Base64Encode(HexToBinary(keyService)), package, "", True, False);
</trans>