Files

T

florian.wildeandClaude Opus 5.5 db0d095032 chore(release): 0.1.0 - Phase 1 abgeschlossen

Grundgeruest, Anmeldung, Hosts mit Host-Key-Pruefung und Bootstrap.
README mit Installation und Ablauf fuer neue Hosts, CHANGELOG und
DEVLOG nachgetragen. Offen im Meilenstein bleibt nur #030 (Gitea),
das auf die Zugangsdaten wartet.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

2026-10-12 10:02:44 +02:00

3.3 KiB

Raw Blame History

DEVLOG – SSHKeyVault

Zeitübersicht

Gesamt (Wandzeit): 1 h 25 min
Summe der Issue-Zeiten: 4 h 23 min – Sub-Agenten arbeiteten parallel an #002, #006, #008 und #011.

Issue	Zeit
Planung (Phase 0)	0 h 20 min
#001 Projekt-Setup	0 h 15 min
#002 Design-System und Layout	0 h 18 min
#003 Datenmodell und Migrationen	0 h 10 min
#004 Anmeldung, Rollen und Bestätigung	0 h 45 min
#005 Revisionssicheres Protokoll	0 h 10 min
#006 Verschlüsselte Ablage und Schlüsselformat	0 h 25 min
#007 Worker und Vorgänge	0 h 15 min
#008 Hosts und Hostgruppen	0 h 30 min
#009 Host-Key-Prüfung	0 h 25 min
#010 Bootstrap	0 h 35 min
#011 Test-SSH-Container	0 h 15 min

Meilenstein	Zeit
v0.1.0	1 h 25 min (Wandzeit)

2026-10-12 · Sitzung 1 · 08:45–10:10

Issue: Planung, #001–#011 Version: 0.1.0

Erledigt

Auftrag gelesen, Architektur, Datenmodell, Sicherheitskonzept und Phasenplan entworfen (docs/PLAN.md)
Sieben Rückfragen gestellt und beantwortet, Plan freigegeben
Konventionen aus Laufzettel und ProxLedger übernommen; Git-Repository mit lokaler Identität angelegt
30 Issues für Phase 1–5 als Dateien angelegt (Gitea folgt mit #030)
#001 Grundgerüst; #003 Datenmodell mit Datenbankregeln und Protokoll-Hash-Kette als Trigger
#002, #006 (Kern), #011 parallel von Sub-Agenten in eigenen Worktrees, danach gemergt
#004 Anmeldung: OIDC gegen Mock-Anbieter, Notfall-Admin mit TOTP, Re-Auth; E2E im gebauten Stand
#005 Protokoll-Service mit Schwärzen; #006 Teil 2: Versiegeln im Worker, Deployment-Key
#007 Worker mit pg-boss; vollständiger Docker-Stapel geprüft (migrate, web, worker gesund)
#008 Hosts und Hostgruppen (Sub-Agent)
#009 strikte Host-Key-Prüfung und TOFU, #010 Bootstrap – Integrationstests gegen echtes sshd, E2E im Browser bis zur Verbindungsprüfung
Stand: 287 Unit-/DB-Tests, 17 Integrationstests, 5 E2E-Abläufe grün

Entscheidungen

Kein Auth.js: v5 steht dauerhaft auf Beta – wie in Laufzettel openid-client + jose.
Web und Worker getrennt, Master-Key nur im Worker: Eine Lücke im Webprozess allein entschlüsselt keine Private Keys.
Schlüsselerzeugung ohne ssh-keygen: Node crypto + eigener OpenSSH-Serializer, damit Private Keys nie als Datei auf dem sshkv-Server liegen. ssh-keygen prüft in den Tests die Kompatibilität.
Dienstbenutzer sshkv mit sudo als Standard, root pro Host wählbar.
Ohne sshkv-Gruppe kein Zugang – auch kein Lesezugriff.
Protokoll-Hash im Datenbank-Trigger: Niemand kann eine Zeile ohne Verkettung einfügen; die ID wird erst unter Sperre vergeben, damit die Kette auch bei parallelem Schreiben hält.
Ein Bootstrap-Skript für Passwort- und Copy-Paste-Weg, Dateizugriffe als Zielbenutzer (Symlink-Schutz).
Eigene Testdatenbank je parallelem Lauf: Sub-Agent und Hauptsitzung leerten sich gegenseitig die Tabellen (in CLAUDE.md festgehalten).
Prisma-Client in den Worker gebündelt: Im Standalone-Abbild fand die ESM-Auflösung @prisma/client sonst nicht (erst im echten Docker-Stapel aufgefallen).
Worker-Benutzer in Compose wählbar (SSHKV_WORKER_USER), weil Docker-Secrets ohne Swarm die Rechte der Host-Datei tragen.