From 57941ff5466dfc6d8ed38407e04fd11ab889aaac Mon Sep 17 00:00:00 2001 From: Andreas Dinauer Date: Thu, 1 Oct 2026 21:44:21 +0200 Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20Document=20idle=20lock=20in=20fr?= =?UTF-8?q?ontend?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5.5 --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 6a9f16d..3871a6e 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,7 @@ Lockaway ist eine kleine, selbst gehostete Secret-Verwaltung für Kubernetes. Se Browser (Vue) ──verschlüsselt──▶ Backend (Quarkus + Postgres) ◀──pollt── Reconciler ──▶ Kubernetes Secrets ``` -- **Frontend** (`frontend/`, Vue + Vite): Nach Eingabe eines Master-Passworts wird daraus im Browser ein AES-256-GCM-Schlüssel abgeleitet (HKDF-SHA256). Alle Werte werden clientseitig ver- und entschlüsselt. Ein Secret besteht aus Name, Typ (z. B. `Opaque`), Key/Value-Einträgen und einer Liste von Ziel-Namespaces. Import/Export ist ebenfalls möglich. +- **Frontend** (`frontend/`, Vue + Vite): Nach Eingabe eines Master-Passworts wird daraus im Browser ein AES-256-GCM-Schlüssel abgeleitet (HKDF-SHA256). Alle Werte werden clientseitig ver- und entschlüsselt. Ein Secret besteht aus Name, Typ (z. B. `Opaque`), Key/Value-Einträgen und einer Liste von Ziel-Namespaces. Import/Export ist ebenfalls möglich. Nach 5 Minuten ohne Benutzereingabe (Maus, Tastatur, Touch, Scrollen) sperrt sich das Frontend automatisch: Master-Passwort und Schlüssel werden verworfen und das Master-Passwort muss erneut eingegeben werden. Der Timeout ist in `frontend/src/composables/useMasterPassword.ts` (`IDLE_TIMEOUT_MS`) definiert. - **Backend** (`backend/`, Quarkus + PostgreSQL/Flyway): Speichert die Secrets ausschließlich verschlüsselt und stellt eine REST-API bereit (`/secrets`, `/_import`, `/_export`). Ein Verifikationswert stellt sicher, dass alle Clients dasselbe Master-Passwort verwenden. - **Reconciler** (`reconciler/`, Quarkus + Fabric8): Läuft im Cluster, kennt denselben Master-Key, holt alle 60 Sekunden die Secrets vom Backend, entschlüsselt sie und gleicht sie per Server-Side-Apply mit dem Cluster ab – anlegen, aktualisieren (über einen Content-Hash) und entfernen. Verwaltete Secrets tragen das Label `lockaway.dev/secret-name`; bestehende, nicht von Lockaway verwaltete Secrets werden nie überschrieben oder gelöscht. Namespaces, die (noch) nicht existieren, werden übersprungen.