@@ -0,0 +1,24 @@
|
|||||||
|
# Lockaway
|
||||||
|
|
||||||
|
Lockaway ist eine kleine, selbst gehostete Secret-Verwaltung für Kubernetes. Secrets werden zentral in einer Web-Oberfläche gepflegt und automatisch als native Kubernetes-`Secret`s in die gewünschten Namespaces ausgerollt – ohne dass Klartext-Werte je in der Datenbank oder im Backend landen.
|
||||||
|
|
||||||
|
## Wie es funktioniert
|
||||||
|
|
||||||
|
```
|
||||||
|
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.
|
||||||
|
- **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.
|
||||||
|
|
||||||
|
## Lokale Entwicklung
|
||||||
|
|
||||||
|
```shell
|
||||||
|
docker compose -f dev/docker-compose.yaml up -d # Postgres auf Port 32876
|
||||||
|
cd backend && ./mvnw quarkus:dev # API auf :8080
|
||||||
|
cd frontend && npm install && npm run dev
|
||||||
|
cd reconciler && ./mvnw quarkus:dev -Dquarkus.http.port=8081 # benötigt kubeconfig
|
||||||
|
```
|
||||||
|
|
||||||
|
Der Master-Key des Reconcilers wird über `lockaway.master.key` konfiguriert und muss dem im Frontend verwendeten Master-Passwort entsprechen.
|
||||||
Reference in New Issue
Block a user