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

Introducción

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

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

Descargar y agregar el plugin

El generador de HMAC-SHA256 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 el soporte lo indica, este plugin se puede descargar en los enlaces proporcionados a continuación y agregar a la organización.

Harmony

• Generador de HMAC-SHA256 de Jitterbit 1.2.0.0 (ZIP)
• Generador de HMAC-SHA256 de Jitterbit 1.1.0.0 (ZIP)
• Generador de HMAC-SHA256 de Jitterbit 1.0.0.0 (ZIP)

v5.x

• Generador de HMAC-SHA256 de Jitterbit 1.0.0 (ZIP)

Asociar el plugin con un grupo de agentes

Todas las versiones de Harmony del generador de HMAC-SHA256 están asociadas por defecto con los grupos de agentes en la nube de Jitterbit. Se recomienda utilizar la versión 1.2.0.0.

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

El complemento se lista en la página de la Consola de Administración Plugins con un nombre de visualización de Generador HMAC-SHA256 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:

• Plugins (Estudio de Integración)
• Plugins (Estudio de Diseño)

Para usar el complemento Generador HMAC-SHA256, 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

Output

Ejemplo 1

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

<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>

El resultado de ejecutar este script es Firma HMAC: 52d7189b38b924d7ff81e70f1825993363df5bac2ffb2a03c73a0dbb4638759d.

Ejemplo 2 (AWS)

Este ejemplo utiliza scripting para autenticarse con la API REST de AWS utilizando la Versión 4 de la Firma de AWS. El primer script establece las variables utilizadas como entrada para el complemento Generador HMAC-SHA256 y ejecuta el complemento. El segundo script es para obtener la Firma de AWS utilizando el primer script.

Ejemplos de los valores que necesita pasar a la Versión 4 de la Firma de AWS se pueden encontrar en la documentación de AWS Autenticando solicitudes (versión de firma de AWS 4). Para asistencia adicional, por favor contacte al soporte.

<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>