Kryptografische Funktionen im Jitterbit Design Studio

Kryptografische Funktionen werden verwendet, um grundlegende Verschlüsselung und Entschlüsselung mit standardmäßigen Algorithmen und Funktionen durchzuführen.

Dateien mit Base-64 lesen und schreiben

Die Base64-Funktionen können beim Lesen und Schreiben von Dateien in den folgenden gängigen Szenarien verwendet werden:

Ein Szenario besteht darin, eine vorhandene Datei (vielleicht ein PDF) mit der Funktion Base64EncodeFile zu lesen und dann den Inhalt dieser Datei an einen Endpunkt, wie Salesforce, zu schreiben.

Um dies zu tun, erstellen Sie ein Skript, das die Datei aus einer Quelle liest und geeignete globale Variablen festlegt. Sie würden dann eine Transformation erstellen, die diese globalen Variablen verwendet und sie in einer Zuordnung nutzt, um nach Salesforce zu schreiben:

// Read a PDF File
$docName = "Test.pdf";
$fileContents = Base64EncodeFile("<TAG>Sources/PDF Files</TAG>", $docName);
$docLength = Length($fileContents);
$docType = "pdf";
$mimeType = "application/pdf";

Ein zweites Szenario besteht darin, aus einer Datei zu lesen, den Inhalt in eine Variable zu platzieren und dann die Funktion Base64Encode auf den Inhalt anzuwenden, bevor er in einer neuen Textdatei gespeichert wird.

AESDecryption

Deklaration

string AESDecryption(string encryptedText, string passphrase[, string salt, int keyLength, int iterations])

Syntax

AESDecryption(<encryptedText>, <passphrase>[, <salt>, <keyLength>, <iterations>])

Erforderliche Parameter

• encryptedText: Ein Base64-kodierter, mit AES verschlüsselter Wert
• passphrase: Passwort, das verwendet wird, um die Zeichenfolge mit der Funktion AESEncryption zu verschlüsseln

Optionale Parameter

• salt: Hex-String-Salz, das verwendet wird, um die Zeichenfolge mit der Funktion AESEncryption zu verschlüsseln
• keyLength: Schlüssellänge, die verwendet wird, um die Zeichenfolge mit der Funktion AESEncryption zu verschlüsseln
• iterations: Anzahl der Iterationen, die verwendet werden, um die Zeichenfolge mit der Funktion AESEncryption zu verschlüsseln

Beschreibung

Diese Funktion entschlüsselt eine mit dem AES-Algorithmus der Funktion AESEncryption verschlüsselte Zeichenfolge.

Die entschlüsselte Ausgabe wird als Zeichenfolge zurückgegeben. Siehe AESEncryption für weitere Details.

Beispiele

// Encrypting a string
encrypted = AESEncryption("Hello world!", "password");
// Decrypted as "Hello world!"
decrypted = AESDecryption(encrypted, "password");

// Encrypting (and decrypting) a string using
// a passphrase and salt, 256-bit key, and 1024 iterations
encrypted = AESEncryption("Hello world!", "password", "00FFAE01", 256, 1024);
decrypted = AESDecryption(encrypted, "password", "00FFAE01", 256, 1024);

AESDecryptionEx

Deklaration

string AESDecryptionEx(string encryptedText, string key[, string iv, int keyLength>])

Syntax

AESDecryptionEx(<encryptedText>, <key>[, <iv>, <keyLength>])

Erforderliche Parameter

• encryptedText: Ein Base64-kodierter, von OpenSSL 3 unterstützter AES-verschlüsselter String
• key: Der Schlüssel, der verwendet wurde, um encryptedText zu verschlüsseln

Optionale Parameter

• iv: Der 16-Byte-Initialisierungsvektor (IV), der verwendet wurde, um encryptedText zu verschlüsseln
• keyLength: Die Schlüssellänge, die verwendet wurde, um encryptedText zu verschlüsseln

Beschreibung

Diese Funktion entschlüsselt einen String, der mit einem AES-Algorithmus unter Verwendung von OpenSSL 3 verschlüsselt wurde. Dies umfasst Texte, die außerhalb der Jitterbit Harmony-Plattform verschlüsselt wurden, sowie Texte, die mit der Funktion AESEncryptionEx verschlüsselt wurden. Diese Funktion wird unterstützt, wenn Design Studio-Versionen 11.42 oder höher und Agent-Versionen 11.42 oder höher verwendet werden.

Die entschlüsselte Ausgabe wird als String zurückgegeben. Siehe AESEncryptionEx für die Verschlüsselung.

Beispiele

// Verschlüsseln (und entschlüsseln) eines Strings mit einem 128-Bit-Schlüssel und 16-Byte-IV
encrypted = AESEncryptionEx("Hallo Welt!", "123456ZYXWVUTSRQ", "12345XYZ12345XYZ", 128);
decrypted = AESDecryptionEx(encrypted, "123456ZYXWVUTSRQ", "12345XYZ12345XYZ", 128);

AESEncryption

Deklaration

string AESEncryption(string plainText, string passphrase[, string salt, int keyLength, int iterations])

Syntax

AESEncryption(<plainText>, <passphrase>[, <salt>, <keyLength>, <iterations>])

Erforderliche Parameter

• plainText: Ein zu verschlüsselnder String
• passphrase: Passwort, das zur Verschlüsselung des Strings verwendet wird

Optionale Parameter

• salt: Hex-String-Salz, das zur Verschlüsselung des Strings verwendet wird; wenn angegeben, muss der Wert im Hex-Format angegeben werden (zum Beispiel "A034DD")
• keyLength: Schlüssellänge, die zur Verschlüsselung des Strings verwendet werden soll und einer der Werte 128, 192 oder 256 sein muss; der Standardwert ist 256
• iterations: Anzahl der Iterationen, die zur Generierung des Schlüssels verwendet werden; der Standardwert ist 1

Beschreibung

Diese Funktion verschlüsselt einen String mit einem AES-Algorithmus, der mit der Funktion AESDecryption entschlüsselt werden kann. Der Schlüssel wird gemäß der Password-Based Cryptography Specification Version 2.0 (PKCS5S2) generiert.

Die verschlüsselte Ausgabe ist ein Base64-kodierter String. Die Ausgabe von AESEncryption kann direkt an die Funktion AESDecryption zur Entschlüsselung übergeben werden, wobei die gleichen Parameter wie bei der Verschlüsselung des Klartext-Strings verwendet werden.

Beispiele

// Encrypting a string
encrypted = AESEncryption("Hello world!", "password");
// Decrypted as "Hello world!"
decrypted = AESDecryption(encrypted, "password");

// Encrypting (and decrypting) a string using
// a passphrase and salt, 256-bit key, and 1024 iterations
encrypted = AESEncryption("Hello world!", "password", "00FFAE01", 256, 1024);
decrypted = AESDecryption(encrypted, "password", "00FFAE01", 256, 1024);

AESEncryptionEx

Deklaration

string AESEncryptionEx(string plainText, string key[, string iv, int keyLength])

Syntax

AESEncryptionEx(<plainText>, <key>[, <iv>, <keyLength>])

Erforderliche Parameter

• plainText: Der zu verschlüsselnde String
• key: Der Schlüssel, der zur Verschlüsselung von plainText verwendet wird

Optionale Parameter

• iv: Der 16-Byte-Initialisierungsvektor (IV), der zur Verschlüsselung von plainText verwendet wird; ein Fehler wird ausgelöst, wenn der IV nicht 16 Bytes beträgt
• keyLength: Die Schlüssellänge, die zur Verschlüsselung von plainText verwendet wird und einer der Werte 128, 192 oder 256 sein muss; der Standardwert ist 256

Beschreibung

Diese Funktion verschlüsselt einen String mit einem AES-Algorithmus unter Verwendung von OpenSSL 3. Diese Funktion wird unterstützt, wenn Design Studio-Versionen 11.42 oder höher und Agent-Versionen 11.42 oder höher verwendet werden.

Die verschlüsselte Ausgabe ist ein von OpenSSL 3 unterstützter, Base64-kodierter String. Die Ausgabe von AESEncryptionEx kann direkt an die AESDecryptionEx Funktion oder außerhalb der Jitterbit Harmony-Plattform zur Entschlüsselung übergeben werden, wobei dieselben Parameter wie bei der Verschlüsselung des Klartext-Strings verwendet werden.

Beispiele

// Verschlüsselung (und Entschlüsselung) eines Strings mit einem 128-Bit-Schlüssel und 16-Byte-IV
encrypted = AESEncryptionEx("Hallo Welt!", "123456ZYXWVUTSRQ", "12345XYZ12345XYZ", 128);
decrypted = AESDecryptionEx(encrypted, "123456ZYXWVUTSRQ", "12345XYZ12345XYZ", 128);

Base64Decode

Deklaration

binary Base64Decode(string encryptedText)

Syntax

Base64Decode(<encryptedText>)

Required parameters

• encryptedText: Ein Base64-kodierter String

Description

Dekodiert einen Base64-kodierten String und gibt binäre Daten zurück. Siehe auch Base64Encode.

Examples

// Encrypting a string after first converting it to binary
binary = HexToBinary(StringToHex("Hello world!"));
encrypted = Base64Encode(binary);

decrypted = Base64Decode(encrypted);
result = HexToString(BinaryToHex(decrypted));
// Returns original string "Hello world!"

Base64Encode

Declaration

string Base64Encode(type arg)

Syntax

Base64Encode(<arg>)

Required parameters

• arg: Wert, der kodiert werden soll

Description

Kodiert die Argumentdaten und behandelt die Zeichen in einem String als binäre Daten, es sei denn, die Eingabe ist bereits binär. Wenn der Typ des Arguments nicht binär oder ein String ist, wird der Argumentwert vor der Verschlüsselung zuerst in einen String umgewandelt.

Ein Zeilenumbruchzeichen (\n) wird nach jedem 64. Zeichen des kodierten Ergebnisstrings hinzugefügt. Da viele Implementierungen von Base64 Zeilenumbrüche enthalten, um die maximale Zeilenlänge des kodierten Ergebnisses zu begrenzen, sollte dies nur bei Bedarf ausdrücklich deaktiviert werden. Um dies zu deaktivieren, setzen Sie die jitterbit.base64.encoded.string.no.wrap Jitterbit-Variable auf true, bevor Sie diese Funktion aufrufen. Diese Variable wird mit String-Daten bei Verwendung von Agenten 10.49 und später sowie mit binären Daten bei Verwendung von Agenten 10.x 10.66 und später und 11.x Agenten 11.4 und später unterstützt.

Siehe auch Base64Decode.

Examples

// Encrypting a string after first converting it to binary
binary = HexToBinary(StringToHex("Hello world!"));
encrypted = Base64Encode(binary);

decrypted = Base64Decode(encrypted);
result = HexToString(BinaryToHex(decrypted));
// Returns original string "Hello world!"

encrypted = Base64Encode(Now());
decrypted = Base64Decode(encrypted);
result = HexToString(BinaryToHex(decrypted));
// Returns a date string such as "2017-12-14 01:25:31"

// Encrypting credentials for use in an HTTP header
Base64Encode("exampleuser"+":"+"examplepassword")

Base64EncodeFile

Deklaration

string Base64EncodeFile(string sourceId[, string filename])

Syntax

Base64EncodeFile(<sourceId>[, <filename>])

Erforderliche Parameter

• sourceId: Eine Zeichenfolge, die in dem aktuellen Projekt eine Binärdatei zurückgibt. Wenn ein Array von Dateinamen zurückgegeben wird, wird der erste verwendet.

Optionale Parameter

• filename: Eine Zeichenfolge, die als Dateiname verwendet wird, um den Wert zu überschreiben, der von der sourceId-Quelle zurückgegeben wird.

Beschreibung

Liest eine Binärdatei aus der angegebenen Quelle und gibt den Inhalt als Base64-kodierte Zeichenfolge zurück. Diese Methode wird allgemein für Dateien verwendet, die binär sein könnten. Um eine Textdatei zu lesen, verwenden Sie stattdessen die Funktion ReadFile.

Die in dieser Funktion verwendete Dateitypquelle muss als Quelle im aktuellen Projekt definiert sein. Siehe die Anweisungen zum Einfügen von Projektelementen.

Diese Methode gibt den Inhalt der Datei zurück, auf die von der angegebenen Quelle verwiesen wird. Wenn der Quellfilter mehr als eine Datei auswählt, wird die erste verwendet. Es wird empfohlen, eine Quelle anzugeben, die eine einzelne Datei eindeutig identifiziert.

Der zweite Parameter, filename, ist optional und kann verwendet werden, um den in der Quelldefinition zurückgegebenen Dateinamen zu überschreiben. Alternativ kann eine globale Variable verwendet werden, um den Dateinamen in der Quelldefinition zu überschreiben. Globale Variablen werden in der Quelldefinition als [de_name] referenziert.

Wenn eine Datei nicht gefunden wird, wird ein Fehler ausgelöst.

Ein Zeilenumbruchzeichen (\n) wird nach jedem 64. Zeichen der kodierten Ergebniszeichenfolge hinzugefügt. Da viele Implementierungen von Base64 Zeilenumbrüche enthalten, um die maximale Zeilenlänge des kodierten Ergebnisses zu begrenzen, sollte dies nur bei Bedarf ausdrücklich deaktiviert werden. Um dies zu deaktivieren, setzen Sie die jitterbit.base64.encoded.string.no.wrap Jitterbit-Variable auf true, bevor Sie diese Funktion aufrufen. Diese Variable wird mit Zeichenfolgendaten unterstützt, wenn Sie 10.49-Agenten und höher verwenden, und mit Binärdaten, wenn Sie 10.x-Agenten 10.66 und höher sowie 11.x-Agenten 11.4 und höher verwenden.

Siehe auch Base64Decode.

Beispiele

// Reads the first file found at the source "Word Documents FTP"
// and returns it as Base64-encoded string
fileContents1 = Base64EncodeFile("<TAG>Sources/Word Documents FTP</TAG>");

// Reads the binary file called "requirements.doc" from
// the FTP directory defined by the source "Word Documents FTP"
fileContents2 = Base64EncodeFile("<TAG>Sources/Word Documents FTP</TAG>",
    "requirements.doc");
// Decodes the file contents; they can now be re-written
// as a binary file to another target
fileContents2Decoded = Base64Decode(fileContents2);

MD5

Deklaration

string MD5(type arg)

Syntax

MD5(<arg>)

Erforderliche Parameter

• arg: Wert, der gehasht werden soll

Beschreibung

Wendet die MD5-Hashfunktion auf das übergebene Argument an. Der Hash wird als eine Zeichenkette von 32 hexadezimalen Zahlen zurückgegeben. Nicht-Zeichenfolgendaten werden zuerst in eine Zeichenfolge umgewandelt.

Beispiele

MD5("hello world!");
// Gibt "fc3ff98e8c6a0d3087d515c0473f8677" zurück

MD5AsTwoNumbers

Deklaration

array MD5AsTwoNumbers(type arg)

Syntax

MD5AsTwoNumbers(<arg>)

Erforderliche Parameter

• arg: Wert, der gehasht werden soll

Beschreibung

Wendet die MD5-Hashfunktion auf eine Eingabezeichenfolge an und gibt das Ergebnis als ein Array mit zwei 64-Bit-Zahlen zurück. Nicht-Zeichenfolgendaten werden zuerst in eine Zeichenfolge umgewandelt.

Beispiele

MD5AsTwoNumbers("hello world!");
// Gibt "{8612640914790536583, 3462540840444444668}" zurück

SHA256

Deklaration

string SHA256(type arg)

Syntax

SHA256(<arg>)

Erforderliche Parameter

• arg: Wert, der gehasht werden soll

Beschreibung

Wendet die SHA-256-Hashfunktion auf einen Eingabestring an. Der zurückgegebene Hash ist ein String aus 64 hexadezimalen Zahlen.

Wenn die Eingabe ein String ist, wird sie zuerst in die UTF-8-Byte-Darstellung konvertiert. Nicht-String-Daten werden zuerst in einen String konvertiert.

Beispiele

SHA256("hello world!");
// Gibt "7509e5bda0c762d2bac7f90d758b5b2263fa01ccbc542ab5e3df163be08e6ca9" zurück