nevaforget
17f8930ff7
PAM conv callback: check msg_style (password only for ECHO_OFF), handle strdup OOM with proper cleanup, null-check PAM handle. Fingerprint: self-wire D-Bus g-signal in start() via Rc<RefCell<>> and connect_local — VerifyStatus signals are now actually dispatched. VerifyStop before VerifyStart in restart_verify. Lockscreen: password entry stays active after faillock threshold (PAM decides lockout, not UI), use Zeroizing<String> from GTK entry. Release builds exit(1) without ext-session-lock-v1 support. Config: fingerprint_enabled as Option<bool> so empty user config does not override system config. Dead code: remove unused i18n strings and fingerprint accessors, parameterize faillock_warning max_attempts.
60 lines
2.6 KiB
Markdown
60 lines
2.6 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
# 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<u8>>)
|
|
- `fingerprint.rs` — fprintd D-Bus Listener (Rc<RefCell<FingerprintListener>>, self-wiring g-signal via connect_local)
|
|
- `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), faillock_warning mit konfigurierbarem max_attempts
|
|
- `config.rs` — TOML-Config (background_path, fingerprint_enabled als Option<bool>) + Wallpaper-Fallback
|
|
- `lockscreen.rs` — GTK4 UI, PAM-Auth via gio::spawn_blocking, Fingerprint-Indikator, Zeroizing<String> für Passwort, Power-Confirm
|
|
- `main.rs` — Entry Point, Panic-Hook, Root-Check, ext-session-lock-v1 (Pflicht in Release), Multi-Monitor
|
|
|
|
## 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<String> ab GTK-Entry-Extraktion, Zeroizing<Vec<u8>> im PAM-FFI-Layer
|
|
- 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
|