Saltar al contenido

Plugin generador HMAC-SHA1 (deprecado) para grupos de agentes en la nube y privados de Jitterbit

Introducción

El plugin generador HMAC-SHA1 genera una firma de mensaje utilizando la función hash SHA-1. La firma se devuelve como una cadena codificada en hexadecimal en la variable de salida Jitterbit.HMACSHA1.Signature.

Este plugin está disponible por defecto en grupos de agentes en la nube de Jitterbit y también se puede asociar con grupos de agentes privados.

Importante

Los plugins proporcionados por Jitterbit están deprecados.

Para generar una firma HMAC en un proyecto de Studio sin utilizar un plugin, consulta Generar una firma HMAC-SHA256.

Versiones

La versión actual del plugin es 1.1.1. Las versiones anteriores del plugin también pueden estar en uso:

  • 1.1.1: Se ejecuta en sistemas Linux además de Microsoft Windows.
  • 1.1.0: Acepta caracteres especiales como retornos de carro en claves y mensajes. Añade compatibilidad con claves y mensajes codificados en base64.
  • 1.0.0: Versión inicial.

Descargar y añadir el plugin

El plugin generador HMAC-SHA1 es un plugin estándar de Jitterbit que ya está disponible en la página Plugins de la Consola de administración y no necesita ser descargado ni añadido a la organización.

Si el soporte técnico lo indica, este plugin se puede descargar en los enlaces proporcionados a continuación y añadirse a la organización.

Asociar el plugin con un grupo de agentes

Las versiones 1.1.1.0 y 1.0.0.0 del plugin generador HMAC-SHA1 se asocian con grupos de agentes en la nube de Jitterbit por defecto. Se recomienda utilizar la versión 1.1.1.0.

Si utilizas un grupo de agentes privados, antes de poder usar el plugin debe asociarse con el grupo de agentes privados para que el plugin esté disponible en todos los agentes del grupo.

El plugin aparece en la página Plugins de la Consola de administración con el nombre de visualización Jitterbit HMAC-SHA1 Generator.

Establecer variables y usar el plugin en un proyecto

Consulta estos temas para obtener información sobre cómo usar plugins en un proyecto:

Para usar el plugin generador HMAC-SHA1, cualquier variable global requerida debe establecerse en un script para su uso con el plugin. La tabla de entrada siguiente documenta todas las variables posibles para este plugin. La tabla de salida documenta la variable de firma que genera el plugin.

Entrada

Nombre Tipo Requerido Descripción
Jitterbit.HMACSHA1.Key String Requerido La clave secreta.
Jitterbit.HMACSHA1.Message String Requerido El mensaje para el cual se crea una firma.
Jitterbit.HMACSHA1.Encoding String Opcional La codificación a utilizar al traducir la clave y el mensaje a bytes. Por ejemplo: UTF-8 o ISO-8859-1. Si este valor no se establece, se asume que tanto la clave como el mensaje son US-ASCII.
Jitterbit.HMACSHA1.Base64EncodedKey Boolean Opcional Establece en true para claves codificadas en base64. El valor predeterminado es false. Si se establece en true, el valor en la variable Jitterbit.HMACSHA1.Key se trata como un valor codificado en base64.

Nota

Disponible en la versión 1.1 y posteriores.
Jitterbit.HMACSHA1.Base64EncodedMessage Boolean Opcional Establece en true para mensajes codificados en base64. El valor predeterminado es false. Si se establece en true, el valor en la variable Jitterbit.HMACSHA1.Message se trata como un valor codificado en base64.

Nota

Disponible en la versión 1.1 y posteriores.

Salida

Nombre Tipo Descripción
Jitterbit.HMACSHA1.Signature String La variable devuelve la firma como una cadena codificada en hexadecimal.

Ejemplo

Este script de ejemplo establece las variables utilizadas como entrada para el plugin del Generador HMAC-SHA1, además de ejecutar el 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>

El resultado de ejecutar este script es HMAC Signature: 09106d4568a1c1205e900980482f932f170020b7.