Zum Inhalt

Projektplan

Ein selbst gehosteter Passwortmanager für Teams in kleinen Betrieben: Web-App und Browser-Extension, Ende-zu-Ende-verschlüsselt, post-quanten-hybrid, sicher auch gegen einen gehackten Server. Passt in die Speicherstadt-Suite, kennt aber keine andere App: Anmeldung über OpenID Connect, ohne Pro-Version. Was im Einzelnen gebaut wird und in welcher Reihenfolge, steht in der Bauliste.

Ziel und Positionierung

Kennwort (kennwort.app) wird der Passwortmanager der Speicherstadt-Suite: für Betriebe mit 3 bis 50 Mitarbeitern, die gemeinsame Zugänge (Banking, Lieferantenportale, WLAN, Kundengeräte) heute in Excel, auf Zetteln oder in einem Abo-Tool verwalten.

Was Kennwort anders macht als Passbolt und Bitwarden:

  • Server darf bösartig sein: signiertes Mitgliedschafts-Log und signierte Schlüssel; die 27 Angriffe der ETH-Studie (2026) werden als Regressionstests nachgebaut.
  • Post-quanten-hybrid (X25519 + ML-KEM-768) von Anfang an.
  • Entsperren mit Passkey (WebAuthn PRF), Passphrase nur als Notweg.
  • Eine Anmeldung über OpenID Connect: in der Suite über Kontext oder Stalwart, sonst jeder Anbieter (Keycloak, Authentik, Entra ID); Gruppen kommen aus dem groups-Claim, wer geht, verliert den Zugriff.
  • Alles frei: SSO, Gruppen, Audit-Log ohne Pro-Version (AGPL).
  • Ein Container, Bun + SQLite, wenige Abhängigkeiten (Client: etwa 6 Laufzeitpakete).

Nicht das Ziel: Konkurrenz zu Bitwarden für Privatleute oder Großunternehmen (LDAP/SCIM erst später).

Entscheidungen

Frage Entscheidung Warum
Firmen-Recovery Standard für Firmen, pro Firma abschaltbar: Der Inhaber hält einen Notfallschlüssel und kann den Zugang eines Mitarbeiters wiederherstellen Für einen kleinen Betrieb ist „alles weg“ schlimmer als „der Chef kommt im Notfall ran“; geteilte Tresore haben ohnehin mehrere Mitglieder
Betrieb Selbst gehostet, aber von Anfang an mandantenfähig, sodass ein IT-Dienstleister viele Firmen auf einem Server betreiben kann passt zu „mehrere Firmen“; da der Server nichts lesen kann, ist auch gehosteter Betrieb unbedenklich
Einrichtungs-Code Der Code des Betreibers legt jede neue Firma an, nicht nur die erste; eine bestehende Firma öffnet er nie passt zum mandantenfähigen Betrieb: Ein IT-Dienstleister legt viele Firmen an, ohne den Server neu zu starten; in eine Firma kommt man weiter nur mit Einladung
Router und Server-Daten der Web-App TanStack Router (@tanstack/solid-router 2.0.0-rc.11) und TanStack Query (@tanstack/solid-query 6.0.0-rc.6), auf Wunsch des Nutzers als Release Candidates übernommen, exakt gepinnt. Der Router läuft ohne RouterProvider mit Routen im Code (keine Codegen): Er hält Adresse und Verlauf, die App liest die Seite aus seinem Treffer und bleibt beim Sperren der Torwächter. Query lädt Geräte, Gruppen, Mitglieder und Richtlinie: ein Cache je geöffnetem Konto, nur im Speicher, beim Sperren geleert, ohne Persister, Schlüssel ohne Token oder Geheimnis. Tresore und Einträge bleiben beim eigenen Laden, weil sie entschlüsseln und den Sync speisen Nur diese Versionen tragen Solid 2. Risiko: Der Router hängt laut Paket noch an @solidjs/meta, @solid-primitives/refs und @solid-devtools/logger (für Solid 1) und isbot; keins davon landet im Bundle (geprüft mit der Source Map), es gibt nur ein solid-js. Beide zusammen machen das Bundle der Web-App um rund 153 kB größer (53 kB gzip), vor allem router-core und query-core. Fragmente mit Geheimnissen (Kit, Kopplung) liest die App vor dem ersten Rendern und entfernt sie sofort aus Adresse, Verlauf und Router
Secret Key auf dem Gerät Die Web-App merkt sich Konto-ID und Secret Key im localStorage, nie Passphrase oder AK wie bei 1Password: Zum Entsperren reicht die Passphrase, und ein Server, der Passphrasen errät, muss trotzdem den Secret Key raten
Neues Gerät Der QR-Code trägt Kopplungs-ID, Fingerabdruck des Einmal-Schlüssels und ein Kopplungs-Geheimnis, nicht den Schlüssel; das Paket ist an das Geheimnis gebunden und enthält auch den Secret Key Ein X-Wing-Schlüssel hat 1216 Byte, der QR-Code bliebe kaum lesbar, und der Fingerabdruck bindet ihn genauso; das Geheimnis sieht der Server nie, so kann er kein eigenes Paket unterschieben (Review von K-303); ohne Secret Key könnte das neue Gerät nach dem Sperren nicht mit der Passphrase entsperren
Icons lucide (die Icon-Daten ohne Framework) mit einer eigenen Icon-Komponente in packages/ui statt lucide-solid lucide-solid baut auf Solid 1 (splitProps, solid-js/web) und läuft mit Solid 2 nicht; die Daten sind dieselben, und eine Abhängigkeit weniger läuft im Client
Lizenz AGPL-3.0 mit Namensnennung nach § 7(b) und kommerzieller Lizenz wie bei haben, dazu ein kurzes CLA für Beitragende erlaubt die iPhone-App im App Store und die kommerzielle Lizenz trotz Beiträgen von außen
Merge Der Agenten-Loop merged alles selbst, wenn CI grün ist; er wartet nie auf einen Menschen. Ein unabhängiges Review durch einen eigenen Sub-Agenten gibt es nur noch für sicherheitsrelevanten Code (Kryptografie, Sync, Mitglieder-Log, Freigaben, Anmeldung, Zugriffsprüfung, Entsperren, Schlüssel, Kopplung, Autofill, signiertes Update, CSP, erlaubte Pakete), und dort erst ohne offene Befunde der Loop soll ohne Warten durchlaufen; ein Review für jeden Pull Request kostete zu viel Zeit, deshalb gilt es seit dem 20.11.2026 auf Wunsch des Nutzers nur noch dort, wo ein Fehler Geheimnisse kostet
Geräte und Sitzungen Jedes Gerät schickt eine zufällige Geräte-ID und einen Namen aus dem Browser mit; der Server hält pro Gerät und Konto genau eine Sitzung, die Geräteliste zeigt diese Sitzungen Better Auth kennt nur Sitzungen; ohne Geräte-ID würde jede Anmeldung eine neue Zeile in der Liste, und „Gerät abmelden“ träfe nur eine von mehreren Sitzungen desselben Geräts
Einladungsgeheimnis Der Client des Einladenden hinterlegt das Einladungsgeheimnis versiegelt unter seinem eigenen AK auf dem Server; eine Einladung macht immer einen Mitarbeiter, eine höhere Rolle vergibt ein Inhaber eigens So prüft der Einladende die Antwort auch Tage später und auf jedem seiner Geräte, ohne dass der Server das Geheimnis kennt; und kein Server kann einen Eingeladenen als Inhaber zertifizieren lassen
Namen der Mitglieder Der Einladende tippt einen Namen ein; der Server speichert ihn an der Einladung und zeigt ihn in der Mitgliederliste Konten haben sonst keine Namen, bis OIDC oder SCIM sie liefern; der Name ist nur eine Beschriftung, Vertrauen kommt allein aus dem Zertifikat
Wurzelschlüssel für Admins Inhaber und Admins halten den privaten Wurzelschlüssel, verpackt an ihr Bündel; nur Inhaber vergeben Rollen, nie die eigene Admins laden ein und müssen dafür zertifizieren können (P-08); ein Inhaber, der sich nicht selbst herabstufen kann, hält die Firma immer mit mindestens einem Inhaber
Firmen-Richtlinie Eine vom Wurzelschlüssel signierte Richtlinie mit Version (F-07); Clients merken sich die höchste Version und nehmen keine ältere So kann der Server weder die Sperrzeit noch später die Firmen-Recovery heimlich ändern oder zurückdrehen
Gruppen nach den Anfragen Zugriff anfragen kommt vor den Gruppen (K-305); eine Gruppe erzeugt beim Eintritt eines Mitglieds nur Anfragen an die Verwalter ihrer Tresore Bei Ende-zu-Ende-Verschlüsselung gibt nur ein Verwalter-Client Zugriff; Gruppen bauen darum auf den Anfragen auf, nicht umgekehrt
Einzelnen Eintrag teilen nach den Einträgen K-305 Teil 6 (P-10) kommt nach K-306 Teil 1; der Eintrags-Schlüssel bleibt seitdem über die Versionen eines Eintrags gleich, neu bei Schlüsselwechsel und Widerruf Vorher bekam jede Version einen neuen EK; eine Freigabe soll aber auch spätere Versionen öffnen, und erst ein Widerruf wechselt den EK
Widerruf einer Freigabe Entfernen holt den Tresor neu, schreibt den Eintrag mit unverändertem Inhalt als neue Version unter einem neuen EK, verpackt den neuen EK für die übrigen Freigaben neu und löscht die Freigabe erst danach; neu gemacht werden nur Freigaben, die ein Mitglied mit „bearbeiten“ oder „verwalten“ über den EK der ersetzten Version signiert hat Erst der neue EK nimmt dem Entfernten spätere Versionen (P-10); ohne neues Verpacken würden die übrigen Freigaben brechen, ohne die Prüfung gegen den neuesten EK könnte ein Server eine eigene oder früher widerrufene Freigabe neu verpacken lassen, und weil zuletzt gelöscht wird, bleibt ein gescheiterter Widerruf wiederholbar (Review von K-305 Teil 6b)
Versionen geteilter Einträge Der Empfänger merkt sich die höchste Version jedes geteilten Eintrags im verschlüsselten Kontostand (versions) und zeigt keine ältere So spielt ihm der Server auch ohne Log keinen älteren Stand ein, über Geräte und Sitzungen hinweg (E-13)
„Mit mir geteilt“ getrennt Geteilte Einträge stehen nur unter „Mit mir geteilt“, nicht unter „Alle Einträge“ oder in einem Tresor Der Empfänger ist kein Mitglied des Tresors; die Liste zeigt klar, was nur geliehen und nur lesbar ist
Rolle einer Freigabe Eine Freigabe trägt ihre Rolle im signierten Format, vorerst nur „lesen“ Wer einen einzelnen Eintrag bekommt, hat kein Log, in dem eine Schreibberechtigung stünde; „bearbeiten“ kann später kommen, ohne das Format zu ändern
Persönlicher Tresor Jedes Konto bekommt beim ersten Öffnen einen Tresor „Persönlich“, dessen ID aus dem AK abgeleitet ist Ein Ort für eigene Zugänge ohne Zutun; dieselbe ID auf allen Geräten verhindert doppelte Tresore
Schlüsselwechsel beim Austritt entfernen und schlüsselwechsel signiert derselbe Verwalter in einem Zug; das neue VK geht an jedes Mitglied, das das Log danach noch nennt, auch an abgelaufene, und nur über ein Zertifikat des Wurzelschlüssels mit dem Fingerabdruck aus dem Log, sonst bricht der Wechsel ab; jeder Eintrag wird als nächste Version in der neuen Epoche geschrieben Was nach dem Austritt geschrieben wird, liegt so unter einem Schlüssel, den die Person nie hatte (E-26); ein still ausgelassenes oder an einen fremden Schlüssel verpacktes Mitglied wäre schlimmer als ein abgebrochener Wechsel. Abgelaufene bekommen den Schlüssel, weil rolle sie wieder hereinlässt und keinen Schlüssel trägt; der Server gibt ihn nur aktuellen Mitgliedern
Epochen beim Lesen und Schreiben Geschrieben wird nur unter dem Schlüssel der aktuellen Epoche des geprüften Logs (sonst schreibt der Abgleich nichts), der Server nimmt Versionen nur in dieser Epoche; ältere Schlüssel liest der Client nur für Versionen, die noch nicht neu verschlüsselt sind; eine Version einer Epoche, die das Log nicht erreicht, ist ein Angriff Ein Gerät mit dem alten Schlüssel schriebe für jemanden, der gegangen ist; ein abgebrochener Wechsel soll den Tresor aber lesbar lassen. Neu verschlüsselte Einträge verraten einen zurückgehaltenen Wechsel oder ein zurückgespieltes Log auch einem Gerät, das sich den neueren Stand nie gemerkt hat
Änderungs-Markierung Im Inhalt des Eintrags (toChange: Konto, Zeit, IDs der geheimen Felder), gesetzt beim Neuschreiben nach dem Wechsel für Versionen aus einer Epoche, deren Schlüssel die Person hatte; ein Feld geht aus der Markierung, sobald sich sein Wert ändert; die Markierungen trägt der Kern von Version zu Version, nicht der Dialog Verschlüsselt, signiert und für alle Mitglieder sichtbar, ohne neue Tabelle auf dem Server, der eine Markierung sonst still löschen könnte; ein Dialog, der sie nicht kennt, verliert keine. Wie Bitwarden und 1Password raten: ändern, was die Person sehen konnte
Austritt aus der Firma DELETE /api/members/:id durch Inhaber (alle anderen) und Admins (nur Mitarbeiter) sperrt das Konto sofort: alle Sitzungen weg, keine Anfrage unter /api mehr; Schlüssel und Zertifikat bleiben; aus den Tresoren entfernen und den Schlüssel wechseln macht der nächste Verwalter-Client Den Zugang zum Server kann der Server sofort nehmen, den zu den Schlüsseln nur ein Verwalter mit Signatur; ohne das Zertifikat ließen sich die Logs, die die Person signiert hat, nicht mehr prüfen
Austritt in Teilen K-307 Teil a bringt Schlüsselwechsel, Markierung, Austritts-Bericht, Server und Angriffs-Tests ohne Oberfläche; Teil b die Oberfläche, die einen ausstehenden Wechsel sofort nachholt und Freigaben neu verpackt; Firmen-Recovery, Notfallzugriff, AK-Wechsel und neuer Wurzelschlüssel folgen als eigene Teile Die Web-App zieht gerade auf TanStack Router und Query um; bis Teil b sieht der Client einen ausstehenden Wechsel (rotationDue), sperrt das Schreiben aber noch nicht, damit ein Entfernen in der heutigen Oberfläche den Tresor nicht für alle blockiert
AK-Wechsel nach verlorenem Recovery-Kit Neuer AK, neuer Secret Key, neue Benutzer-Schlüssel und in jedem Tresor des Kontos entfernen, aufnehmen mit dem neuen Bündel und schlüsselwechsel; das neue Bündel bestätigt ein Inhaber oder Admin per Vergleichscode Mit dem Kit öffnet ein Angreifer AK und damit die privaten Schlüssel und jeden je verpackten Tresor-Schlüssel; ein neuer AK allein schützte nichts, und der verratene alte Schlüssel kann den neuen nicht bezeugen
Generator Passwörter aus Klein- und Großbuchstaben, nach Wahl Ziffern und Sonderzeichen, je mindestens eines; Passphrasen aus der englischen EFF-Wortliste (7776 Wörter, 12,9 Bit je Wort); Stärke in Bit: unter 60 schwach, unter 80 gut, ab 80 stark Eine gute deutsche Wortliste mit klarer Lizenz fehlt; die EFF-Liste ist geprüft, frei (CC BY 3.0 US) und meidet verwechselbare Wörter. Die Bits zählen, was ein Angreifer schafft, der die Einstellungen kennt; die Grenzen folgen dem, was Offline-Raten gegen einen Server mit Secret Key heute nicht erreicht
Favoriten Der Favorit ist ein Feld des Eintrags (favorite im Geheimtext, P-09) und gilt für alle im Tresor; markieren darf, wer bearbeiten oder verwalten darf, Leser sehen den Stern ausgegraut Das Format hat den Favoriten schon im Eintrag; ein eigener je Person gehörte in den verschlüsselten Kontostand (AccountState), braucht dort ein neues Feld und einen eigenen Abgleich und kann später dazukommen. Für ein kleines Team sind gemeinsame Favoriten („die Zugänge, die alle oft brauchen“) ein brauchbarer Anfang
Frühere Passwörter Ändert der Dialog ein geheimes Feld, kommt der alte Wert mit der Zeit in history; je Feld bleiben die zehn neuesten, gekürzt beim Speichern auf dem Gerät, der Abgleich (P-21) kürzt nie Ohne Grenze wüchse ein Eintrag mit monatlich geändertem Passwort ohne Ende; zehn reichen, um einen missglückten Wechsel zurückzunehmen. Was der Abgleich rettet, zählt mit, geht aber erst bei einer späteren Änderung verloren, nie beim Zusammenführen selbst
Zum Ändern Auf dem Gerät aus den entschlüsselten Einträgen berechnet: schwach (in den 1000 häufigsten Passwörtern aus SecLists, MIT, auch mit Ziffern oder Zeichen drumherum, oder unter 60 Bit nach Länge und Zeichenarten) oder doppelt (derselbe Wert in mehr als einem sichtbaren Eintrag); geprüft werden nur die Passwörter der Arten und die Passphrase von SSH-Schlüsseln Eine Bibliothek wie zxcvbn brächte bessere Schätzungen, aber eine große Abhängigkeit mit Wörterbüchern in den Client; die einfache Regel ist ehrlich dokumentiert und nutzt die Grenze des Generators. Nichts davon geht an den Server: auch Prüfsummen von Passwörtern wären dort ein Angriffsziel
Suche Titel, Art, Tags und die Werte aller nicht geheimen Felder, ohne Groß- und Kleinschreibung und Akzente; geheime Felder, frühere Passwörter und TOTP-Schlüssel nie Wer Zugriff auf ein entsperrtes Gerät hat, soll nicht durch Eintippen herausfinden, in welchem Eintrag ein bekanntes Passwort steht
QR-Scan für Einmalcodes jsqr in der Web-App, erst beim Scannen geladen; Kamera über getUserMedia, sonst ein Bild oder Screenshot BarcodeDetector fehlt am Desktop unter Linux und Windows; jsQR ist reines JavaScript ohne Abhängigkeiten, und das Bild verlässt das Gerät nicht
Service Worker der PWA sw.js mit festem Namen, von Bun außerhalb von Vite gebaut, der öffentliche Release-Schlüssel eingebaut; jede neue Version der App kommt über das signierte Release-Manifest, nicht über einen neuen Service Worker Ein Service Worker kann seinen eigenen Austausch nicht verhindern; bleibt er Byte für Byte gleich, tauscht der Browser ihn nie, und jedes Update läuft durch die Prüfung von Signatur und Hashes
Reihenfolge der Releases Das Release-Manifest trägt eine Folgenummer (SOURCE_DATE_EPOCH, sonst die Bauzeit); der Service Worker merkt sich die höchste je geprüfte und nimmt nur eine höhere, auch nicht bei der Installation eines neuen sw.js eine ältere Sonst könnte der Server ein altes, korrekt signiertes Release mit einer bekannten Lücke zurückspielen
Update der PWA Eine geprüfte neue Version wartet auf das nächste Neuladen; die Seite zeigt „Neue Version bereit“ mit „Neu laden“ Unter einer laufenden Seite die Dateien zu tauschen, mischte alte und neue Teile; die Version davor bleibt für offene Tabs
Was der Service Worker nicht hat Solange eine Version gilt, bekommt eine Datei, die kein geprüfter Cache hat, einen Fehler statt der Antwort des Netzes; eine Navigation unter /api oder /auth bekommt Weiterleitungen, sonst nur Text in einer Sandbox Sonst holte ein alter Tab seinen nachgeladenen Code ungeprüft vom Server, und eine Seite des Servers unter /api liefe mit dem Speicher der App; Anmeldeabläufe leiten weiter und bleiben so möglich (Review von K-308a)
Offline lesbar Die Web-App hält in IndexedDB nur Geheimtexte und was der Server ohnehin hat (verpackter AK, Schlüsselblock, Kontozustand, die Antworten zu Tresoren, Logs, Tresor-Schlüsseln, Firma, Mitgliedern ohne Namen und Freigaben, die geprüften Datensätze der Einträge) und prüft sie offline wie die Antworten des Servers; ohne Server entsperrt sie mit Passphrase und Secret Key, liest nur und zeigt „Offline – nur lesen“ mit dem letzten Abgleich; Änderungen gibt es offline nicht, auch keine Warteschlange wie bei 1Password und Bitwarden: Die Kopie ist ohne Passphrase und Secret Key nutzlos; die Kopie als weiterer, nicht vertrauter Server hält jede Prüfung an einer Stelle. Eine Warteschlange mit Konflikten über Tage brauchte eigene Oberfläche und kommt, wenn jemand sie braucht
Zurückspielen nach der Offline-Kopie Der Kontozustand, den das Gerät zuletzt kannte, liegt unter AK versiegelt in der Kopie und geht in jeden Kontozustand des Servers ein (der höhere Stand gewinnt, bei Widerspruch der eigene); ein neu geöffneter Tresor zieht zuerst die gespeicherten, geprüften Datensätze und dann den Server So kann ein Server mit einem älteren Kontozustand, einem kürzeren Log oder einer älteren Version eines Eintrags das Gerät nicht zurückwerfen (E-07, E-13, E-15), auch nicht über ein Neuladen hinweg
Sperren und Abmelden mit Offline-Kopie Sperren lässt die Kopie liegen, „Dieses Gerät abmelden“ und ein anderes Konto auf dem Gerät löschen sie; nach dem Entsperren ohne Server bleibt der Anmelde-Schlüssel (nie die Passphrase) im Speicher, bis der Server wieder antwortet Entsperren ohne Server braucht die Kopie nach dem Sperren; wer abmeldet, will das Konto vom Gerät haben. Mit dem Anmelde-Schlüssel meldet sich die App von selbst wieder an, ohne die Passphrase zu behalten
App-Icon Das Schloss der Rail (lucide Lock auf --primary), als SVG und daraus gerenderte PNGs Ein Zeichen für die App überall; ein Schlüssel steht in der App schon für die Einträge
Extension für Firefox Ein Manifest aus apps/extension/src/manifest.ts für beide Builds; vite build --mode firefox setzt background.scripts statt service_worker, eine feste ID in browser_specific_settings.gecko und Firefox 140 als Mindestversion Firefox kennt für Extensions keinen Service Worker und braucht eine feste ID, damit Speicher und Berechtigungen eine Neuinstallation überstehen; ab 140 (ESR) liest Firefox die Angaben zur Datenerhebung, die addons.mozilla.org verlangt. Alles andere bleibt gleich, darum keine zweite Konfiguration
Speicher der Extension Die Extension benutzt nur chrome.storage.session, nur über session-keys.ts und mit Zugriff nur für die Extension selbst (TRUSTED_CONTEXTS); chrome.storage.local, sync, localStorage und IndexedDB nie, auch nicht für Einstellungen; die Texte kommen über eine eigene Paraglide-Laufzeit ohne localStorage-Strategie – ein Test prüft die Quellen, jeder Build prüft das fertige Bundle samt eingebundener Pakete Gibt es einen Speicher auf der Festplatte, landet früher oder später ein Schlüssel darin; Sprache und Hell/Dunkel folgen darum Browser und System. Die Paraglide-Laufzeit der Web-App liest und schreibt localStorage und käme über packages/ui sonst mit ins Bundle. Firefox kennt setAccessLevel nicht, hält den Bereich aber ohnehin von Content Scripts fern

Stack

Der Stack folgt tech-stack.md aus firsttris/workflows; vier Abweichungen sind begründet und stehen im CLAUDE.md.

Teil Wahl Begründung
Monorepo Bun Workspaces, Biome, TypeScript strict, Vitest, Playwright wie überall
Server Bun + Hono + Drizzle + SQLite + Zod, bun build --compile, Docker-Image amd64/arm64 eigene API für Extension, Web-App und CLI
Auth Better Auth: Passkeys und ein allgemeiner OIDC-Client (in der Suite Kontext oder Stalwart) nur Login und Sync, nie zum Entschlüsseln
Extension Solid 2 + Vite + @crxjs/vite-plugin, Manifest V3, Chrome/Edge/Firefox Stack-Vorgabe für Extensions
Texte Paraglide JS (de/en) für alle Oberflächen, auch Extension und Mobile-App; _locales nur für Name, Beschreibung und Manifest der Extension Abweichung: Web-App und Extension teilen packages/ui, also auch die Texte
Web-App Solid 2, statische SPA/PWA Abweichung von React: ein UI-Paket für Web-App und Extension, kleineres Bundle zum Auditieren
Kein TanStack Start / SSR statischer Build mit Hashes im Dateinamen Abweichung: nur ein statischer Build lässt sich signieren und im Service Worker prüfen
Routing, Server-Daten @tanstack/solid-router 2.0.0-rc.11 und @tanstack/solid-query 6.0.0-rc.6, beide Release Candidates (siehe Entscheidungen) lokaler entschlüsselter Zustand ist die Quelle, nicht der Server-Cache; Query lädt nur, was die Seiten vom Server zeigen
UI shadcn-Stil ohne Abhängigkeiten: <dialog>, Popover-API, CSS Anchor Positioning, eigene cn() und variants(), Tailwind 4, lucide-Icons (lucide statt lucide-solid, siehe Entscheidungen), Geist, Zinc-Tokens (siehe DESIGN.md) jedes Laufzeitpaket läuft dort, wo Klartext liegt
Krypto @noble/ciphers, @noble/curves, @noble/hashes, @noble/post-quantum auditiert, reines TS, ohne eigene Abhängigkeiten
Sonstiges tldts (Public Suffix List), zod
Mobile-App Tauri 3 mit der Solid-UI aus packages/ui; native Autofill-Plugins: Android AutofillService (Kotlin), iOS AutoFill Credential Provider (Swift) Abweichung von Tauri 2: Tauri 3 ist zur Zeit der Mobile-Phase voraussichtlich stabil; als letzte Phase gebaut, Rückfall auf 2.x

Abhängigkeiten exakt gepinnt, Renovate mit Wartezeit, bun install --frozen-lockfile, keine Install-Skripte außer trustedDependencies.

Kryptografie

Bewährte, standardisierte Bausteine, modern zusammengesetzt; keine eigenen Algorithmen oder Protokoll-Erfindungen.

Zweck Verfahren Status
Symmetrisch XChaCha20-Poly1305 (AEAD), 256 Bit bewährt (libsodium)
Schlüssel verpacken X25519 + ML-KEM-768 hybrid ML-KEM = NIST FIPS 203 (2024), in TLS, Signal, iMessage
Signaturen Ed25519 (ML-DSA später nachrüstbar) bewährt
Passphrase Argon2id (RFC 9106) + 128-Bit-Secret-Key bewährt
Entsperren WebAuthn PRF (Passkey) neu, Passphrase als Notweg
Ableitung HKDF-SHA-512 bewährt

Schlüsselhierarchie:

Passkey (PRF) ──────────┐
Passphrase + Secret Key ──┼─► Account Key (256 Bit, zufällig)
Recovery-Kit (Papier) ────┘          │
(Firmen-Recovery, Standard)        ├─► Benutzer-Schlüssel: Hybrid-KEM + Ed25519
                                   │
Tresor-Schlüssel ◄──────────────────┘  pro Mitglied verpackt
      │
Eintrags-Schlüssel ─► Eintrag (Titel, URL, Passwort, TOTP, Notizen – alles verschlüsselt)

Regeln:

  • AAD bindet jeden Geheimtext an Eintrags-ID, Tresor-ID und Version: kein Vertauschen, keine alten Stände.
  • Signiertes Mitgliedschafts-Log pro Tresor (Hash-Kette, Admin-signiert); Clients prüfen und merken sich den letzten Stand.
  • Firmen-Wurzelschlüssel: Inhaber signieren die öffentlichen Schlüssel der Mitarbeiter; unerwartete Wechsel lösen eine Warnung aus.
  • Austritt: neuer Tresor-Schlüssel, betroffene Passwörter werden zum Ändern markiert.
  • Neues Gerät: Freigabe von einem angemeldeten Gerät per QR-Code und Vergleichscode.
  • Login per Passkey/SSO, die Passphrase verlässt nie das Gerät; daher kein OPAQUE nötig.

Bedrohungsmodell

Der Server gilt als nicht vertrauenswürdig; die größten Risiken liegen in Extension, ausgeliefertem Code und Endgeräten, nicht in den Algorithmen.

Angriff Gegenmittel Restrisiko
Datenbank gestohlen nur Geheimtexte; Secret Key verhindert Offline-Raten der Passphrase keins bei korrekter Umsetzung
Später mit Quantenrechner entschlüsseln Hybrid X25519 + ML-KEM-768 gering
Server nimmt heimlich jemanden in einen Tresor auf signiertes Mitgliedschafts-Log, Clients prüfen die Kette keins
Server schiebt fremden öffentlichen Schlüssel unter Firmen-Wurzelschlüssel signiert Mitarbeiterschlüssel, Warnung bei Wechsel erster Kontakt (TOFU)
Server vertauscht Einträge oder spielt alte Stände ein AAD mit ID und Version, Versionszähler im Client keins
Server liefert manipulierte Web-App aus Klartext-UI in der Extension; PWA mit signiertem Release-Manifest, Service Worker prüft Signatur und Hashes; Extension prüft Web-App erste Installation, ein ausgetauschter Service Worker und die PWA am Handy, dokumentiert
Phishing-Seite will Autofill exakter Host-Abgleich (PSL), nur nach Klick, nicht in fremden iFrames gering
Clickjacking auf das Autofill-Menü (DEF CON 2025) Menü als Extension-iFrame im geschlossenen Shadow DOM gering
Supply-Chain im Client etwa 6 Laufzeitpakete, gepinnt, keine Install-Skripte gering
SSO-Konto übernommen SSO entschlüsselt nichts, Passkey/Passphrase nötig keins
Mitarbeiter verlässt Firma neuer Tresor-Schlüssel, Passwörter zum Ändern markiert kopierte Passwörter bis zur Änderung
Malware auf dem Gerät automatisches Sperren, Schlüssel nur im Speicher hoch, außerhalb des Modells
Passwort bleibt am Handy in der Zwischenablage Kopieren nur auf Tipp; native App leert die Zwischenablage nach 30 s und markiert sie als sensibel PWA kann nicht zuverlässig leeren
Anmeldung durchprobieren Rate-Limits, Sperre nach Fehlversuchen; die Passphrase kommt nie zum Server gering

Projektstruktur

Ein Monorepo mit Bun Workspaces; die Krypto- und Datenlogik ist reines TypeScript und wird von allen Apps geteilt.

Pfad Inhalt Laufzeit-Abhängigkeiten
packages/crypto Bausteine, Schlüsselhierarchie, Testvektoren, Property-Tests @noble/*
packages/core Zod-Schemas, Sync, Prüfung des Mitgliedschafts-Logs, Rechte, Import-Parser zod
packages/ui Solid-Komponenten im shadcn-Stil, native Elemente solid-js
apps/server Hono-API, Drizzle/SQLite, SSE für Live-Sync, Audit-Log als Hash-Kette hono, drizzle-orm, better-auth
apps/web Solid-SPA/PWA: Verwaltung und Tresor am Handy packages/*
apps/extension Solid, MV3, Popup, Inline-Menü, Autofill packages/*, tldts
apps/mobile Tauri 3, Autofill-Plugins für Android und iOS packages/*
apps/cli bun build --compile, Secrets für Skripte und CI packages/*
e2e/ Playwright, inklusive manipuliertem Testserver für die ETH-Angriffe dev

Kopplung an andere Apps

Kennwort kennt weder Kontext noch Stalwart, nur Standards: eigenes Repo, eigener Container, und jede Verbindung läuft über eine offene Schnittstelle, die auch andere Anbieter erfüllen. So macht es schon Schreibzeug, das sich über einen allgemeinen OIDC-Client bei Kontext anmeldet.

Was Standard in Kennwort In der Speicherstadt-Suite Ohne Suite
Anmeldung eigene Konten mit Passkey; wahlweise OpenID Connect (Client) Kontext als OIDC-Provider, wie bei Schreibzeug, oder Stalwart direkt Keycloak, Authentik, Entra ID, Google
Gruppen eigene; wahlweise der groups-Claim aus dem ID-Token, Name des Claims einstellbar info@, rechnung@ aus den Gruppenkonten in Stalwart Gruppen des Anbieters
Benutzer anlegen und entfernen Einladung oder Anmeldung legt an; optional SCIM-Endpunkt Kontext könnte SCIM sprechen jeder SCIM-Client
Verweise von außen Deep Links, z. B. /suche?q=Müller GmbH Kontext verlinkt vom Kunden auf seine Zugänge jede App

Ende-zu-Ende-Verschlüsselung setzt eine Grenze: Ein Gruppenwechsel beim Anbieter erzeugt nur eine Anfrage. Zugriff gibt erst ein Verwalter frei, dessen Client den Tresor-Schlüssel für das neue Mitglied verpackt und signiert; Entfernen wirkt sofort auf dem Server, den Schlüsselwechsel macht der nächste Verwalter-Client. So kann weder der Anbieter noch der Server heimlich Zugriff verschaffen.

Bauplan im Agenten-Loop

Kennwort wird als fertiges Produkt gebaut, ohne MVP: Ein Agent arbeitet die Bauliste Punkt für Punkt ab, bis jedes Häkchen gesetzt und jede Prüfung grün ist. Er wartet nie auf einen Menschen; was nur Menschen erledigen können, kommt nach dem Loop (unten).

Regeln für den Loop:

  1. Spezifikation zuerst: docs/sicherheitsdesign.md und die Akzeptanzkriterien je Punkt der Bauliste. Ohne Kriterium kein Code.
  2. Ein Durchlauf, ein Punkt: nächsten offenen Punkt nehmen, Tests zuerst (Vitest; Playwright desktop und @phone), umsetzen, Docs und Texte de/en nachziehen, bun run check grün, eigener Branch, Pull Request, bei sicherheitsrelevantem Code unabhängiges Review, CI grün, mergen, Punkt abhaken.
  3. Automatische Sicherheits-Gates in CI: Testvektoren und Property-Tests für die Kryptografie, manipulierter Testserver mit den Angriffen der ETH-Studie, Liste erlaubter Laufzeit-Pakete, Bundle-Größe, CSP, Barrierefreiheit mit axe.
  4. Nicht hängen bleiben: Änderungen an packages/crypto nur mit Testvektoren, Property- und Mutation-Tests; nie einen Test abschalten; ein Punkt, der dreimal scheitert, wird zurückgestellt und am Ende wieder aufgenommen. Signaturen baut der Loop mit Test-Schlüsseln.

Reihenfolge nach Abhängigkeiten:

  1. Fundament – Repo-Gerüst, CI, Sicherheitsdesign, packages/crypto, packages/core.
  2. Server – API, Sync mit SSE, Anmeldung, Mitgliedschafts-Log, Audit-Log.
  3. Web-App und PWA – Konto, Geräte, Firma, Tresore, Gruppen, Einträge, Verwaltung.
  4. Extension – Popup, Inline-Menü, Ausfüllen, Speichern, Passkeys; Chrome, Edge, Firefox, Firefox für Android, Safari.
  5. Import und Export – alle Formate aus dem Abschnitt unten.
  6. Team-Funktionen – Einmal-Links, Erinnerungen, Richtlinien, Notfallzugriff, Anmeldung per OpenID Connect mit Gruppen, CLI.
  7. Härtung – alle ETH-Angriffe abgewehrt, reproduzierbare Builds, Demo ohne Server, Doku, Screenshots.
  8. Mobile-App – ganz am Schluss: Tauri 3 mit Autofill für Android; das iOS-Projekt wird angelegt, die iOS-App selbst baut ein Mensch auf einem Mac.

Was nur Menschen erledigen können, alles nach dem Loop:

  • iOS-App: AutoFill-Extension in Xcode, Signatur, App Store.
  • Signatur-Schlüssel für Release-Manifest, Extension und Apps erzeugen und verwahren; bis dahin signiert der Loop mit einem Test-Schlüssel (KENNWORT_RELEASE_KEY, P-16).
  • Store-Einreichungen (Chrome, Firefox, Edge, App Store, Play) und Antworten auf Reviews.
  • Pilotbetrieb bei einem echten Betrieb.
  • Externes Audit (z. B. Cure53) vor der Veröffentlichung; Befunde arbeitet der Loop ab.

Tests

Jeder Punkt gilt erst als fertig, wenn seine Tests grün sind; alles außer den menschlichen Prüfungen läuft in CI.

Art Was geprüft wird Werkzeug
Unit-Tests reine Logik neben dem Code Vitest
E2E was ein Benutzer tut, Desktop und @phone; in CI in drei parallelen Teilen Playwright
Krypto-Testvektoren feste Ein- und Ausgaben je Baustein, Abgleich mit libsodium Vitest, libsodium nur dev
Property-Tests z. B. Entschlüsseln ergibt immer das Original, falsche AAD schlägt immer fehl fast-check
Mutation-Tests erkennen die Tests eine absichtliche Abweichung in packages/crypto und packages/core? In CI in drei parallelen Teilen; in einem Pull Request läuft ein Teil nur, wenn sich sein Paket, packages/crypto darunter oder die Abhängigkeiten geändert haben, auf main immer Stryker
Bösartiger Server manipulierter Testserver mit den Angriffen der ETH-Studie; der Client erkennt jeden Vitest, Playwright
Extension im echten Browser Inline-Menü und Ausfüllen auf Testseiten, auch Phishing-Domain, fremdes iFrame, überdecktes Menü Playwright mit geladener Extension, web-ext für Firefox
Kompatibilität der Clients was Web-App, Extension, App und CLI verschlüsseln, lesen alle anderen gemeinsame Testvektoren
Sync und Offline zwei Geräte ändern offline denselben Eintrag, nach dem Abgleich geht nichts verloren Vitest, Playwright
Import-Parser echte, anonymisierte Exportdateien je Anbieter; kaputte oder böswillige Dateien stürzen nie ab und hängen nie Fixtures, Fuzzing mit fast-check
Updates Datenbank-Migrationen und ältere Formatversionen bleiben lesbar Vitest
Ernstfälle Austritt mit Schlüsselwechsel, Recovery-Kit, Notfallzugriff, Gerät verloren, Backup zurückspielen Playwright
Mobile-App Rust-Tests, Oberfläche mit mockIPC, Android-Autofill im Emulator cargo test, Playwright, Emulator
Server unter Last viele Geräte gleichzeitig mit Live-Sync Lasttest-Skript mit Bun
CI-Gates erlaubte Laufzeit-Pakete, Bundle-Größe, CSP, Barrierefreiheit, reproduzierbarer Extension-Build (zweimal bauen, Hashes vergleichen) eigene Checks, axe
Menschen Pilotbetrieb, externes Audit –

Dokumentation, Screenshots und Demo

Wie bei Kontext: Doku mit Zensical auf Deutsch, Screenshots per Workflow und eine Demo ohne Server, alles auf GitHub Pages.

  • Doku: Zensical in docs/, auf GitHub Pages unter kennwort.app, nur Deutsch; zensical build --strict gehört zu den Checks, wenn sich docs/ ändert. Die Startseite ist zugleich die Produkt-Website (Hero, Rundgang in Screenshots, Vertrauen, Umstieg), wie bei kontext.email. Seiten: Überblick, Installation, Sicherheitsdesign, Import und Export, Extension, Handy und App, Verwaltung, FAQ, Datenschutz.
  • Screenshots: Workflow „Update screenshots“ mit Playwright für Web-App, Extension-Popup, Inline-Menü und Handy, hell und dunkel; nach jeder Änderung am Aussehen schaut sich der Agent die neuen Bilder an.
  • Demo ohne Server: die Web-App unter /demo/ der Doku-Seite mit einem Server-Ersatz im Browser, der verschlüsselte Daten nur im Speicher hält; derselbe Ersatz dient den Tests. Testdaten „Weber Haustechnik“, deutlicher Hinweis, keine echten Passwörter einzugeben. Niedrige Priorität, Bauphase 8.

Handy und Mobile-App

Am Handy bietet Kennwort dauerhaft beides an: die PWA ohne Installation und die Tauri-3-App, die systemweit ausfüllt. In Firefox für Android läuft zusätzlich die Extension.

Angebot Wann Ausfüllen am Handy
PWA Bauphase 3 Kopieren mit einem Tipp; Zwischenablage wird nicht automatisch geleert
Extension in Firefox für Android Bauphase 4 Inline-Menü wie am Desktop
Tauri-3-Mobile-App Bauphase 8 (iOS von Hand) systemweit in allen Apps und Browsern, dazu Passkeys

Wer was nutzt: Die App ist für alle, die täglich am Handy ausfüllen. Die PWA bleibt für Aushilfen, fremde oder geteilte Geräte, Baustellen-Tablets und alle, die nichts installieren wollen oder dürfen, auch auf dem iPhone ohne App Store. Beide nutzen dieselben Pakete (packages/ui, packages/core, packages/crypto).

Tauri 3: Stand 19.11.2026 ist 3.0.0-alpha.6 (6.11.2026) aktuell, der 3.0-Meilenstein zu 31 % erledigt; stabil ist Tauri 2.12. Die App kommt als letzte Bauphase, damit Tauri 3 bis dahin möglichst stabil ist; ist es dann nicht stabil, nimmt der Loop die neueste Alpha oder 2.x.

Aufbau:

  • Oberfläche aus packages/ui, Kryptografie aus packages/crypto im WebView; der Rust-Kern bleibt dünn.
  • Account Key mit Biometrie im iOS-Schlüsselbund bzw. Android Keystore verpackt.
  • Natives Plugin je Plattform: Android AutofillService (Kotlin, seit Chrome 135 auch in Chrome nutzbar) baut der Loop; die iOS AutoFill-Credential-Provider-Extension (Swift, eigenes Xcode-Target) mit Passkeys baut ein Mensch auf einem Mac.
  • Zwischenablage nach 30 s leeren, Bildschirmschutz gegen Screenshots in der Eintragsansicht.

Verteilung:

  • Android: APK in den GitHub-Releases, Updates über Obtainium oder ein eigenes F-Droid-Repo, optional Play Store. Googles Entwickler-Verifizierung für Apps außerhalb des Play Stores (ab 2026 schrittweise) beachten.
  • iPhone: nur über Apple – App Store, öffentlich oder als Unlisted App; für Firmen auch als Custom App über Apple Business Manager.
  • Lizenz: Die App-Store-Bedingungen gelten als unvereinbar mit der AGPL; entschieden ist ein CLA für Beitragende (siehe Entscheidungen).

Import und Export

Wer wechselt, nimmt alles mit: Einträge, Ordner, geteilte Ordner, TOTP, Notizen und eigene Felder. Der Import läuft komplett im Client; die Datei verlässt nie das Gerät und wird nie hochgeladen.

Von Format
Bitwarden / Vaultwarden JSON (auch Organisationen und Sammlungen), verschlüsseltes JSON, CSV
LastPass CSV aus dem Web-Tresor (geteilte Ordner als Gruppen)
1Password 1PUX, CSV
KeePass / KeePassXC KDBX 4, KeePass-2-XML, CSV
Team Password Manager CSV (Projekte als Tresore)
Passbolt CSV, KDBX
Dashlane, Proton Pass, Keeper, NordPass, Enpass CSV bzw. JSON/ZIP
Chrome, Edge, Firefox, Safari / Apple Passwörter CSV
Beliebige Tabelle CSV mit Spaltenzuordnung
Jeder Manager mit FIDO Credential Exchange (CXF/CXP) verschlüsselte Übertragung, auch Passkeys; sobald der Standard stabil ist
Google Authenticator, Aegis, 2FAS, Microsoft Authenticator Export-QR-Code (otpauth-migration) bzw. JSON-Export; Microsoft soweit dessen Export es erlaubt; TOTP wird dem passenden Login zugeordnet

Ablauf:

  1. Anbieter wählen; Kennwort zeigt in drei Schritten, wo dort der Export ist.
  2. Datei laden; Vorschau mit Zuordnung: Ordner und Sammlungen werden Tresore, geteilte Ordner geteilte Tresore mit Gruppen.
  3. Doppelte Einträge erkennen und zusammenführen; schwache und mehrfach genutzte Passwörter gleich zum Ändern markieren.
  4. Verschlüsseln und hochladen; danach Hinweis, die unverschlüsselte Exportdatei zu löschen.

Umsetzung: ein Parser pro Format als reine Funktion in packages/core (Datei rein, Einträge raus), getestet mit echten, anonymisierten Exportdateien je Anbieter als Fixtures. KDBX wird mit den @noble-Bausteinen gelesen (Argon2, ChaCha20, AES), ohne zusätzliche Bibliothek.

Export ohne Lock-in: eigener verschlüsselter Export (JSON mit Passwort), CSV, KDBX und CXF, sobald verfügbar. Exportieren dürfen nur Verwalter eines Tresors, und es landet im Audit-Log.

Funktionsumfang 1.0

Die vollständige Liste mit Bauphasen und Akzeptanzkriterien steht in der Bauliste. Version 1.0 ist fertig, wenn dort alles abgehakt ist und die menschlichen Schritte erledigt sind.

Offene Fragen

  • Marke: „Kennwort“ als Wort-Bild-Marke anmelden? Store-Namen prüfen (Chrome, Firefox, App Store, Play).
  • Liefert Stalwart selbst einen groups-Claim, oder bekommt ihn Kontexts OIDC-Provider dazu?
  • Ab wann Budget für das externe Audit, und welcher Prüfer?
  • Aktueller Stand von Googles Entwickler-Verifizierung für APKs außerhalb des Play Stores?
  • Bringt Tauri 3 für Mobile genug, um auf die stabile Version zu warten?

Quellen