JavaScript-Bibliothek common/encryption

Diese JavaScript-Bibliothek bietet Funktionen zum Ver- und Entschlüsseln von Strings mithilfe des agorum core-eigenen Verschlüsselungsmechanismus. Sie ist insbesondere geeignet, um sensible Anwendungsdaten sicher (z. B. in der Metadatenbank) abzulegen.

Hinweise:

Diese Verschlüsselung ist zur Speicherung von geschützten Daten in agorum core vorgesehen.
Administratoren mit entsprechendem Zugriff auf Serverseite können die Daten entschlüsseln.
Die Verschlüsselung ist an das jeweilige agorum core System gebunden. Das bedeutet, dass der verschlüsselte Wert auf einem anderen agorum core System nicht entschlüsselt werden kann.

Verwendung

Binden Sie die Bibliothek stets am Anfang eines Skripts ein:

let encryption = require('common/encryption');

Funktionen

encrypt

Verschlüsselt einen übergebenen String-Wert. Die Verschlüsselung basiert auf einem mandantenspezifischen Schlüssel und kann serverseitig wieder entschlüsselt werden.

Syntax

encryption.encrypt(value);

Parameter

Parameter	Beschreibung	Pflicht	Standard
`value`	Zu verschlüsselnder Wert (String)	ja	–

Beispiel

let encryption = require('common/encryption');
let secret = 'MeinGeheimerText';

let encryptedValue = encryption.encrypt(secret);

Rückgabe

Der verschlüsselte Wert als (nicht lesbarer) String.

decrypt

Entschlüsselt einen zuvor mit encrypt verschlüsselten Wert.

Syntax

encryption.decrypt(value);

Parameter

Parameter	Beschreibung	Pflicht	Standard
`value`	Zu entschlüsselnder Wert (String, muss zuvor mit `encrypt` verschlüsselt worden sein)	ja	–

Beispiel

let encryption = require('common/encryption');
let encryptedValue ='<encryptedValue>'

let decryptedValue = encryption.decrypt(encryptedValue);

Rückgabe

Der entschlüsselte Wert als Klartext-String (wie zuvor per encrypt gespeichert).