Erzeugen und Verwenden von Hashes in dynamischen PDF-Formularen. generate-work-with-hashes-dynamic-pdf-forms

Vorausgesetztes Wissen prerequisite-knowledge

Einige Erfahrung mit AEM Forms on JEE Designer ist erforderlich, ebenso wie die Fähigkeit, auf Funktionen in Skriptobjekten zuzugreifen und diese aufzurufen.

Benutzerebene user-level

Anfang

Wenn Sie ein Kennwort in Ihrem PDF-Formular verstecken möchten und es nicht im Quell-Code oder an einer anderen Stelle im PDF-Dokument als Klartext enthalten sein soll, müssen Sie wissen, wie MD4-, MD5-, SHA-1- und SHA-256-Hashes erzeugt werden können und funktionieren.

Ziel ist es, das Kennwort zu verschleiern, indem ein eindeutiger Hash erzeugt und dieser Hash im PDF-Dokument gespeichert wird. Dieser eindeutige Hash kann von verschiedenen Hash-Funktionen erzeugt werden, und in diesem Artikel wird Ihnen gezeigt, wie man sie innerhalb des PDF-Formulars erzeugt und wie man mit ihnen arbeitet.

Eine Hash-Funktion akzeptiert eine lange Zeichenfolge (oder Nachricht) beliebiger Länge als Eingabe und erzeugt eine Zeichenfolge mit fester Länge als Ausgabe, manchmal auch als Nachrichten-Digest oder digitaler Fingerabdruck bezeichnet.

Mit AEM Forms on JEE Designer können Sie die verschiedenen Hash-Funktionen als JavaScript in Skriptobjekte implementieren und innerhalb eines dynamischen PDF-Dokuments ausführen. Die Beispiel-PDFs, die in den Beispieldateien für diesen Artikel enthalten sind, verwenden Open-Source-Implementierungen der folgenden Hash-Funktionen:

Der größte Vorteil der Verwendung von Hashes besteht darin, dass Sie Kennwörter nicht direkt durch Vergleich von Klartext-Zeichenfolgen vergleichen müssen. Sie können stattdessen die beiden Hashes der beiden Kennwörter vergleichen. Da es unwahrscheinlich ist, dass zwei verschiedene Zeichenfolgen denselben Hash aufweisen, können Sie bei zwei identischen Hashes davon ausgehen, dass auch die verglichenen Zeichenfolgen (in diesem Fall die Kennwörter) identisch sind.

Überprüfen der Skriptobjekte examining-script-objects

Wenn Sie eines der beiden angegebenen Beispiele in AEM Forms on JEE Designer öffnen, finden Sie die vier Skriptobjekte in der Palette „Hierarchie“ (siehe Abbildung unten).

Um die JavaScript-Implementierung der Hash-Funktionen in diesen Skriptobjekten anzuzeigen, wählen Sie das Skriptobjekt aus und suchen Sie im Skript-Editor nach dem Code. Sie können sehen, wie die folgenden Hash-Funktionen implementiert wurden:

Wie Sie aus dieser Liste sehen können, gibt es verschiedene Funktionen für die verschiedenen Ausgabetypen des Hash. Sie können zwischen hex_ für Hexadezimalziffern, b64_ für Base64-codierte Ausgabe und str_ für einfache Zeichenfolgen-Codierung wählen.

Je nach ausgewählter Hash-Funktion variiert die Länge des Hash:

Ausprobieren der PDF-Beispielformulare try-sample-pdf-forms

Die Beispieldateien für diesen Artikel enthalten zwei PDF-Formulare. Im ersten Beispiel können Sie eine Zeichenfolge eingeben und dann MD4-, MD5-, SHA-1- und SHA-256-Hash-Werte für die Zeichenfolge generieren. Das zweite Beispiel ist ein einfaches Formular, auf dem Textfelder entsperrt werden, wenn das korrekte Kennwort eingegeben wird.

Beispiel 1: Generieren von Hash-Werten generating-dashes

Gehen Sie wie folgt vor, um das erste Beispiel auszuprobieren:

Das Ergebnis des Hash-Vorgangs wird im Feld mit der Bezeichnung Hash angezeigt. Die Länge des Hash-Werts hängt von der gewählten Hash-Funktion ab.

In allen Beispielen werden Hexadezimalziffern als Ausgabetyp verwendet. Mit dem Skript-Editor können Sie die Beispiele ändern und den Ausgabetyp in Base64 oder eine einfache Zeichenfolge ändern.

Beispiel 2: Abgleichen von Kennwörtern matching-passwords

Das zweite Beispiel zeigt, wie Hash-Werte im Hintergrund verglichen werden, ohne das richtige Kennwort offenlegen zu müssen. Das von Ihnen eingegebene Kennwort wird in einen Hash-Wert umgewandelt. Das echte Kennwort, das in einem unsichtbaren Feld gespeichert ist, wird ebenfalls in einen Hash-Wert umgewandelt. Das Kennwort ist sicher, weil es in einen Hash-Wert umgewandelt wurde, nicht weil es unsichtbar ist. Da sich das Kennwort aus dem Hash-Wert nicht rekonstruieren lässt, ist es sicher, das Kennwort in Hash-Form anzuzeigen. Es werden nur die Hash-Werte und nicht die Kennwörter in Klartext verglichen. Wenn die beiden Hash-Werte identisch sind, können Sie davon ausgehen, dass die Kennwörter identisch sind.

Gehen Sie wie folgt vor, um das zweite Beispiel auszuprobieren:

Der Code zum Vergleichen der beiden Hash-Werte und zum Aktivieren der Textfelder ist einfach:

if (soHASHING_SHA256.hex_sha256(this.rawValue) == passwd_man_hashed.rawValue){
     VAL_man_1.access = "open";
     VAL_man_2.access = "open";
     VAL_man_1.borderColor = "0,255,0";
     VAL_man_2.borderColor = "0,255,0";
}

Wie geht es jetzt weiter? next-steps

Wo brauchen Sie so etwas? Stellen Sie sich ein PDF-Formular vor, das Felder enthält, die nur von autorisierten Personen ausgefüllt werden sollten. Da diese Felder durch ein Kennwort geschützt sind, das nirgendwo im Klartext des Dokuments zu sehen ist, wie in Sample_2.pdf gezeigt, können nur die Benutzenden auf diese Felder zugreifen, die dieses Kennwort kennen.

Ich empfehle Ihnen, die beiden PDF-Beispieldateien weiter zu studieren. Sie können mit der Beispieldatei „Sample_1.pdf“ neue Hash-Werte generieren und die generierten Werte verwenden, um entweder das Kennwort oder die Hash-Funktion zu ändern, die in „Sample_2.pdf“ verwendet wird. Die im Abschnitt „Zuschreibungen“ aufgelisteten Ressourcen enthalten auch zusätzliche Informationen zum Hashing und zu den spezifischen JavaScript-Implementierungen, die in diesem Artikel verwendet werden.

Zuschreibungen attributions