lsPass — gestore di password locale e cifrato

GTK4 / gtkmm-4 · C++23 · CMake · SQLite · libsodium

lsPass archivia credenziali di accesso, note sicure e chiavi API in una cassaforte locale cifrata. Nessuna rete, nessun cloud, nessuna telemetria. Nessun segreto viene mai scritto su disco in chiaro.

Compilazione e test

sudo apt install libgtkmm-4.0-dev libsqlite3-dev libsodium-dev nlohmann-json3-dev
cmake -B build
cmake --build build -j
ctest --test-dir build --output-on-failure   # 41 unit tests
./build/lspass

La cassaforte si trova in ~/.local/share/lspass/vault.db (permessi 0600).

Pacchetto Debian/Ubuntu

cmake -B build-rel -DCMAKE_BUILD_TYPE=Release
cmake --build build-rel -j
cd build-rel && cpack -G DEB        # requires: dpkg-dev, file
sudo dpkg -i ../packages/deb/lspass_1.0.0_amd64.deb

Il .deb finisce in packages/deb/ e include il binario, una voce di avvio com.lspass.App.desktop e l'icona dell'app (packaging/com.lspass.App.svg, installata nel tema hicolor).

cmake --install senza CPack usa il prefisso predefinito /usr/local. Le dipendenze runtime (libgtkmm-4.0, libsodium, libsqlite3, …) vengono risolte automaticamente da dpkg-shlibdeps, quindi apt --fix-broken install o sudo apt install ./lspass_1.0.0_amd64.deb recupera tutto il necessario.

Progettazione della sicurezza (best practice basate su ricerche)

Basata sull'OWASP Password Storage Cheat Sheet, sulla documentazione di libsodium e sul pattern di cifratura a busta (envelope encryption) usato da gestori di password affermati (key wrapping stile Bitwarden, KeePassXC):

master password
      │  Argon2id  (memory-hard KDF, random 128-bit salt,
      ▼            opslimit/memlimit = libsodium "moderate",
    KEK (32 B)     parameters stored in vault for future upgrades)
      │  XChaCha20-Poly1305 (key wrap)
      ▼
    DEK (32 B, random)  ── wraps nothing else, RAM only, never on disk
      │  XChaCha20-Poly1305 AEAD per field
      ▼
SQLite: entries(title, username, url [plaintext metadata],
                secret, notes [sealed blobs: nonce‖ct‖poly1305 tag])

Perché queste scelte:

Compromesso onesto: title, username e url sono memorizzati in chiaro, così l'elenco/ricerca funziona senza decifrare ogni riga. I segreti stessi (password, note, chiavi API) sono sempre blob sigillati. Il test unitario secrets_not_stored_in_plaintext esegue una scansione byte per byte del file della cassaforte (incl. WAL) alla ricerca di un segreto canarino per dimostrarlo.

Test

ctest esegue tre suite (41 casi) contro la libreria core indipendente dalla GUI. L'intera suite viene anche eseguita con AddressSanitizer + UBSan:

cmake -B build-san -DCMAKE_CXX_FLAGS="-fsanitize=address,undefined" \
      -DCMAKE_EXE_LINKER_FLAGS="-fsanitize=address,undefined"
cmake --build build-san -j && ctest --test-dir build-san

Le build Release aggiungono -fstack-protector-strong, -D_FORTIFY_SOURCE=2, PIE e RELRO completo (-Wl,-z,relro,-z,now).

• crypto — round-trip AEAD, plaintext vuoto, rifiuto di blob troncati, rifiuto per chiave errata/manomissione/disallineamento AAD, unicità dei nonce, determinismo del KDF, gestione di salt e password unicode, key wrap/unwrap, casi limite del confronto a tempo costante.
• vault — creazione/riapertura, rifiuto di password errata, CRUD, persistenza, segreti unicode e da 100 KiB, gestione di ID non validi, scansione canarino senza plaintext, ricerca, persistenza delle impostazioni, cambio della password principale, rilevamento di entry/header manomessi, rifiuto di parametri KDF corrotti.
• generator — garanzie su lunghezza/charset incluse lunghezze limite, copertura delle classi, unicità, stima dell'entropia, formato/limiti della passphrase, gestione di opzioni non valide.

Struttura

src/core/crypto.{hpp,cpp}     SecureBytes, Argon2id KDF, XChaCha20-Poly1305, key wrap
src/core/vault.{hpp,cpp}      SQLite vault, envelope encryption, CRUD
src/core/generator.{hpp,cpp}  CSPRNG password/passphrase generator
src/ui/                       gtkmm-4 UI (unlock screen, list, editor dialogs)
tests/                        ctest suites (no external framework needed)

Licenza

MIT — vedi LICENSE.