Inhalt

Übersicht

Ab der Wrapper-Version 3.6.0 ermöglichen die Standard- und Professional-Editionen das Verschleiern von Passwörtern oder sensiblen Daten, um diese sicherer in Ihren Konfigurationsdateien zu speichern. Verschleierung ist von echter Verschlüsselung zu unterscheiden, bietet aber ein gewisses Maß an Sicherheit, indem der eigentliche Text oder das Passwort verborgen und es einem flüchtigen Betrachter sehr erschwert wird, sich den kodierten Wert zu merken.

Beim Laden der Konfiguration dekodiert der Wrapper alle verschleierten Token und markiert die Eigenschaftswerte, in denen sie referenziert werden, als sensibel. Ein als sensibel markierter Eigenschaftswert wird mit zusätzlichen Vorsichtsmaßnahmen behandelt, erstens indem sichergestellt wird, dass er aus einer sicheren Datei geladen wurde, und zweitens indem sichergestellt wird, dass er nur für den vorgesehenen Zweck ohne Offenlegung im Klartext verwendet wird.

Um die Verwendung von Eigenschaften auszuschließen, deren Werte in der Konsole, in E-Mails, Protokollen, der Befehlszeile usw. erscheinen können, dürfen nur eine begrenzte Menge von Eigenschaften verschleierte Token in ihren Werten enthalten. Die Verwendung in Variablendefinitionen ist ebenfalls untersagt, um ein Durchsickern in die Umgebung zu verhindern.

NOTE

Eigenschaften, die verschleierte Token in ihren Werten enthalten dürfen, sind auf die folgenden beschränkt:

Ein Eigenschaftswert, der sensible Daten enthält, wird mit den folgenden Sicherheitsvorkehrungen behandelt:

  • Die Berechtigungen der Datei, die den sensiblen Text enthält, werden überprüft, und zum Laden der Datei ist ein eingeschränkter Lesezugriff erforderlich. Bitte lesen Sie diese Seite für Details.

  • Jeder sensible Text wird in den Protokollen maskiert und durch eine Maske aus einer festen Anzahl von '*'-Zeichen ersetzt.

  • Der Eigenschaftswert darf nicht in der Java-Befehlszeile referenziert werden, um eine Offenlegung im Klartext in Prozesslisten-Tools wie "Task Manager" (unter Windows) oder "ps" (unter Unix) zu verhindern. Beachten Sie, dass wrapper.app.parameter.backend auf TRUE gesetzt sein muss, damit sensible Daten in Anwendungsparametern über den Backend-Kanal statt über die Befehlszeile übergeben werden können.

Es stehen mehrere Methoden zur Verfügung, um Ihre Passwörter zu kodieren/verschleiern. Für einige davon kann ein privater Schlüssel verwendet werden. Der Wrapper stellt Befehle bereit, um Ihre Daten zu kodieren und private Schlüssel zu generieren. Diese Seite beschreibt die Optionen für jeden Befehl.

WARNING

Die vom Wrapper angebotenen Verschleierungsmethoden sowie die oben beschriebenen zugehörigen Sicherheitsmaßnahmen sind in erster Linie dazu gedacht, das Durchsickern sensibler Daten im Klartext außerhalb der Java-Anwendung zu verhindern. Durch die Verwendung der Eigenschaften wrapper.app.property.<n> oder das Setzen von wrapper.app.parameter.backend auf TRUE können die Systemeigenschaften und Anwendungsparameter sicher an Ihre Java-Anwendung übergeben werden. Beachten Sie jedoch, dass diese Werte, sobald sie vom Java-Code empfangen wurden, als Klartext in Systemeigenschaften oder in einem String-Array gespeichert werden.

Bitte beachten Sie Folgendes:

- Jemand, der in den Besitz Ihrer verschleierten Geheimnisse (oder Konfigurationsdateien) gelangt, könnte eine einfache Java-Anwendung erstellen, um Systemeigenschaften auszugeben, den Wrapper zum Starten verwenden und so leicht Ihre Passwörter entdecken. Daher ist es wichtig, dass die Wrapper-Konfigurationsdateien mit sensiblen Daten stets nur für autorisierte Benutzer zugänglich sind. Deshalb prüft der Wrapper bei jedem Start die Berechtigungen sensibler Dateien und gibt Hinweise, wie diese angepasst werden können, aber es liegt an Ihnen, die Dateiberechtigungen tatsächlich zu ändern. Es wird außerdem empfohlen, eine Private-Key-Datei mit möglichst eingeschränkten Dateiberechtigungen zu verwenden.

- Jemand mit Zugriff auf Ihren Rechner könnte einen Debugger verwenden, um den Speicher Ihrer Java-Anwendung zu verfolgen und die String-Werte zu entdecken, in denen Klartext-Passwörter gespeichert sind. Stellen Sie stets sicher, dass Ihre Java-Anwendung in einer sicheren Umgebung ausgeführt wird.

Daten verschleiern

Kompatibel :3.6.0
Editionen :Professional EditionStandard EditionCommunity Edition (Not Supported)
Betriebssysteme :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

Der Befehl --cipher kann verwendet werden, um Passwörter oder sensible Daten mit dem Wrapper zu kodieren und die zugehörige "cipher"-Konfiguration zu erzeugen.

Um genau festzulegen, wie Ihre Werte kodiert werden sollen, werden beim Befehl --cipher mehrere Parameter benötigt. Der folgende Abschnitt beschreibt, wie jeder Parameter konfiguriert wird. Zunächst werfen wir jedoch einen Blick darauf, wie kodierte Werte in Ihrer Konfigurationsdatei aussehen. Die folgende Syntax wird verwendet:

%zrmVK5-Zp7qHptL9Yu66qr|<cipher_name>%

  • '% %' sind Trennzeichen für das kodierte Token,

  • 'zrmVK5-Zp7qHptL9Yu66qr' ist der kodierte Wert,

  • <cipher_name> ist eine Kennung für die Konfiguration, die zum Kodieren des Werts verwendet wird (siehe unten).

Die Kodierung des/der Wert(e) kann mit dem folgenden Satz von Eigenschaften konfiguriert werden.

  • wrapper.cipher.<n>.name: Kennung für die Kodierungskonfiguration mit Index <n>,

  • wrapper.cipher.<n>.method: Kodierungsmethode (siehe unten),

  • wrapper.cipher.<n>.private_keyfile: Pfad zum privaten Schlüssel.

Einige Methoden definieren eine Standardkonfiguration; in diesem Fall können die oben genannten Eigenschaften weggelassen werden. Solche Standardkonfigurationen verwenden keinen benutzerdefinierten privaten Schlüssel, und <cipher_name> entspricht dem Methodennamen.


Nun gehen wir auf die Details der Verwendung des Befehls --cipher ein.

'wrapper --help' gibt die folgende Ausgabe aus, die wir weiter unten näher erläutern:

  --cipher Obfuscate a password and generate a token along with wrapper.cipher.*
    properties that can then be used in the configuration file for added safety.
    The value to be encoded can be piped to Stdin of the Wrapper.  Otherwise, it
    will be prompted.
    The following arguments are available:
      --method <method name> One of the following methods:
          base64   : to encode in Base64
          base64url: to encode in the modified Base64 for URLs
          obf      : to generate a fixed obfuscated string
          robf     : to generate a random obfuscated string
      --name <cipher name> Optional cipher name. This argument is required when
        '--private_keyfile' is specified.
      --private_keyfile <file path> Optional path to a private key file
        (available for method 'obf' and 'robf').
      --encoding <utf8 or utf-8> Encoding to use when reading Stdin.
      --echo Echo the input to debug encoding issues (do not use with real
        passwords).
      --simple If specified, the output will only contain the obfuscated string.

Methoden

Der Parameter --method wird verwendet, um die Kodierungsmethode festzulegen.

Die folgenden Methoden stehen zur Verfügung:

  • base64: Standard-Base64-Kodierung

  • base64url: modifiziertes Base64 für URLs ('+' durch '-', '/' durch '_' ersetzt)

  • obf: proprietäre Verschleierungsmethode (dieselbe Eingabe erzeugt stets dieselbe Ausgabe)

  • robf: proprietäre randomisierte Verschleierungsmethode (dieselbe Eingabe erzeugt randomisierte Ausgaben, was sie gegenüber Kryptoanalyse stärker macht)

NOTE

'base64' und 'base64url' sind öffentlich bekannte Kodierungsmethoden. Der kodierte Wert ist länger und schwerer zu merken als der entsprechende Klartext. Jemand, der im Besitz der kodierten Zeichenkette ist, könnte sie jedoch sehr leicht dekodieren.

'obf' und 'robf' können nicht leicht dekodiert werden, da die verwendeten Algorithmen nicht öffentlich bekannt sind. Für erhöhte Sicherheit kann beim Kodieren auch ein privater Schlüssel angegeben werden, der in einer separaten sicheren Datei gespeichert ist. Ohne denselben Sicherheitsgrad wie die stärksten Verschlüsselungsmethoden (AES, RSA usw.) zu beanspruchen, bietet die Verwendung von 'obf' oder 'robf' in Kombination mit einem privaten Schlüssel einen recht guten Schutz Ihrer Daten.

Cipher-Name

Der Parameter --name ist optional. Wenn er verwendet wird, muss ihm eine Kennung für die Konfiguration folgen, die zum Kodieren von Werten verwendet wird.

Dieser Parameter ist obligatorisch, wenn '--private_keyfile' angegeben wird.

Der angegebene Wert wird verwendet, um die Eigenschaft wrapper.cipher.<n>.name zu setzen. Wenn beispielsweise --name obf1 angegeben wird, wird die folgende Konfiguration erzeugt:

wrapper.cipher.1.name=obf1

Private-Key-Datei

Der Parameter --private_keyfile ist optional. Wenn er verwendet wird, muss ihm der Pfad zu einer Private-Key-Datei folgen.

Dieser Parameter kann nur verwendet werden, wenn die Kodierungsmethode 'obf' oder 'robf' ist und der Parameter --name ebenfalls angegeben wird.

Ohne privaten Schlüssel wirkt die angegebene Kodierung lediglich als Verschleierung, die es unerwünschten Beobachtern einfach erschwert, sich die Werte zu merken. Während Verschleierung ausreichen kann, wenn Ihre Konfigurationsdatei gut geschützt und privat bearbeitet wird, bietet die Angabe einer Private-Key-Datei zusätzliche Sicherheit. Zum Dekodieren wird dann diese separate Datei benötigt, deren einziger Zweck darin besteht, den privaten Schlüssel zu enthalten, und die daher nie geöffnet oder bearbeitet werden muss. Die Schlüsseldatei muss stets an einem sicheren Ort mit eingeschränkten Berechtigungen gespeichert werden. Jeder, der Zugriff auf Ihren Schlüssel erhält, könnte Ihre Passwörter leicht dekodieren.

Der angegebene Wert wird verwendet, um die Eigenschaft wrapper.cipher.<n>.private_keyfile zu setzen. Beispielsweise erzeugt 'wrapper --cipher --method obf --name obf1 --private_keyfile ../conf/my_private_key' die folgende Konfiguration:

wrapper.cipher.1.name=obf1
wrapper.cipher.1.method=obf
wrapper.cipher.1.private_keyfile=../conf/my_private_key

Einfache Ausgabe

Der Parameter --simple ist ein einzelnes Flag (ohne Wert), das verwendet wird, um eine Ausgabe zu erzeugen, die nur den kodierten Wert enthält.

Ohne den Parameter --simple sieht die Ausgabe wie folgt aus:

Encoded Token:
    %K401JeI7GaHRplWDz15c6hmXkKM_9CoFrAo8P|r1%

Configuration:
    wrapper.cipher.1.name=r1
    wrapper.cipher.1.method=obf
    wrapper.cipher.1.private_keyfile=mykey

Mit dem Parameter --simple sieht die Ausgabe wie folgt aus:

%K401JeI7GaHRplWDz15c6hmXkKM_9CoFrAo8P|r1%

Die Verwendung des Parameters --simple ist nützlich, wenn die Ausgabe von einem automatisierten Prozess verwendet oder an einen anderen Befehl übergeben werden muss.

Der folgende Befehl kodiert beispielsweise den Wert "mypassword" mit der Methode 'obf'. Die Ausgabe des Wrappers wird an den sed-Befehl übergeben, der das/die Token '@pw1@' durch den kodierten Wert ersetzt.

Beispiel: (Unter Unix)

cat file_containing_password | ./wrapper --cipher --method obf --simple | sed -i "s/@pw1@/$(cat)/g" ../conf/wrapper-private.conf

Kodierung

Der Parameter --encoding ist optional. Er legt die Kodierung fest, die beim Lesen von Stdin verwendet werden soll.

Wenn diese Option nicht angegeben wird, wird unter Windows die ANSI-Codepage und unter Unix die Kodierung der Locale der aktuellen Sitzung verwendet.

Derzeit werden nur die folgenden Werte unterstützt:

  • default

  • utf8 oder utf-8

Beispiel: (Mit cmd.exe: Die erste Zeile von input.txt in utf-8 lesen)

type input.txt | wrapper.exe --cipher --method obf --encoding utf8

NOTE

In PowerShell-Konsolen bestimmt die Variable $OutputEncoding die Kodierung, die beim Weiterleiten von Daten an native Anwendungen verwendet wird. In manchen Umgebungen kann der Standardwert ASCII sein, wodurch alle Nicht-ASCII-Zeichen durch Fragezeichen ersetzt würden. Beim Lesen des Inhalts einer Datei, die UTF-8-Zeichen enthält, stellen Sie sicher, dass $OutputEncoding korrekt auf '[System.Text.Encoding]::UTF8' gesetzt ist.

Beispiel: (Mit PowerShell: Die erste Zeile von input.txt in utf-8 lesen)

$OutputEncoding = [System.Text.Encoding]::UTF8
Get-Content .\input.txt -Encoding UTF8 | .\wrapper.exe --cipher --method obf --encoding utf8

Echo

Der Parameter --echo ist ein optionales einzelnes Flag (ohne Wert), das verwendet werden kann, um die vom Wrapper empfangenen Eingabedaten auszugeben, bevor sie verschleiert werden. Dies ist nützlich, um Kodierungsprobleme zu erkennen.

WARNING

WICHTIG: Diese Option steht nur zu Debugging-Zwecken zur Verfügung. Sie sollte niemals mit echten Passwörtern verwendet werden, da die Eingabe im Klartext im Terminal angezeigt wird. Bitte leeren Sie Ihr Terminal, wenn Sie versehentlich sensible Daten ausgegeben haben.

NOTE

Die Optionen --echo und --simple können nicht zusammen verwendet werden.

Erläuterung

Wenn der Wrapper seinen Standardeingabestrom liest, interpretiert er ihn mit seiner eigenen Kodierung oder mit dem Wert der Option --encoding, falls angegeben. In den meisten Fällen hat er keine Möglichkeit festzustellen, ob die verwendete Kodierung korrekt ist oder nicht, und verschleiert die Daten in jedem Fall. Allein anhand der verschleierten Ausgabe kann es sehr schwierig sein, Kodierungsprobleme in der Eingabezeichenkette zu bemerken. Durch Hinzufügen der Option --echo kann der Benutzer bestätigen, ob die Eingabe vom Wrapper korrekt empfangen wurde.

Beispiel: (falsche Kodierung)
type inpututf8.txt | wrapper.exe --cipher --method obf --echo

...

Input data: 'Niño'

Encoded Token:
    %59qW5A=k2naYbzKiXOUcGc5OA598K0Kq6|obf%

Beispiel: (korrekte Kodierung)
type input.txt | wrapper.exe --cipher --method obf --echo --encoding utf8

...

Input data: 'Niño'

Encoded Token:
    %_G2moKq5aFVvtwAn6pyk5MS4G6Hm4mR|obf%

Private Schlüssel generieren

Kompatibel :3.6.0
Editionen :Professional EditionStandard EditionCommunity Edition (Not Supported)
Betriebssysteme :WindowsMac OSXLinuxAlpine LinuxFreeBSDSolarisIBM z/Linux

Der Wrapper stellt den Befehl --keygen bereit, um private Schlüssel zu generieren, die von bestimmten Kodierungsmethoden verwendet werden.

WARNING

Standardmäßig generiert der Wrapper einen Schlüssel mit Lese- und Schreibberechtigungen, die nur dem Benutzer gewährt werden, der den Wrapper ausführt. Unter Unix-Systemen ist dieser Benutzer der "Besitzer" der Datei, und nur der Besitzer hat Lese-Schreib-Berechtigungen. Diese Berechtigungen können anschließend geändert werden, aber bitte beachten Sie, dass sie auf das absolute Minimum beschränkt sein sollten. In der Regel sollte nur der Benutzer, der den Wrapper ausführt, Zugriff auf den privaten Schlüssel haben.

Bitte lesen Sie diese Seite, um zu erfahren, wie Sie die Berechtigungen Ihres privaten Schlüssels anpassen.

'wrapper --help' gibt die folgende Ausgabe aus, die wir weiter unten näher erläutern:

  --keygen Generate a private key file to be used when obfuscating passwords.
    The following arguments are available:
      --method <method name> Obfuscation method for which the private key is
        intended to be used:
          obf : to generate a key for fixed obfuscation
          robf: to generate a key for random obfuscation
      --private_keyfile <file path> Specifies the filename of the key file.

Methoden

Derzeit können nur die Methoden 'obf' und 'robf' einen privaten Schlüssel verwenden. Außerdem verwenden beide dasselbe Schlüsselformat, sodass ein durch Angabe der Methode 'obf' generierter Schlüssel für die Methode 'robf' verwendet werden kann und umgekehrt.

Der Parameter --method existiert aus Kompatibilitätsgründen mit zukünftigen Versionen des Wrappers, die neue Kodierungs- oder Verschlüsselungsmethoden mit anderen Schlüsselformaten hinzufügen werden.

Private-Key-Datei

Der Parameter --private_keyfile wird verwendet, um den Pfad zu einer Datei anzugeben, in die der generierte Schlüssel geschrieben wird.

Verweis: Sicherheit

Cipher configuration:

Secure Files:

Commands: