Erstellen oder entsperren Sie den Vault zuerst mit seinem Master-Passwort. Öffnen Sie Einstellungen → Sicherheit, prüfen Sie den Anbieterstatus und aktivieren Sie die biometrische Entsperrung. Die Registrierung verlangt eine erneute Systemauthentifizierung. Danach bietet das Anmelde-Overlay neben dem Master-Passwort-Formular die Entsperrung mit Touch ID, Windows Hello oder Fingerabdruck an. Registrierung deaktivieren und entfernen entfernt den von dieser Anwendung zwischengespeicherten Schlüssel, niemals die im Betriebssystem registrierten Fingerabdrücke.
Behalten Sie das Master-Passwort: Abbruch, Zeitüberschreitung, nicht verfügbare Hardware/Schlüsselbund und eine ungültig gewordene Registrierung erfordern immer die Anmeldung per Passwort. Die biometrische Registrierung gilt lokal für diesen Benutzer, dieses Gerät und diesen Vault. Sie ist weder ein Wiederherstellungsmechanismus noch eine Sicherung. Das Zurücksetzen des Vaults widerruft die Registrierung und löscht vorhandene verschlüsselte Profile und Host-Fingerabdrücke erst nach der bestehenden Bestätigung SMAZAT.
| Plattform | Authentifizierung und Speicherung | Anforderungen und Grenzen |
|---|---|---|
| macOS Apple Silicon | Native LocalAuthentication / Touch ID; Keychain-Eintrag in Security.framework mit biometryCurrentSet und WhenUnlockedThisDeviceOnly |
Registrierte Touch ID, verfügbarer Sensor und eine nutzbare Anmelde-Keychain. Änderungen der Fingerabdrücke machen den Eintrag ungültig. Verwenden Sie für Produktionsaktualisierungen eine stabile Developer-ID-Signatur; eine Ad-hoc-Signatur von Alpha-Versionen kann das Keychain-Vertrauen und die Verfolgung der Berechtigung für das lokale Netzwerk stören. |
| Windows x64 | Native WinRT-Desktop-Schnittstelle für Windows Hello, an das Haupt-HWND gebunden; mit DPAPI des aktuellen Benutzers verschlüsselter Schlüssel in der Windows-Anmeldeinformationsverwaltung | Eingerichteter Fingerabdruck, Gesichtserkennung oder PIN in Windows Hello. Dies ist eine Komfort-Entsperrung: Die Freigabe durch Windows Hello erzwingt die Anwendung, DPAPI selbst ist jedoch nicht biometrisch geschützt. Anderer Code, der unter demselben Benutzer läuft, kann die Anmeldeinformation entschlüsseln. |
| Ubuntu x64 | Registrierter Fingerabdruck des aktuellen Benutzers über fprintd D-Bus; ausdrückliche Speicherung der Anmeldeinformation über libsecret / Secret Service | Unterstütztes Lesegerät, registrierter Fingerabdruck, laufender Desktop-Dienst Secret Service und Standard-Schlüsselbund. Komfort-Entsperrung: Die Anmeldeinformation im Schlüsselbund ist nicht kryptografisch an die Fingerabdruckprüfung gebunden. Kein Ausweichen auf basic_text oder eine Klartextdatei. |
Unter Ubuntu sind die optionalen Laufzeitpakete python3-gi, gir1.2-secret-1, gnome-keyring (oder ein anderer kompatibler Secret Service) und fprintd. Installieren Sie fehlende Pakete mit dem normalen Paketmanager des Systems und registrieren Sie anschließend einen Fingerabdruck in den Systemeinstellungen. Die Authentifizierung verwendet den aktuellen Benutzer, benötigt kein root und ändert PAM nicht. Eine Headless-SSH-Sitzung ohne Desktop-Schlüsselbund meldet Nichtverfügbarkeit; ein Schlüssel wird nie stillschweigend anderswo gespeichert.
Sperrregeln
Bei bestehenden Installationen ist die automatische Sperre ausgeschaltet. Beim Einschalten werden standardmäßig 15 Minuten gewählt; unterstützte Werte sind Nie, 1, 5, 10, 15, 30 und 60 Minuten. Tastatur- und Mauseingaben in Anwendungsfenstern zählen als Aktivität; eingehende SSH-Ausgabe nicht. Die optionale Sperre bei Fokusverlust behandelt Plugin-Fenster als Teil der Anwendung und lässt eine laufende Systemauthentifizierung abschließen. Das Ändern dieser Regeln erfordert das Master-Passwort.
Jede Sperre des Vaults, einschließlich Sperre wegen Inaktivität und Fokusverlust, trennt aktive SSH-Sitzungen, schließt Plugins und stoppt die Diagnose. Speichern Sie entfernte Änderungen vor dem Sperren. Damit bleibt das bisherige Verhalten der manuellen Sperre erhalten; nach einer Sperre stehen Plugins im Hintergrund keine SSH-Anmeldeinformationen mehr zur Verfügung.
Die optionale Richtlinie für sensible Vorgänge verlangt eine erneute Systemauthentifizierung beim Löschen von Profilen, Installieren/Entfernen von Plugins, Starten des Installers und Zurücksetzen eines entsperrten Vaults. Befehle im entfernten Terminal und Dateiänderungen durch Plugins fallen nicht unter diese Richtlinie. Die Richtlinie ersetzt nicht die Autorisierung auf dem SSH-Server. Funktioniert der Anbieter nicht mehr, entsperren Sie mit dem Master-Passwort und ändern Sie die Richtlinie mit diesem Passwort. Das Zurücksetzen bleibt nach seiner destruktiven Bestätigung über den gesperrten Wiederherstellungsbildschirm verfügbar.
Vault- und IPC-Design
Der bestehende Vault v1 bleibt AES-256-GCM mit scrypt; die Registrierung schreibt seine Dateien nicht um und ändert sein Schema nicht. Nur eine Kopie seines abgeleiteten 32-Byte-Schlüssels gelangt in den Anmeldeinformationsspeicher des Systems. Das Master-Passwort im Klartext wird nie gespeichert. Die lokalen Registrierungsmetadaten enthalten eine zufällige Anmeldeinformations-ID, den Anbieter und eine SHA-256-Bindung an die unveränderlichen Metadaten des Vaults. Ein wiederhergestellter Schlüssel muss die authentifizierte Entschlüsselung bestehen, bevor eine Sitzung geöffnet wird. Puffer des Hauptprozesses werden nach der Verwendung geleert; Zeichenketten des nativen Protokolls sind flüchtiger Prozessspeicher, keine Zusage vollständiger Speicherlöschung in verwalteten Laufzeitumgebungen.
Das Hilfsprogramm kommuniziert über begrenzte private stdin/stdout-Pipes, nimmt keine Shell-Befehle an, hat Zeitlimits für die Authentifizierung und gibt bereinigte Fehlercodes zurück. Hilfsprogramme werden außerhalb von ASAR in resources/biometrics paketiert; es sind eigenständige native ausführbare Dateien, daher ist kein natives Modul mit Electron-ABI erforderlich. Das Linux-Hilfsprogramm verwendet das System-Python und GI. Native Objekte und abgeleitete Schlüssel überqueren niemals die Renderer-/Plugin-Brücke. Biometrisches IPC prüft das aktive Hauptfenster und dessen Hauptframe; Plugins können es nicht aufrufen. Eine ausdrückliche Sperre bricht laufende biometrische und Passwort-Entsperrungen ab, sodass eine verspätete Freigabe den Vault nicht wieder öffnen kann. Das Entfernen der Registrierung widerruft ihre lokale Bindung auch dann, wenn der Systemspeicher offline ist; ein nicht erreichbarer Speicher kann eine unbrauchbare verwaiste Anmeldeinformation behalten.
Build und Prüfung
npm run biometrics:build erstellt das Hilfsprogramm für die Host-Plattform; Entwicklungsstart und Release-Vorbereitung rufen es automatisch auf. macOS benötigt Swift/Apple SDK mit Security und LocalAuthentication; Windows benötigt Visual Studio C++ Build Tools, Windows SDK und C++/WinRT; Linux kopiert das Python-Hilfsprogramm. Es werden keine neuen npm-Abhängigkeiten hinzugefügt. Bauen Sie nativ auf jedem Zielsystem. Das macOS-Hilfsprogramm ist in die rekursive Bundle-Signierung einbezogen; es benötigt keine App-Sandbox-Berechtigung, weil diese Desktop-Anwendung nicht in einer Sandbox läuft. Die Produktionsverteilung für macOS erfordert weiterhin Developer-ID-Signatur und Notarisierung, unabhängig von den OpenPGP-Signaturen der Veröffentlichungen.
Führen Sie npm test, npm run test:biometrics:ui und npm run test:diagnostics:ui aus. Biometrische Node-Tests und der isolierte UI-Smoke-Test verwenden einen Mock-OS-Adapter und decken Erfolg, Ablehnung/Abbruch, falsche Schlüssel, fehlende Hardware/Registrierung, Zurücksetzen, Zeitüberschreitung und verspätete Ergebnisse, nicht verfügbare Linux-Schlüsselbunde, Fehler des System-Anmeldeinformationsspeichers, per PIN freigegebene Antworten unter Windows, Registrierungsänderungen unter macOS, Kompatibilität mit bestehenden Vaults, IPC-Isolation und SSH-Bereinigung ab. Eine erfolgreiche Hardware-Authentifizierung ist damit nicht nachgewiesen.
Die native Kompilierung wurde unter macOS arm64 und Windows x64 geprüft. macOS meldet Touch ID als verfügbar; die Windows-VM meldet Windows Hello als nicht verfügbar. Registrierung von Fingerabdruck/Gesicht/PIN, tatsächlicher Abruf des geschützten Schlüssels, Abbruch des Systemdialogs und Ungültigwerden nach Registrierungsänderungen erfordern weiterhin interaktive Hardwaretests auf jedem unterstützten System. Das Linux-Hilfsprogramm muss zusätzlich auf einem Desktop mit einem unterstützten fprintd-Lesegerät getestet werden; eine Headless-VM kann diese Prüfung nicht leisten.
Plattformreferenzen: Biometrische Zugriffskontrolle von Apple, Desktop-Schnittstelle für Windows Hello, Gerätelebenszyklus von fprintd, Spezifikation von Secret Service.
SSH-Zugriff auf das lokale Netzwerk unter macOS
Wenn jedes lokale SSH-Profil mit connect EHOSTUNREACH fehlschlägt, dieselbe Verbindung im Terminal aber funktioniert, prüfen Sie Systemeinstellungen → Datenschutz & Sicherheit → Lokales Netzwerk → CH-J Server Manager, erlauben Sie den Zugriff, beenden Sie die Anwendung vollständig und öffnen Sie sie erneut. Ist der Zugriff bereits erlaubt, schalten Sie die Berechtigung um und starten Sie neu. Prüfen Sie außerdem Routing, WLAN/Ethernet und VPN: Der Fehler allein beweist keine Verweigerung aus Datenschutzgründen. Setzen Sie wegen dieses Fehlers weder den Vault zurück noch verwerfen Sie vertrauenswürdige SSH-Fingerabdrücke.
Die Anwendung deklariert NSLocalNetworkUsageDescription und liefert lokalisierte Hinweise zu Netzwerkberechtigungs- und Routingfehlern unter macOS. Sie kann sich die Berechtigung nicht selbst erteilen. Apple empfiehlt eine von Apple ausgestellte Signaturidentität, damit macOS den Netzwerk-Datenschutz über Builds hinweg zuverlässig verfolgen kann; die aktuellen Ad-hoc-Alpha-Builds haben diese Einschränkung. Siehe Apple-Hinweise zum Datenschutz im lokalen Netzwerk.
Anwendungssymbol unter Ubuntu
Debian-Pakete installieren das bestehende CH-J-Symbol in den Standardgrößen von hicolor (16–512 px) mit passendem Desktop-Eintrag und passender Electron-Fensterklasse. Das Hauptfenster erhält das Symbol auch, wenn es neu erstellt wird. Lösen Sie nach der Aktualisierung einen bereits angehefteten alten Starter und heften Sie die neu installierte Anwendung an; Ab- und Anmelden am Desktop kann einen veralteten GNOME-Starter-Cache aktualisieren.