nevaforget 09e0d47a38 fix: audit fixes — async restart_verify, locale caching, panic safety (v0.5.0)

- restart_verify() now async via spawn_future_local (was blocking main thread)
- stop() uses 3s timeout instead of unbounded
- load_strings() caches locale detection in OnceLock (was reading /etc/locale.conf on every call)
- child_get() replaced with child_value().get() for graceful D-Bus type mismatch handling
- Eliminate redundant password clone in auth path (direct move into spawn_blocking)
- Add on_exhausted callback: hides fp_label after MAX_FP_ATTEMPTS
- Set running=false before on_success callback (prevent double-unlock)
- Add 4 unit tests for on_verify_status state machine
- Document GLib-GString/CString zeroize limitation in CLAUDE.md

2026-03-28 10:16:06 +01:00

2.9 KiB

Raw Blame History

Moonlock

Name: Nyx (Göttin der Nacht — passend zum Lockscreen, der den Bildschirm verdunkelt)

Projekt

Moonlock ist ein sicherer Wayland-Lockscreen, gebaut mit Rust + gtk4-rs + ext-session-lock-v1. Teil des Moonarch-Ökosystems.

Tech-Stack

Rust (Edition 2024), gtk4-rs 0.11, glib 0.22
gtk4-session-lock 0.4 für ext-session-lock-v1 Protokoll
PAM-Authentifizierung via Raw FFI (libc, libpam.so)
fprintd D-Bus Integration (gio::DBusProxy) für Fingerabdruck-Unlock
zeroize für sicheres Passwort-Wiping
cargo test für Unit-Tests

Projektstruktur

src/ — Rust-Quellcode (main.rs, lockscreen.rs, auth.rs, fingerprint.rs, config.rs, i18n.rs, users.rs, power.rs)
resources/ — GResource-Assets (style.css, wallpaper.jpg, default-avatar.svg)
config/ — PAM-Konfiguration und Beispiel-Config

Kommandos

# Tests ausführen
cargo test

# Release-Build
cargo build --release

# Lockscreen starten (zum Testen)
LD_PRELOAD=/usr/lib/libgtk4-layer-shell.so ./target/release/moonlock

Architektur

auth.rs — PAM-Authentifizierung via Raw FFI (unsafe extern "C" conv callback, msg_style-aware, Zeroizing<Vec>)
fingerprint.rs — fprintd D-Bus Listener, async init/claim/verify via gio futures, sync stop with 3s timeout, on_exhausted callback after MAX_FP_ATTEMPTS
users.rs — Aktuellen User via nix getuid, Avatar-Loading mit Symlink-Rejection
power.rs — Reboot/Shutdown via /usr/bin/systemctl
i18n.rs — Locale-Erkennung (OnceLock-cached) und String-Tabellen (DE/EN), faillock_warning mit konfigurierbarem max_attempts
config.rs — TOML-Config (background_path, fingerprint_enabled als Option) + Wallpaper-Fallback
lockscreen.rs — GTK4 UI via LockscreenHandles, PAM-Auth via gio::spawn_blocking, FP-Label/Start separat verdrahtet, Zeroizing für Passwort, Power-Confirm
main.rs — Entry Point, Panic-Hook, Root-Check, ext-session-lock-v1 (Pflicht in Release), Multi-Monitor, systemd-Journal-Logging, async fprintd-Init nach window.present()

Sicherheit

ext-session-lock-v1 garantiert: Compositor sperrt alle Surfaces bei lock()
Release-Build: Ohne ext-session-lock-v1 wird exit(1) aufgerufen — kein Fenster-Fallback
Panic-Hook: Bei Crash wird geloggt, aber NIEMALS unlock() aufgerufen — Screen bleibt schwarz
PAM-Callback: msg_style-aware (Passwort nur bei PAM_PROMPT_ECHO_OFF), strdup-OOM-sicher
Passwort: Zeroizing ab GTK-Entry-Extraktion, Zeroizing<Vec> im PAM-FFI-Layer (bekannte Einschränkung: GLib-GString und CString werden nicht gezeroized — inhärente GTK/libc-Limitierung)
Root-Check: Exit mit Fehler wenn als root gestartet
Faillock: UI-Warnung nach 3 Fehlversuchen, aber PAM entscheidet über Lockout (Entry bleibt aktiv)
Kein Schließen per Escape/Alt-F4 — nur durch erfolgreiche PAM-Auth oder Fingerprint
GResource-Bundle: CSS/Assets in der Binary kompiliert

2.9 KiB Raw Blame History