Rewrite moonlock from Python to Rust (v0.4.0)
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.
This commit is contained in:
@@ -4,50 +4,53 @@
|
||||
|
||||
## Projekt
|
||||
|
||||
Moonlock ist ein sicherer Wayland-Lockscreen, gebaut mit Python + GTK4 + ext-session-lock-v1.
|
||||
Teil des Moonarch-Ökosystems. Visuell und architektonisch inspiriert von Moongreet.
|
||||
Moonlock ist ein sicherer Wayland-Lockscreen, gebaut mit Rust + gtk4-rs + ext-session-lock-v1.
|
||||
Teil des Moonarch-Ökosystems.
|
||||
|
||||
## Tech-Stack
|
||||
|
||||
- Python 3.11+, PyGObject (GTK 4.0)
|
||||
- Gtk4SessionLock (ext-session-lock-v1) für protokoll-garantiertes Screen-Locking
|
||||
- PAM-Authentifizierung via ctypes-Wrapper (libpam.so.0)
|
||||
- fprintd D-Bus Integration (Gio.DBusProxy) für Fingerabdruck-Unlock
|
||||
- pytest für Tests
|
||||
- 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/moonlock/` — Quellcode
|
||||
- `src/moonlock/data/` — Package-Assets (Default-Avatar, Icons)
|
||||
- `tests/` — pytest Tests
|
||||
- `config/` — Beispiel-Konfigurationsdateien
|
||||
- `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
|
||||
|
||||
```bash
|
||||
# Tests ausführen
|
||||
uv run pytest tests/ -v
|
||||
cargo test
|
||||
|
||||
# Typ-Checks
|
||||
uv run pyright src/
|
||||
# Release-Build
|
||||
cargo build --release
|
||||
|
||||
# Lockscreen starten (zum Testen)
|
||||
uv run moonlock
|
||||
LD_PRELOAD=/usr/lib/libgtk4-layer-shell.so ./target/release/moonlock
|
||||
```
|
||||
|
||||
## Architektur
|
||||
|
||||
- `auth.py` — PAM-Authentifizierung via ctypes (libpam.so.0)
|
||||
- `fingerprint.py` — fprintd D-Bus Listener (Gio.DBusProxy, async im GLib-Mainloop)
|
||||
- `users.py` — Aktuellen User ermitteln, Avatar laden
|
||||
- `power.py` — Reboot/Shutdown via loginctl
|
||||
- `i18n.py` — Locale-Erkennung und String-Tabellen (DE/EN)
|
||||
- `lockscreen.py` — GTK4 UI (Avatar, Passwort-Entry, Fingerprint-Indikator, Power-Buttons)
|
||||
- `main.py` — Entry Point, GTK App, Session Lock Setup (ext-session-lock-v1)
|
||||
- `auth.rs` — PAM-Authentifizierung via Raw FFI (unsafe extern "C" conv callback, Zeroizing<Vec<u8>>)
|
||||
- `fingerprint.rs` — fprintd D-Bus Listener (gio::DBusProxy, VerifyStatus Signal-Handling)
|
||||
- `users.rs` — Aktuellen User via nix getuid, Avatar-Loading mit Symlink-Rejection
|
||||
- `power.rs` — Reboot/Shutdown via /usr/bin/loginctl
|
||||
- `i18n.rs` — Locale-Erkennung und String-Tabellen (DE/EN)
|
||||
- `config.rs` — TOML-Config (background_path, fingerprint_enabled) + Wallpaper-Fallback
|
||||
- `lockscreen.rs` — GTK4 UI, PAM-Auth via gio::spawn_blocking, Fingerprint-Indikator, Power-Confirm
|
||||
- `main.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()
|
||||
- Bei Crash bleibt Screen schwarz (nicht offen)
|
||||
- Passwort wird nach Verwendung im Speicher überschrieben
|
||||
- Kein Schließen per Escape/Alt-F4 — nur durch erfolgreiche Auth
|
||||
- Panic-Hook: Bei Crash wird geloggt, aber NIEMALS unlock() aufgerufen — Screen bleibt schwarz
|
||||
- Passwort: Zeroizing<Vec<u8>> 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
|
||||
|
||||
Reference in New Issue
Block a user