Zum Inhalt springen

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

Einführung

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

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

Wichtig

Von Jitterbit bereitgestellte Plugins sind veraltet.

Versionen

Die aktuelle Version des Plugins ist 1.1.1. Frühere Versionen des Plugins können ebenfalls verwendet werden:

  • 1.1.1: Läuft zusätzlich auf Linux-Systemen neben Microsoft Windows.
  • 1.1.0: Akzeptiert Sonderzeichen wie Zeilenumbrüche in Schlüsseln und Nachrichten. Fügt Unterstützung für base64-codierte Schlüssel und Nachrichten hinzu.
  • 1.0.0: Erste Version.

Plugin herunterladen und hinzufügen

Das HMAC-SHA1 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.

Plugin mit einer Agentengruppe verknüpfen

Die Versionen 1.1.1.0 und 1.0.0.0 des HMAC-SHA1 Generator-Plugins sind standardmäßig mit Jitterbit-Cloud-Agentengruppen verknüpft. Wir empfehlen die Verwendung der Version 1.1.1.0.

Wenn Sie eine private Agentengruppe verwenden, müssen Sie das Plugin mit der privaten Agentengruppe verknüpfen, bevor Sie es verwenden können, um das Plugin auf allen Agenten in der Gruppe verfügbar zu machen.

Das Plugin wird in der Management-Konsole auf der Seite Plugins mit dem Anzeigenamen Jitterbit HMAC-SHA1 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:

Um das HMAC-SHA1 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

Name Typ Erforderlich Beschreibung
Jitterbit.HMACSHA1.Key Zeichenkette Erforderlich Der geheime Schlüssel.
Jitterbit.HMACSHA1.Message Zeichenkette Erforderlich Die Nachricht, für die eine Signatur erstellt werden soll.
Jitterbit.HMACSHA1.Encoding Zeichenkette Optional Die Kodierung, die verwendet werden soll, wenn der Schlüssel und die Nachricht in Bytes übersetzt werden. Zum Beispiel: UTF-8 oder ISO-8859-1. Wenn dieser Wert nicht festgelegt ist, wird davon ausgegangen, dass sowohl der Schlüssel als auch die Nachricht US-ASCII sind.
Jitterbit.HMACSHA1.Base64EncodedKey Boolean Optional Auf true setzen für base64-kodierte Schlüssel. Der Standardwert ist false. Wenn auf true gesetzt, wird der Wert in der Variablen Jitterbit.HMACSHA1.Key als base64-kodierter Wert behandelt.

Hinweis

Verfügbar in Version 1.1 und höher.
Jitterbit.HMACSHA1.Base64EncodedMessage Boolean Optional Auf true setzen für base64-kodierte Nachrichten. Der Standardwert ist false. Wenn auf true gesetzt, wird der Wert in der Variablen Jitterbit.HMACSHA1.Message als base64-kodierter Wert behandelt.

Hinweis

Verfügbar in Version 1.1 und höher.

Ausgabe

Name Typ Beschreibung
Jitterbit.HMACSHA1.Signature Zeichenkette Die Variable gibt die Signatur als hexadezimal kodierte Zeichenkette zurück.

Beispiel

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

<trans>
// Clear result:
$Jitterbit.HMACSHA1.Signature = "";

$Jitterbit.HMACSHA1.Key = "dGVzdA==";
$Jitterbit.HMACSHA1.Message = "Test";
$Jitterbit.HMACSHA1.Encoding = "UTF-8"; // optional
$Jitterbit.HMACSHA1.Base64EncodedKey = true;
$Jitterbit.HMACSHA1.Base64EncodedMessage = false;
eval(RunPlugin("<TAG>plugin:http://www.jitterbit.com/plugins/pipeline/user/HMACSHA1Generator</TAG>"), $error=GetLastError());
WriteToOperationLog("HMAC Signature: " + $Jitterbit.HMACSHA1.Signature);
</trans>

Das Ergebnis der Ausführung dieses Skripts ist HMAC-Signatur: 09106d4568a1c1205e900980482f932f170020b7.