Base64-Verschlüsselung

Siehe auch: Base64-Entschlüsselung

Wertauflöser - Kurzfassung

Zweck: Liefert den Base64-codierten String zu einem geeigneten Eingabewert ("Inhalt", "Dokument", "Dateiinformation", "Dateireferenz", String).

Tooltip

• Verwendung: Als Eingabewert muss der Inhalt bereitgestellt werden, der im Rückgabewert als Base64-String wiedergegeben werden soll. Dafür kommen folgende Datentypen in Frage:

  • String

  • "Inhalt" (Content)

  • "Dokument" (Document)

  • "Dateiinformation" (FileInfo)

  • "Dateireferenz" (FileReferenz)

• Hinweis: Intern wird der Eingabewert immer in ein "Inhalt" (Content)-Objekt umgewandelt. Liegt als Eingabewert keiner der hier genannten Datentypen vor, dann lautet Rückgabewert "Kein Wert" ($null).

Der Base64-Verschlüsselung-Wertauflöser liefert den Base64-codierten String zu einem geeigneten Eingabewert.

• Als Eingabewert wird ein "Inhalt" (Content)-Datenobjekt erwartet, wobei ausgehend von folgenden Datentypen eine automatische Typumwandlung erfolgt:

  • Textwert (String)

  • "Dokument" (Document), s. Dokumente

  • "Dateiinformation" ( FileInfo), s. Datei

  • "Dateireferenz" (FileReferenz), s. Dateireferenz, Dateimanager
    
    

• Für alle anderen Datentypen als Eingabewert lautet der Rückgabewert immer "Kein Wert" ($null).
  
  

Hintergrund: Base64-Codierung

Der Base64-Code ist keine Verschlüsselung im kryptographischen Sinn. Es handelt sich lediglich um eine Abbildungsvorschrift zur Umwandlung von Binärdaten, durch die eine Folge von Bytes (Gruppen von 8 Bits) in einen Zeichensatz mit 64 "lesbaren" und gängigen Schriftzeichen ([A-Z][a-z][0-9]+/) übertragen wird.

Da 6-Bit nötig sind, um 64 Zeichen unterscheiden zu können, bildet eine Gruppe von 4 Base64-Codes (4 x 6bit = 24bit) je 3 unverschlüsselte Bytes bzw. auch Buchstaben eines ASCII-Texts ab.

Beispiel: Text: ABC → ASCII-Byte-Sequenz: {65, 66, 67}
→ Bits gruppiert á 8: {01000001, 01000010, 01000011}
→ Bits gruppiert á 6: {010000, 010100, 001001, 000011}
→ Base64-Wert/Code: {16/Q, 20/U, 9/J, 3/D} → Base64-Code: QUJD

►HINWEIS◄ Am Ende des Rückgabewerts können bis zu zwei Ist-Gleich-Zeichen (=) erscheinen, die nicht im Base64-Zeichensatzes enthalten sind und nur als Füllzeichen dienen, falls das 3 : 4-Ersetzungsschema aufgrund der Länge des Eingabewerts nicht komplett ausgeschöpft wird.
Beispiel: Text AB → {01000001, 01000010} → {010000, 010100, 001000, } → {16/Q, 20/U, 8/I, } → QUI=

Beispiel

In den Body einer E-Mail-Nachricht im HTML -Format soll eine Logo-Bilddatei eingebunden werden, die über den Dateimanager von Lobster Data Platform / Orchestration im Server-Filesystem hinterlegt wurde.

Der Inhalt der kleinen Bilddatei für das "Logo" soll nicht referenziert sondern über das Base64-Format direkt als Nutzlast für das src-Attribut eines img-Elements bereitgestellt werden.

Der HTML-Code für das img-Element soll vorab in einer Variablen mit dem Namen image bereitgestellt werden, auf die beim Zusammenstellen des E-Mail-Bodys (ggf. mehrfach) zugegriffen werden kann:

<img style="height:50px" src="data:<type>;charste:utf-8;base64,<Base64data>" alt="<fileName>" />

• <type> repräsentiert den Inhaltstyp der Datei (als String, z. B. image/png).

• <Base64data> definiert den Base64-codierten Dateiinhalt.

• <fileName> definiert den Dateinamen, der als Platzhalter erscheint, falls die Datei nicht darstellbar ist.

Konfiguration: