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

Introducción

El plugin 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 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 plugin generador de HMAC-SHA256 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 agregado a la organización.

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

Harmony

• Jitterbit HMAC-SHA256 Generator 1.2.0.0 (ZIP)
• Jitterbit HMAC-SHA256 Generator 1.1.0.0 (ZIP)
• Jitterbit HMAC-SHA256 Generator 1.0.0.0 (ZIP)

v5.x

• Jitterbit HMAC-SHA256 Generator 1.0.0 (ZIP)

Asociar el plugin con un grupo de agentes

Todas las versiones de Harmony del plugin generador de HMAC-SHA256 se asocian con grupos de agentes en la nube de Jitterbit por defecto. Recomendamos utilizar la versión 1.2.0.0.

Si utilizas un grupo de agentes privados, antes de poder usar el plugin debes asociarlo 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 para mostrar Jitterbit HMAC-SHA256 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:

• Plugins (Studio)
• Plugins (Design Studio)

Para usar el plugin generador de HMAC-SHA256, se deben establecer todas las variables globales requeridas en un script para usarlas con el plugin. La tabla de entrada a continuación documenta todas las variables posibles para este plugin. La tabla de salida documenta la variable de firma que genera el plugin.

Entrada

Salida

Ejemplo 1

Este script de ejemplo establece las variables utilizadas como entrada para el plugin HMAC-SHA256 Generator y también ejecuta el plugin.

<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 HMAC Signature: 52d7189b38b924d7ff81e70f1825993363df5bac2ffb2a03c73a0dbb4638759d.

Ejemplo 2 (AWS)

Este ejemplo utiliza scripts para autenticarse con la API REST de AWS usando AWS Signature Version 4. El primer script establece las variables utilizadas como entrada para el plugin HMAC-SHA256 Generator y ejecuta el plugin. El segundo script sirve para obtener la firma de AWS usando el primer script.

Encontrar ejemplos de los valores que necesitas pasar a AWS Signature Version 4 en la documentación de AWS Autenticar solicitudes (versión de firma de AWS 4). Para obtener más ayuda, contáctese con 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>