Zum Inhalt springen

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

Einführung

Das HMAC-SHA1 Generator Plugin generiert eine Nachrichtensignatur mit der SHA-1 Hash-Funktion. Die Signatur wird als hexadezimal codierte Zeichenkette in der Ausgabevariablen Jitterbit.HMACSHA1.Signature zurückgegeben.

Dieses Plugin ist standardmäßig auf Jitterbit Cloud Agent Groups verfügbar und kann auch mit Private Agent Groups verknüpft werden.

Wichtig

Plugins von Jitterbit sind veraltet.

Um eine HMAC-Signatur in einem Studio-Projekt ohne Plugin zu generieren, siehe HMAC-SHA256-Signatur generieren.

Versionen

Die aktuelle Version des Plugins ist 1.1.1. Es können auch frühere Versionen des Plugins in Verwendung sein:

  • 1.1.1: Läuft auf Linux-Systemen sowie auf Microsoft Windows.
  • 1.1.0: Akzeptiert Sonderzeichen wie Wagenrückläufe in Schlüsseln und Nachrichten. Fügt Unterstützung für base64-codierte Schlüssel und Nachrichten hinzu.
  • 1.0.0: Anfangsversion.

Plugin herunterladen und hinzufügen

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

Falls vom Support angewiesen, kann dieses Plugin unter den folgenden Links heruntergeladen und zur Organization hinzugefügt werden.

Plugin mit einer Agent Group verknüpfen

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

Bei Verwendung einer Private Agent Group muss das Plugin vor der Verwendung mit der Private Agent Group verknüpft werden, um das Plugin auf allen Agents in der Gruppe verfügbar zu machen.

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

Variablen festlegen und das Plugin in einem Projekt verwenden

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

Zur Verwendung des HMAC-SHA1 Generator Plugins müssen erforderliche globale Variablen in einem Skript 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 ausgegebene Signaturvariable.

Eingabe

Name Type Erforderlich Beschreibung
Jitterbit.HMACSHA1.Key String Erforderlich Der geheime Schlüssel.
Jitterbit.HMACSHA1.Message String Erforderlich Die Nachricht, für die eine Signatur erstellt werden soll.
Jitterbit.HMACSHA1.Encoding String Optional Die Kodierung, die beim Übersetzen des Schlüssels und der Nachricht in Bytes verwendet werden soll. Beispiel: UTF-8 oder ISO-8859-1. Wenn dieser Wert nicht festgelegt ist, werden sowohl der Schlüssel als auch die Nachricht als US-ASCII angenommen.
Jitterbit.HMACSHA1.Base64EncodedKey Boolean Optional Setzen Sie auf true für base64-codierte Schlüssel. Der Standard ist false. Wenn auf true gesetzt, wird der Wert in der Variablen Jitterbit.HMACSHA1.Key als base64-codierter Wert behandelt.

Hinweis

Verfügbar in Version 1.1 und später.

Jitterbit.HMACSHA1.Base64EncodedMessage Boolean Optional Setzen Sie auf true für base64-codierte Nachrichten. Der Standard ist false. Wenn auf true gesetzt, wird der Wert in der Variablen Jitterbit.HMACSHA1.Message als base64-codierter Wert behandelt.

Hinweis

Verfügbar in Version 1.1 und später.

Ausgabe

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

Beispiel

Dieses Beispielskript legt sowohl die Variablen fest, die als Eingabe für das HMAC-SHA1-Generator-Plugin verwendet werden, als auch führt 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 Signature: 09106d4568a1c1205e900980482f932f170020b7.