Saltar al contenido

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

Introducción

El complemento 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 complemento está disponible de forma predeterminada en grupos de agentes de nube Jitterbit y también pueden asociarse con grupos de agentes privados.

Importante

Los complementos proporcionados por Jitterbit están obsoletos. Consulte Obsolescencia y soporte en Complementos.

Versiones

La versión actual del complemento es 1.1.1. Es posible que también se estén utilizando versiones anteriores del complemento:

  • 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. Agrega compatibilidad con claves y mensajes codificados en base64.
  • 1.0.0: Versión inicial.

Descargue y agregue el complemento

El complemento generador HMAC-SHA1 es un complemento Jitterbit estándar que ya está disponible en la Management Console Complementos página y no necesita descargarse ni agregarse a la organización.

Si el soporte lo indica, este complemento se puede descargar en los enlaces que se proporcionan a continuación y agregar a la organización.

Asociar el complemento con un grupo de agentes

Las versiones 1.1.1.0 y 1.0.0.0 del complemento Generador HMAC-SHA1 están asociadas con los grupos de agentes de la nube Jitterbit de forma predeterminada. Recomendamos utilizar la versión 1.1.1.0.

Si usa un grupo de agentes privados, antes de poder usar el complemento debe asociarlo con el grupo de agentes privados para que el complemento esté disponible en todos los agentes del grupo.

El complemento aparece en la Management Console Complementos página con el nombre de visualización Jitterbit HMAC-SHA1 Generator.

Establecer variables y utilizar el complemento en un proyecto

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

Para utilizar el complemento Generador HMAC-SHA1, las variables globales requeridas deben configurarse en un secuencia de comandos para su uso con el complemento. La tabla de entrada a continuación documenta todas las variables posibles para este complemento. La tabla de salida documenta la variable de firma generada por el complemento.

Aporte

Nombre Tipo Obligatorio Descripción
Jitterbit.HMACSHA1.Key Cadena Obligatorio La clave secreta.
Jitterbit.HMACSHA1.Message Cadena Obligatorio El mensaje para el cual se creará una firma.
Jitterbit.HMACSHA1.Encoding Cadena Opcional La codificación que se utilizará al traducir la clave y el mensaje a bytes. Por ejemplo: UTF-8 o ISO-8859-1 Si no se establece este valor, se supone que tanto la clave como el mensaje son US-ASCII.TABLEROWEND
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 el Jitterbit.HMACSHA1.Key La variable 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 el Jitterbit.HMACSHA1.Message La variable se trata como un valor codificado en base64.

Nota

Disponible en la versión 1.1 y posteriores.

Producción

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

Ejemplo

Este secuencia de comandos de ejemplo establece las variables utilizadas como entrada para el complemento Generador HMAC-SHA1 y también 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 secuencia de comandos es HMAC Signature: 09106d4568a1c1205e900980482f932f170020b7.