HMAC-SHA256 Generator Plugin (veraltet) für Jitterbit Cloud- und Private Agent Groups

Einführung

Das HMAC-SHA256 Generator Plugin generiert eine Nachrichtensignatur mit der SHA-256-Hashfunktion. Die Signatur wird als hexadecimal codierter String in der Ausgabevariable Jitterbit.HMACSHA256.Signature zurückgegeben.

Das Plugin ist standardmäßig auf Jitterbit Cloud Agent Groups verfügbar und kann auch mit Private Agent Groups 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 Console verfügbar ist und nicht heruntergeladen oder zur Organisation hinzugefügt werden muss.

Falls vom Support angewiesen, kann dieses Plugin unter den 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 Agent Group verknüpfen

Alle Harmony-Versionen des HMAC-SHA256 Generator Plugins sind standardmäßig mit Jitterbit Cloud Agent Groups verknüpft. Wir empfehlen die Verwendung von Version 1.2.0.0.

Bei Verwendung einer Private Agent Group muss man das Plugin mit der Private Agent Group verknüpfen, bevor man es nutzen kann, um es auf allen Agenten in der Gruppe verfügbar zu machen.

Das Plugin wird auf der Seite Plugins der Management Console mit dem Anzeigenamen Jitterbit HMAC-SHA256 Generator aufgelistet.

Variablen einstellen und Plugin in einem Projekt verwenden

Informationen zur Verwendung von Plugins in einem Projekt finden Sie in diesen Themen:

• Plugins (Studio)
• Plugins (Design Studio)

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

Eingabe

Ausgabe

Beispiel 1

Dieses Beispielskript legt die als Eingabe für das HMAC-SHA256-Generator-Plugin verwendeten Variablen fest und führt 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 Signature: 52d7189b38b924d7ff81e70f1825993363df5bac2ffb2a03c73a0dbb4638759d.

Beispiel 2 (AWS)

Dieses Beispiel nutzt Scripting zur Authentifizierung mit der AWS REST API unter Verwendung von AWS Signature Version 4. Das erste Skript legt die als Eingabe für das HMAC-SHA256-Generator-Plugin verwendeten Variablen fest und führt das Plugin aus. Das zweite Skript dient zum Abrufen der AWS-Signatur unter Verwendung des ersten Skripts.

Beispiele für die Werte, die an AWS Signature Version 4 übergeben werden müssen, finden Sie in der AWS-Dokumentation Requests authentifizieren (AWS signature version 4). Für weitere 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>