HMAC-SHA1 Generator
Introdução
O plugin HMAC-SHA1 Generator 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 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.
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 retornos de carro em chaves e mensagens. Adiciona suporte para chaves e mensagens codificadas em base64.
- 1.0.0: Versão inicial.
Baixe e Adicione o Plugin
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 orientado pelo suporte, este plugin pode ser baixado nos links fornecidos abaixo e adicionado à organização (veja Adicionar novos plugins em Personalizações > Plug-ins).
- Gerador Jitterbit HMAC-SHA1 1.1.1 (ZIP)
- Gerador Jitterbit HMAC-SHA1 1.1.0 (ZIP)
- Gerador Jitterbit HMAC-SHA1 1.0.0 (ZIP)
Associe o Plugin a um Grupo de Agentes
As versões 1.1.1.0 e 1.0.0.0 do plugin HMAC-SHA1 Generator são associadas aos grupos de agentes da nuvem Jitterbit por padrão. Recomendamos usar a versão 1.1.1.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 em todos os agentes do grupo (consulte Associar grupos de agentes em Personalizações > Plug-ins).
O plugin está listado no Management Console Plugins página com o nome de exibição Jitterbit HMAC-SHA1 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 plug-in Gerador HMAC-SHA1, quaisquer 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 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 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.HMACSHA1.Base64EncodedKey | Booleano | Opcional | Definir como true para chaves codificadas em base64. O padrão é false . Se definido como true , o valor em 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 | Definir como true para mensagens codificadas em base64. O padrão é false . Se definido como true , o valor em 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 | 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, bem como 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
.