Plugin gerador HMAC-SHA256 (obsoleto) para grupos de agentes privados e nuvem Jitterbit
Introdução
O plugin HMAC-SHA256 Generator 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 em grupos de agentes de nuvem Jitterbit e também pode ser associado a grupos de agentes privados.
Importante
Os plugins fornecidos pelo Jitterbit estão obsoletos. Veja Deprecation and support em Plugins.
Baixe e adicione o plugin
O plugin HMAC-SHA256 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 orientado pelo suporte, este plugin pode ser baixado nos links fornecidos abaixo e adicionado à organização.
Harmony
- Gerador Jitterbit HMAC-SHA256 1.2.0.0 (ZIP)
- Gerador Jitterbit HMAC-SHA256 1.1.0.0 (ZIP)
- Gerador Jitterbit HMAC-SHA256 1.0.0.0 (ZIP)
v5.x
Associe o plugin a um grupo de agentes
Todas as versões Harmony do plugin HMAC-SHA256 Generator são associadas a grupos de agentes de nuvem Jitterbit por padrão. Recomendamos usar a versão 1.2.0.0.
Se estiver usando um grupo de agentes privados, antes de poder usar o plugin, você deve associá-lo ao grupo de agentes privados para tornar o plugin disponível para todos os agentes do grupo.
O plugin está listado no Management Console Plugins página com o nome de exibição Jitterbit HMAC-SHA256 Generator.
Defina variáveis e use o plugin em um projeto
Consulte estes tópicos para obter informações sobre o uso de plugins em um projeto:
Para usar o plugin HMAC-SHA256 Generator, 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 saída da variável de assinatura pelo plugin.
Entrada
Nome | Tipo | Obrigatório | Descrição |
---|---|---|---|
Jitterbit.HMACSHA256.Key | String | Obrigatório | A chave secreta. |
Jitterbit.HMACSHA256.Message | String | Obrigatório | A mensagem para a qual criar uma assinatura. |
Jitterbit.HMACSHA256.Encoding | String | Opcional | A codificação a ser usada ao traduzir a chave e a mensagem para bytes (por exemplo, "UTF-8" ou "ISO-8859-1" ). Se esse valor não for definido, tanto a chave quanto a mensagem serão consideradas US-ASCII. |
Jitterbit.HMACSHA256.Base64EncodedKey | Booleano | Opcional | Definir como true para chaves codificadas em base64. O padrão é false . Se definido como true , o valor em Jitterbit.HMACSHA256.Key variável é tratada como um valor codificado em base64. |
Jitterbit.HMACSHA256.Base64EncodedMessage | Booleano | Opcional. | Definir como true para mensagens codificadas em base64. O padrão é false . Se definido como true , o valor em Jitterbit.HMACSHA256.Message variável é tratada como um valor codificado em base64. |
Saída
Nome | Tipo | Descrição |
---|---|---|
Jitterbit.HMACSHA256.Signature | String | A variável retorna a assinatura como uma string codificada em hexadecimal. |
Exemplo 1
Este script de exemplo define as variáveis usadas como entrada para o plugin HMAC-SHA256 Generator e também 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 usa script para autenticar com a AWS REST API usando a AWS Signature Versão 4. 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 AWS Signature usando o primeiro script.
Exemplos dos valores que você precisa passar para o AWS Signature versão 4 podem ser encontrados na documentação da AWS Autenticação de solicitações (AWS Signature versão 4). Para obter assistência adicional, 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>
Nota
O script acima usa referências de itens de projeto no Design Studio sintaxe. Para sintaxe a ser usada em Integration Studio, veja o RunScript
documentação.