lsPass — 로컬 암호화 비밀번호 관리자

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

lsPass는 로그인, 보안 메모 및 API 키를 로컬 암호화 볼트(vault)에 저장합니다. 네트워크 없음, 클라우드 없음, 원격 측정(telemetry) 없음. 어떤 비밀 정보도 일반 텍스트로 디스크에 기록되지 않습니다.

빌드 및 테스트

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

볼트는 ~/.local/share/lspass/vault.db에 저장됩니다(권한 0600).

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

.deb 파일은 packages/deb/에 생성되며 바이너리, com.lspass.App.desktop 런처 항목, 앱 아이콘(packaging/com.lspass.App.svg, hicolor 테마로 설치됨)을 포함합니다.

CPack 없이 실행하는 cmake --install은 기본 /usr/local 접두사를 사용합니다. 런타임 종속성(libgtkmm-4.0, libsodium, libsqlite3, …)은 dpkg-shlibdeps가 자동으로 해결하므로, apt --fix-broken install 또는 sudo apt install ./lspass_1.0.0_amd64.deb만으로 필요한 모든 항목이 설치됩니다.

보안 설계 (조사된 모범 사례)

OWASP 비밀번호 저장 치트 시트(Password Storage Cheat Sheet), libsodium 문서, 그리고 기존 비밀번호 관리자(Bitwarden, KeePassXC 스타일 키 래핑)에서 사용하는 봉투 암호화(envelope-encryption) 패턴을 기반으로 합니다:

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])

이러한 선택의 이유:

솔직한 절충: title, username, url은 모든 행을 복호화하지 않고도 목록/검색이 작동하도록 일반 텍스트로 저장됩니다. 비밀 자체(비밀번호, 메모, API 키)는 항상 봉인된 블롭(sealed blob)입니다. 단위 테스트 secrets_not_stored_in_plaintext는 볼트 파일(WAL 포함)을 바이트 단위로 스캔하여 카나리아(canary) 비밀이 저장되어 있지 않음을 증명합니다.

테스트

ctest는 GUI가 필요 없는 핵심 라이브러리를 대상으로 세 개의 스위트(41개 케이스)를 실행합니다. 전체 스위트는 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

릴리스 빌드는 -fstack-protector-strong, -D_FORTIFY_SOURCE=2, PIE 및 전체 RELRO(-Wl,-z,relro,-z,now)를 추가합니다.

• crypto — AEAD 왕복(round-trip), 빈 평문, 잘린 블롭 거부, 잘못된 키/변조/AAD 불일치 거부, nonce 고유성, KDF 결정성, 솔트 및 유니코드 비밀번호 처리, 키 래핑/언래핑, 상수 시간 비교 경계 케이스.
• vault — 생성/재열기, 잘못된 비밀번호 거부, CRUD, 영속성, 유니코드 및 100 KiB 비밀, 잘못된 ID 처리, 일반 텍스트 없음 카나리아 스캔, 검색, 설정 영속성, 마스터 비밀번호 변경, 변조된 항목/헤더 감지, 손상된 KDF 매개변수 거부.
• generator — 경계 길이를 포함한 길이/문자셋 보장, 클래스 커버리지, 고유성, 엔트로피 추정, 암호구(passphrase) 형식/경계, 잘못된 옵션 처리.

구조

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)

라이선스

MIT — LICENSE 참조.