Saltar al contenido

Generador de HMAC-SHA1 (obsoleto) para grupos de agentes en la nube y privados de Jitterbit

Introducción

El plugin Generador de 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 obsoletos.

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: Funciona en sistemas Linux además de Microsoft Windows.
  • 1.1.0: Acepta caracteres especiales como retornos de carro en claves y mensajes. Agrega soporte para claves y mensajes codificados en base64.
  • 1.0.0: Versión inicial.

Descargar y agregar el plugin

El plugin Generador de HMAC-SHA1 es un plugin estándar de Jitterbit que ya está disponible en la página de Plugins de la Consola de Administración y no necesita ser descargado o agregado a la organización.

Si lo indica el soporte, este plugin se puede descargar en los enlaces proporcionados a continuación y agregar 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 de HMAC-SHA1 están asociadas por defecto con los grupos de agentes en la nube de Jitterbit. Se recomienda utilizar la versión 1.1.1.0.

Si se utiliza un grupo de agentes privado, antes de poder usar el complemento, se debe asociar con el grupo de agentes privado para que el complemento esté disponible en todos los agentes del grupo.

El complemento se lista en la página de Complementos de la Consola de Administración con el nombre de visualización Generador HMAC-SHA1 de Jitterbit.

Establecer variables y usar el complemento en un proyecto

Consulte estos temas para obtener información sobre el uso de complementos en un proyecto:

Para usar el complemento Generador HMAC-SHA1, se deben establecer todas las variables globales requeridas en un script para su uso con el complemento. La tabla de entrada a continuación documenta todas las posibles variables para este complemento. La tabla de salida documenta la variable de firma que produce el complemento.

Entrada

Nombre Tipo Requerido Descripción
Jitterbit.HMACSHA1.Key Cadena Requerido La clave secreta.
Jitterbit.HMACSHA1.Message Cadena Requerido El mensaje para el cual se debe crear una firma.
Jitterbit.HMACSHA1.Encoding Cadena 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 Booleano Opcional Establecer 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 Booleano Opcional Establecer 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 Cadena La variable devuelve la firma como una cadena codificada en hexadecimal.

Ejemplo

Este script de ejemplo establece las variables utilizadas como entrada para el complemento Generador HMAC-SHA1, así como ejecuta el complemento.

<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 Firma HMAC: 09106d4568a1c1205e900980482f932f170020b7.