Generera och arbeta med hashvärden i dynamisk PDF forms generate-work-with-hashes-dynamic-pdf-forms

Nödvändig kunskap prerequisite-knowledge

Det krävs viss erfarenhet av AEM Forms i JEE Designer, liksom möjligheten att komma åt och anropa funktioner i skriptobjekt.

Användarnivå user-level

Början

När du vill dölja ett lösenord i ditt PDF-formulär och inte vill ha det i klartext inuti källkoden eller någon annanstans i PDF-dokumentet, är det viktigt att du vet hur du genererar och arbetar med hash-koderna MD4, MD5, SHA-1 och SHA-256.

Tanken är att dölja lösenordet genom att generera en unik hash och lagra hash-koden i PDF-dokumentet. Den här unika hashen kan genereras av olika hash-funktioner, och i den här artikeln visas hur du genererar dem i PDF-formuläret och hur du arbetar med dem.

En hash-funktion tar en lång sträng (eller ett meddelande) av valfri längd som indata och skapar en sträng med fast längd som utdata, vilket ibland kallas meddelandesammandrag eller ett digitalt fingeravtryck.

Med AEM Forms i JEE Designer kan du implementera de olika hash-funktionerna i skriptobjekt som JavaScript och köra dem i ett dynamiskt PDF-dokument. PDF example som ingår i exempelfilerna för den här artikeln använder implementeringar med öppen källkod för följande hash-funktioner:

Den största fördelen med hash-kodning är att du inte behöver jämföra lösenord direkt genom att jämföra tydliga textsträngar. Du kan i stället jämföra de två hash-koderna för de två lösenorden. Eftersom det är osannolikt att två olika strängar har samma hash, kan du anta att de jämförda strängarna (i det här fallet lösenorden) också är identiska om båda hash-strängarna är identiska.

Undersöka skriptobjekten examining-script-objects

När du öppnar ett av de två exempelbilderna i AEM Forms i JEE Designer hittar du de fyra skriptobjekten på paletten Hierarki (se figur nedan).

Om du vill se JavaScript-implementeringen av hash-funktionerna i dessa skriptobjekt markerar du skriptobjektet och utforskar koden i skriptredigeraren. Du kan se hur följande hash-funktioner har implementerats:

Som du kan se i den här listan finns det olika funktioner tillgängliga för de olika utdatatyperna för hashen. Du kan välja mellan hex_ för hexadecimala siffror, b64_ för Base64-kodade utdata, eller str_ för enkel strängkodning.

Beroende på vilken hash-funktion du väljer varierar längden på hashen:

Provet PDF forms try-sample-pdf-forms

Exempelfilerna för den här artikeln är två PDF forms. I det första exemplet kan du skriva in en sträng och sedan generera hash-värden för strängen MD4, MD5, SHA-1 och SHA-256. Det andra exemplet är ett enkelt formulär som låser upp textfält om rätt lösenord anges.

Exempel 1: generera hash-värden generating-dashes

Prova det första exemplet genom att följa stegen nedan:

Resultatet av hash-åtgärden visas i fältet med etiketten hash. Hash-längden varierar beroende på vilken hash-funktion du väljer.

Alla samplingar använder hexadecimala siffror som utdatatyp. Du kan använda skriptredigeraren för att ändra exemplen och ändra utdatatypen till Base64 eller simple String.

Exempel 2: matcha lösenord matching-passwords

Det andra exemplet visar hur hash-värden jämförs i bakgrunden utan att det riktiga lösenordet behöver avslöjas. Lösenordet du anger är hashas. Det riktiga lösenordet, som lagras i ett osynligt fält, hashas också. Lösenordet är säkert, inte för att det är osynligt, utan för att det har hashats. Eftersom det är omöjligt att rekonstruera lösenordet från det hash-kodade värdet är det säkert att visa lösenordet i hash-kodad form. Jämförelsen görs bara mellan hasharna, inte mellan lösenorden i klartext. Om båda hash-koderna är desamma kan du anta att lösenorden är identiska.

Prova det andra exemplet genom att följa stegen nedan:

Koden för att jämföra de två hash-kodade värdena och aktivera textfälten är okomplicerad:

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";
}

Vart ska du gå härifrån? next-steps

Var behöver du något sådant här? Ta till exempel ett PDF-formulär som innehåller fält som endast ska fyllas i av behöriga personer. Genom att skydda fälten med ett lösenord, som inte kan visas i klartext någonstans i dokumentet som i Sample_2.pdf, kan du se till att dessa fält bara är tillgängliga för användare som känner till lösenordet.

Jag rekommenderar att du fortsätter utforska de två exempelfilerna för PDF. Du kan generera nya hash-värden med Sample_1.pdf och använda de genererade värdena för att ändra antingen lösenordet eller hash-funktionen som används i Sample_2.pdf. Resurserna som listas i avsnittet Attribut innehåller även ytterligare information om hash-kodning och de specifika JavaScript-implementeringar som används i den här artikeln.

Attribut attributions