Complete rewrite of the Wayland lockscreen from Python/PyGObject to Rust/gtk4-rs for memory safety in security-critical PAM code and consistency with the moonset/moongreet Rust ecosystem. Modules: main, lockscreen, auth (PAM FFI), fingerprint (fprintd D-Bus), config, i18n, users, power. 37 unit tests. Security: PAM conversation callback with Zeroizing password, panic hook that never unlocks, root check, ext-session-lock-v1 compositor policy, absolute loginctl path, avatar symlink rejection.
2.1 KiB
2.1 KiB
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 testfü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, Zeroizing<Vec>)fingerprint.rs— fprintd D-Bus Listener (gio::DBusProxy, VerifyStatus Signal-Handling)users.rs— Aktuellen User via nix getuid, Avatar-Loading mit Symlink-Rejectionpower.rs— Reboot/Shutdown via /usr/bin/loginctli18n.rs— Locale-Erkennung und String-Tabellen (DE/EN)config.rs— TOML-Config (background_path, fingerprint_enabled) + Wallpaper-Fallbacklockscreen.rs— GTK4 UI, PAM-Auth via gio::spawn_blocking, Fingerprint-Indikator, Power-Confirmmain.rs— Entry Point, Panic-Hook, Root-Check, ext-session-lock-v1, Multi-Monitor
Sicherheit
- ext-session-lock-v1 garantiert: Compositor sperrt alle Surfaces bei lock()
- Panic-Hook: Bei Crash wird geloggt, aber NIEMALS unlock() aufgerufen — Screen bleibt schwarz
- Passwort: Zeroizing<Vec> für sicheres Wiping nach PAM-Callback
- Root-Check: Exit mit Fehler wenn als root gestartet
- Kein Schließen per Escape/Alt-F4 — nur durch erfolgreiche PAM-Auth oder Fingerprint
- GResource-Bundle: CSS/Assets in der Binary kompiliert