docs(betrieb): Handbuch, Bedrohungsanalyse, geprobte Sicherung (#029)

Handbuch mit Bildern fuer alle Ablaeufe, darunter der Kern-
Anwendungsfall und der Deployment-Zugang fuer Claude Code.
Betriebsdoku zu Installation, authentik und Reverse Proxy sowie eine
Bedrohungsanalyse mit Notfallplan fuer den Fall, dass sshkv selbst
kompromittiert wird.

Sicherung und Wiederherstellung als Skripte, auf einem Wegwerf-Stapel
geprobt. Dabei fielen zwei Fehler auf: das Schema der Warteschlange
liess sich nicht zurueckspielen, und ein Abbruch ohne Transaktion
loeschte es halb. Jetzt nur Schema public, in einer Transaktion, mit
Pruefwert des Master-Keys. Der Worker startet nicht, wenn der
Master-Key nicht zur Datenbank passt.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-12 16:46:38 +02:00
co-authored by Claude Opus 5.5
parent f791816e85
commit 3b28f73c95
13 changed files with 682 additions and 3 deletions
+18
View File
@@ -219,3 +219,21 @@ export async function deploymentKeySicherstellen(): Promise<string> {
});
return neu.id;
}
/**
* Passt der Master-Key zur Datenbank? (#029) Oeffnet probeweise den Deployment-Key. Schlaegt
* das fehl, ist entweder die falsche Master-Key-Datei eingebunden oder eine Sicherung ohne den
* dazugehoerigen Master-Key zurueckgespielt worden – beides soll beim Start auffallen, nicht
* erst beim ersten Ausrollen.
*/
export async function masterKeyPruefen(deploymentKeyId: string): Promise<void> {
try {
const klartext = await privateKeyLaden(deploymentKeyId);
klartext.fill(0);
} catch {
throw new Error(
"Der Master-Key passt nicht zur Datenbank: Der Deployment-Key lässt sich nicht entschlüsseln. " +
"Ist SSHKV_MASTER_KEY_FILE die Datei, die zu dieser Datenbank gehört (Sicherung)?",
);
}
}