Einführung in QubKey
Lokaler Rust-Passwortmanager: .rkvey-Architektur, Zero-Knowledge und Tauri-Stack.
QubKey ist ein lokaler, Open-Source-Passwortmanager, der als digitales Tresorsystem konzipiert ist – nicht als einfache verschlüsselte Datei. Jede Ebene – Format, Kryptografie, Index und Anwendung – ist darauf ausgelegt, zusammenzuarbeiten und Ihre Geheimnisse durchgängig zu schützen.
Die native Desktop-App kombiniert Rust (kryptografischer Kern), Tauri (leichte System-Shell) und React (UI). Ihre Geheimnisse liegen in einer .rkvey-Datei (Rust Key Vault) auf der Festplatte, verschlüsselt mit bewährten Primitiven und strikter Interessenstrennung.
Diese Dokumentation richtet sich an Einzelpersonen, die ihre Anmeldeinformationen sichern, und an technische Teams, die die Architektur bewerten. Beginnen Sie mit Installation oder Erster Tresor; siehe Versionshinweise für den Build-Verlauf; Informationen zur Sicherheit finden Sie unter Architektur.
Designphilosophie
- Der Tresor ist ein System – Identifizierung, Konfiguration, Index und Daten sind unterschiedliche Ebenen.
- Krypto ist kein Zusatz – Verschlüsselung, Ableitung und Integrität sind in das Format integriert.
- Belastbarkeit ist obligatorisch – WAL, sichere Commits und Crash-Recovery sind Teil des Modells.
Diagramm: Anwendungsübersicht
Schnittstelle (React + Tauri)
- Gewölbe
- Ordner
- Suchen
- Generator
- Einmalige Codes
- Armaturenbrett
- Synchronisieren
- Teilen
- Browser-Erweiterung
Rostkern (QubKey Core)
- .rkvey v5-Format
- Argon2id-Ableitung
- Authentifizierte Verschlüsselung
- Suchindex
- Sichere Commits
- Speicherlöschung
- Crash-Recovery
.rkvey v5-Datei im Dateisystem
- Präambel
- Verschlüsselter Header
- Verschlüsselter Index
- Geheimfächer
- Anhänge
- Commit-Verlauf
Grundprinzipien
Local-first
Ihre Tresordatei befindet sich in Ihrem Dateisystem. Für den Kernbetrieb ist kein Internet erforderlich – Ihre Daten werden niemals über einen QubKey-Server übertragen.
Zero-knowledge
Das Master-Passwort verlässt Ihren Computer niemals. Die Wiederherstellung basiert auf dem Wiederherstellungsschlüssel, den Sie bei der Erstellung speichern – QubKey kann ihn nicht lesen oder zurücksetzen.
Open source
Der Rust-Kern, die Tauri-Shell und das React-Frontend sind Open-Source (MIT) und können von der Community und den Sicherheitsteams überprüft werden.
Warum Rost?
| Nutzen | Umsetzung | Vorteil |
|---|---|---|
Memory safety | Compiler guarantee | Beseitigt Pufferüberläufe, Use-After-Free und Datenwettläufe – häufige C/C++-Schwachstellenquellen |
Zeroization | zeroize crate | Garantiertes Löschen von Schlüsseln und Geheimnissen im RAM, wenn der Tresor gesperrt wird |
Performance | Native | Kalibriertes Argon2id ohne unvorhersehbare GC – stabile, vorhersehbare Freischaltung (~500 ms) |
Crypto | RustCrypto | Geprüfte AEAD- und Argon2-Grundelemente – keine selbst entwickelte Neuimplementierung |
Technischer Stapel
| Komponente | Technologie | Rolle |
|---|---|---|
| Kern | Rost | Krypto, .rkvey-Format, WAL |
| Desktop-Shell | Tauri | Sicherer IPC, Dateizugriff |
| Benutzeroberfläche | Reagieren + TypeScript | UX, Suche, Dashboard |
| Verschlüsselung | AES-256-GCM, XChaCha20 | AEAD pro Eintrag |
| Ableitung | Argon2id | Master-Passwort → Master-Schlüssel |
| Formatieren | .rkvey v4 | Schichtengewölbe |
Projektstruktur
20 Eintragstypen
QubKey bietet 20 Typen (EntryType, Diskriminanten 0–19). Jeder Typ akzeptiert auch verschlüsselte Anhänge (mehrere Dateien, Ordner). Siehe den Vollständigen Katalog für jedes EntryData-Variantenschema.
Passwörter
Passwort, SSHKey, PGPKey, TokenLogin, Passkey, RecoveryCodes
Finanziell
Kreditkarte, Bankkonto, CryptoWallet
Identität
Nationale ID, Reisepass, Führerschein, Gesundheits-ID, Profil, Kontaktadresse
Notiz
Hinweis: RecoveryPhrase, ConfigSnippet
Dokumentieren
Dokumentieren
Gerätezugriff
W-lan