HMAC-SHA256 Generator-Plugin (veraltet) für Jitterbit-Cloud- und private Agentengruppen

Einführung

Das HMAC-SHA256 Generator-Plugin erzeugt eine Nachrichtenunterschrift mithilfe der SHA-256-Hashfunktion. Die Unterschrift wird als hexadezimal codierte Zeichenfolge in der Ausgabewariable Jitterbit.HMACSHA256.Signature zurückgegeben.

Dieses Plugin ist standardmäßig in den Jitterbit-Cloud-Agentengruppen verfügbar und kann auch mit privaten Agentengruppen verknüpft werden.

Plugin herunterladen und hinzufügen

Das HMAC-SHA256 Generator-Plugin ist ein Standard-Jitterbit-Plugin, das bereits auf der Seite Plugins der Management-Konsole verfügbar ist und nicht heruntergeladen oder zur Organisation hinzugefügt werden muss.

Wenn dies vom Support angeordnet wird, kann dieses Plugin über die unten angegebenen Links heruntergeladen und zur Organisation hinzugefügt werden.

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)

Plugin mit einer Agentengruppe verknüpfen

Alle Harmony-Versionen des HMAC-SHA256 Generator-Plugins sind standardmäßig mit Jitterbit-Cloud-Agentengruppen verknüpft. Es wird empfohlen, die Version 1.2.0.0 zu verwenden.

Wenn eine private Agentengruppe verwendet wird, muss das Plugin, bevor es verwendet werden kann, mit der privaten Agentengruppe verknüpft werden, um das Plugin auf allen Agenten in der Gruppe verfügbar zu machen.

Das Plugin ist auf der Seite Plugins der Management-Konsole mit dem Anzeigenamen Jitterbit HMAC-SHA256 Generator aufgeführt.

Variablen festlegen und das Plugin in einem Projekt verwenden

Beziehen Sie sich auf diese Themen für Informationen zur Verwendung von Plugins in einem Projekt:

• Plugins (Integration Studio)
• Plugins (Design Studio)

Um das HMAC-SHA256 Generator-Plugin zu verwenden, müssen alle erforderlichen globalen Variablen in einem Skript festgelegt werden, das mit dem Plugin verwendet wird. Die folgende Eingabetabelle dokumentiert alle möglichen Variablen für dieses Plugin. Die Ausgabetabelle dokumentiert die Signaturvariable, die vom Plugin ausgegeben wird.

Eingabe

Ausgabe

Beispiel 1

Dieses Beispielskript setzt sowohl die Variablen, die als Eingabe für das HMAC-SHA256 Generator-Plugin verwendet werden, als auch das Plugin aus.

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

Das Ergebnis der Ausführung dieses Skripts ist HMAC-Signatur: 52d7189b38b924d7ff81e70f1825993363df5bac2ffb2a03c73a0dbb4638759d.

Beispiel 2 (AWS)

Dieses Beispiel verwendet Skripting, um sich mit der AWS REST API unter Verwendung der AWS-Signaturversion 4 zu authentifizieren. Das erste Skript setzt die Variablen, die als Eingabe für das HMAC-SHA256 Generator-Plugin verwendet werden, und führt das Plugin aus. Das zweite Skript dient dazu, die AWS-Signatur mit dem ersten Skript zu erhalten.

Beispiele für die Werte, die Sie an die AWS-Signaturversion 4 übergeben müssen, finden Sie in der AWS-Dokumentation Anfragen authentifizieren (AWS-Signaturversion 4). Für zusätzliche Unterstützung wenden Sie sich bitte an den Support.

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