tualo / encrypted-data
tualo - encrypted-data: clientseitig verschluesselte Datenelemente (RSA-OAEP + AES-GCM), private Schluessel verlassen nie den Browser
Requires
- phpseclib/phpseclib: ^4.0.3
- ramsey/uuid: ~4.9.0
- tualo/tualopgp: >=1.0
Requires (Dev)
None
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
Clientseitig verschlüsselte Datenelemente für tualo Office.
Informationen werden im Browser ver- und entschlüsselt und nur als Ciphertext in der Datenbank abgelegt. Öffentliche Schlüssel der Nutzer werden in der Datenbank gespeichert; private Schlüssel verlassen den Browser nie und landen zu keinem Zeitpunkt auf dem Server.
Inhalt
- Konzept
- Kryptografie
- Datenmodell
- Installation
- HTTP-API
- ExtJS-Steuerelemente
- Views
- Envelope-Format
- Sicherheitsmodell und Grenzen
Konzept
Es gibt zwei Typen von Datenelementen:
- Einzelnes Datenelement (
single): nur für den Besitzer selbst verschlüsselt (Empfänger = eigener Schlüssel). - Gemeinsames Datenelement (
shared): mit anderen Nutzern oder Diensten geteilt. Alle Parteien müssen vorab einen öffentlichen Schlüssel im System abgelegt haben. Teilt Person A mit Person B, verschlüsselt Person A den Inhaltsschlüssel clientseitig mit dem öffentlichen Schlüssel von Person B.
Die Schlüsselerzeugung erfolgt wie im Package onlinevote im Browser
(WebCrypto). Der öffentliche Schlüssel wird in der Datenbank registriert, der
private Schlüssel wird als PEM-Datei heruntergeladen (einziges Backup!) und
zusätzlich als nicht-extrahierbarer CryptoKey in der IndexedDB des
Browsers abgelegt.
Kryptografie
Hybridverschlüsselung (analog zur Arbeitsweise von PGP):
- Pro Datenelement wird ein zufälliger AES-256-GCM-Schlüssel erzeugt, mit dem der Inhalt verschlüsselt wird (12-Byte-IV, authentifiziert durch GCM).
- Der AES-Schlüssel wird pro Empfänger mit dessen RSA-4096 / RSA-OAEP (SHA-256)-Public-Key verschlüsselt ("gewrappt").
- Teilen = der Berechtigte entschlüsselt den AES-Schlüssel mit seinem privaten Schlüssel und wrappt ihn für den neuen Empfänger neu — alles im Browser.
Dadurch gibt es pro Datenelement genau einen Ciphertext, unabhängig von der Anzahl der Empfänger, und beliebig große Inhalte sind möglich (reines RSA könnte nur ~450 Bytes verschlüsseln).
Hinweis zur Begrifflichkeit: Verschlüsselt wird immer mit dem
öffentlichen Schlüssel (auch für sich selbst), entschlüsselt mit dem
privaten. Schlüsselformate (PEM/SPKI, RSA-OAEP) sind kompatibel zu
tualo/tualopgp (phpseclib), falls ein Dienst serverseitig als Empfänger
agieren soll.
Fingerprint eines Schlüssels: SHA-256 (hex, lowercase) über den
DER-kodierten SPKI-Public-Key — client- und serverseitig identisch berechnet
(Tualo.EncryptedData.Crypto.fingerprint bzw.
Tualo\Office\EncryptedData\Routes\Keys::fingerprint).
Datenmodell
| Tabelle | Inhalt |
|---|---|
encrypted_data_keys |
Öffentliche Schlüssel: fingerprint (PK), username, keyname, publickey (PEM), created, revoked |
encrypted_data |
Datenelemente: id (UUID), context, label, owner, datatype (single/shared), iv, ciphertext, created, modified |
encrypted_data_recipients |
Pro Empfänger der gewrappte AES-Schlüssel: data_id, fingerprint, wrapped_key, added_by, created |
label und context sind unverschlüsselte Metadaten — dort dürfen keine
Geheimnisse abgelegt werden.
Installation
./tm install-sql-encrypted-data --client <client>
Optional Menüeinträge (SESSIONDB): src/sql/menu/base.sql
(Hauptmenü „Verschlüsselte Daten“ mit #encrypted-data/keys und
#encrypted-data/items, Rolle administration).
Der Post-Check Checks/Tables.php meldet fehlende Tabellen.
HTTP-API
Alle Routen erfordern eine eingeloggte Session (Scope encrypted-data) und
liefern JSON (success, msg, ...).
Schlüssel
| Route | Methode | Beschreibung |
|---|---|---|
/encrypted-data/keys/register |
POST | Eigenen Public Key registrieren (publickey PEM, keyname). Private Keys werden abgewiesen, RSA ≥ 2048 Bit erzwungen, Fingerprint wird serverseitig berechnet. |
/encrypted-data/keys |
GET | Alle aktiven Public Keys (für die Empfängerauswahl). |
/encrypted-data/keys/my |
GET | Eigene Schlüssel inkl. widerrufener. |
/encrypted-data/keys/revoke |
POST | Eigenen Schlüssel widerrufen (fingerprint). |
Datenelemente
| Route | Methode | Beschreibung |
|---|---|---|
/encrypted-data/save |
POST | Anlegen/Überschreiben (id?, context?, label?, datatype, iv, ciphertext, recipients als JSON [{fingerprint, wrapped_key}]). Überschreiben nur durch den Besitzer; dabei müssen alle Empfänger neu gewrappt mitgeliefert werden. |
/encrypted-data/list |
GET | Metadaten aller Elemente, bei denen man Besitzer oder Empfänger ist. |
/encrypted-data/get/<id> |
GET | Element inkl. iv/ciphertext; gewrappte Schlüssel (mykeys) nur für die eigenen Schlüssel; recipients als Anzeige-Liste. |
/encrypted-data/share |
POST | Weitere Empfänger hinzufügen (id, recipients JSON). Erlaubt für Besitzer und Empfänger — nur sie können den AES-Schlüssel clientseitig neu wrappen. |
/encrypted-data/unshare |
POST | Empfänger entfernen (id, fingerprint), nur Besitzer. Rein organisatorisch, s. Grenzen. |
/encrypted-data/delete |
POST | Element löschen (id), nur Besitzer. |
ExtJS-Steuerelemente
Lazy-Klassen werden über Ext.Loader (Tualo.EncryptedData →
./jsencrypteddata) nachgeladen.
encrypteddatafield / encrypteddataarea
Verschlüsseltes Textfeld (Ext.form.field.Text) bzw. Textarea
(Ext.form.field.TextArea) mit Schloss-Trigger zum Umschalten zwischen
ver- und entschlüsselter Ansicht:
{ xtype: 'encrypteddataarea', fieldLabel: 'Geheime Notizen', name: 'secret', // optional: zusätzliche Empfänger-Fingerprints, // eigene aktive Schlüssel werden immer ergänzt recipients: ['<fingerprint-von-person-b>'] }
Verhalten:
- Verriegelt (Standard): zeigt
••••• verschlüsselt •••••, nicht editierbar. Der Feldwert ist der Envelope-JSON-String. - Entriegelt (Klick auf das Schloss): entschlüsselt mit dem privaten
Schlüssel aus der IndexedDB und zeigt den Klartext editierbar an.
Änderungen werden gepuffert (400 ms) sowie bei
blurautomatisch neu verschlüsselt. getValue()/getSubmitValue()liefern immer den Envelope, nie den Klartext.- Vor programmatischem Submit:
await field.ensureEncrypted()aufrufen, damit eine laufende Verschlüsselung abgeschlossen ist. - Events:
encrypted(field, envelope),encryptionfailed(field, error).
Hilfsklassen
Tualo.EncryptedData.Crypto— WebCrypto-Helfer: Schlüsselerzeugung, PEM-Import/-Export, Fingerprints,encrypt,decryptEnvelope,unwrapKey/wrapKeyFor(Teilen),generateAndRegister.Tualo.EncryptedData.KeyStore— private Schlüssel als nicht-extrahierbareCryptoKey-Objekte in der IndexedDB (tualo-encrypted-data).
Views
#encrypted-data/keys— Schlüsselverwaltung: erzeugen (mit PEM-Download), privaten Schlüssel importieren (nur lokal), widerrufen, aus dem Browser entfernen. Zeigt an, ob der private Schlüssel im aktuellen Browser verfügbar ist.#encrypted-data/items— Datenelemente: anlegen, entschlüsselt anzeigen, teilen, löschen.
Envelope-Format
Selbstbeschreibender JSON-String, der auch außerhalb der
encrypted_data-Tabellen (z.B. in beliebigen Formularfeldern) gespeichert
werden kann:
{
"tualoEncryptedData": 1,
"v": 1,
"alg": "RSA-OAEP-256+A256GCM",
"iv": "<base64>",
"ct": "<base64>",
"keys": {
"<fingerprint>": "<base64 gewrappter AES-256-Schlüssel>"
}
}
Sicherheitsmodell und Grenzen
Was das Package leistet:
- Server-Betreiber können Inhalte nicht lesen. Auf dem Server liegen nur Ciphertext, IVs und RSA-gewrappte Schlüssel.
- Private Schlüssel existieren nur als Download-Datei beim Nutzer und als
nicht-extrahierbarer
CryptoKeyin der Browser-IndexedDB. - AES-GCM authentifiziert den Ciphertext (Manipulation fällt beim Entschlüsseln auf).
- Der Server validiert hochgeladene Public Keys (RSA ≥ 2048, keine privaten Schlüssel) und berechnet Fingerprints selbst.
Bewusste Entscheidungen / Grenzen — bitte bei der Nutzung beachten:
- Schlüsselverlust = Datenverlust. Es gibt bewusst keinen Recovery-/Escrow-Schlüssel. Geht die private PEM-Datei verloren und ist der Schlüssel in keinem Browser mehr hinterlegt, sind die Daten unwiederbringlich verloren. Die PEM-Datei muss sicher verwahrt werden (Passwortmanager, Tresor).
- Vertrauensmodell Public Keys: Die Zuordnung Schlüssel ↔ Nutzer trifft der Server. Ein kompromittierter Server könnte beim Teilen einen fremden Public Key unterschieben und so künftig geteilte Inhalte mitlesen (Machine-in-the-Middle). Abschwächung: Die UI zeigt Fingerprints an — bei sensiblen Daten Fingerprints über einen zweiten Kanal (Telefon, persönlich) abgleichen. Ein Web-of-Trust/Key-Signing ist nicht implementiert.
- Code-Vertrauen: Wie bei jeder Web-Anwendung führt der Browser den vom Server gelieferten JavaScript-Code aus. Ein kompromittierter Server könnte Code ausliefern, der Klartexte exfiltriert. Das Modell schützt gegen passive Einsicht (DB-Dumps, Backups, DB-Admins), nicht gegen einen aktiv bösartigen Anwendungsserver.
unshareist organisatorisch: Was ein Empfänger bereits entschlüsselt hat (oder dessen gewrappten Schlüssel er kopiert hat), kann technisch nicht zurückgeholt werden. Für echten Entzug: Inhalt neu verschlüsseln (neuer AES-Schlüssel übersavedurch den Besitzer) und nur an die verbleibenden Empfänger wrappen.- Metadaten sind sichtbar:
label,context, Besitzer, Empfängerliste und Zeitstempel sind unverschlüsselt. Keine Geheimnisse inlabel/contextablegen. - IndexedDB-Ablage: Nicht-extrahierbare Schlüssel können nicht exportiert, aber von Skripten derselben Origin verwendet werden (XSS-Risiko besteht wie bei jeder Session). Die Ablage ist an Gerät + Browser-Profil gebunden; auf neuen Geräten muss die PEM-Datei importiert werden.
- Widerruf (
revoke): verhindert nur neue Verschlüsselungen an diesen Schlüssel; bestehende Daten bleiben mit ihm lesbar.