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

Einführung

Das HMAC-SHA256 Generator Plugin generiert eine Nachrichtensignatur mithilfe der SHA-256-Hashfunktion. Die Signatur wird als hexadezimal codierte Zeichenfolge in der Ausgabevariable zurückgegeben Jitterbit.HMACSHA256.Signature.

Dieses Plugin ist standardmäßig in Jitterbit-Cloud-Agent-Gruppen verfügbar und können auch mit privaten Agentengruppen verknüpft werden.

Laden Sie das Plugin herunter und fügen Sie es hinzu

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

Unter Anweisung des Supports kann dieses Plugin unter den unten angegebenen Links heruntergeladen und der 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)

Verknüpfen Sie das Plugin mit einer Agentengruppe

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

Wenn Sie eine private Agentengruppe verwenden, müssen Sie das Plugin-In vor der Verwendung mit der privaten Agentengruppe verknüpfen, um das Plugin-In für alle Agenten in der Gruppe verfügbar zu machen.

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

Festlegen von Variablen und Verwenden des Plugin in einem Projekt

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

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

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

Eingang

Ausgabe

Beispiel 1

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

Beispiel 2 (AWS)

In diesem Beispiel wird Skripting zur Authentifizierung mit der AWS REST API unter Verwendung von AWS Signature Version 4 verwendet. Das erste Script legt die Variablen fest, die als Eingabe für das HMAC-SHA256 Generator-Plugin verwendet werden, und führt das Plugin aus. Das zweite Script dient zum Abrufen der AWS-Signatur unter Verwendung des ersten Script.

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