How thunderskull7/secure-password-manager-cpp works
Secure Password Manager is an offline C++ CLI for managing credentials in an authenticated, encrypted local vault. The user enters through the interactive application: create or unlock a vault, manage and search credentials, optionally generate passwords, then save or lock the session. Its domain stages are credential handling, cryptography, serialization, and atomic persistence. The graph also shows secure-memory support and terminal echo control. CLI implementation details were not sampled; workflow links from it follow the README, while internal storage and cryptography links are supported by the excerpts and source index.
Main entry points: PasswordManagerApp.cpp Interactive app · VaultStorage.cpp Vault storage · Vault.cpp Credential vault · CryptoService.cpp Crypto service
Components 17
CLI experience
- Interactive app
src/cli/PasswordManagerApp.cpp - Console I/O
src/cli/Console.cpp - Startup banner
src/ui/Banner.cpp
Credential domain
- Password generator
src/core/PasswordGenerator.cpp - Credential model
src/models/Credential.cpp - Credential validation
src/core/CredentialValidator.cpp - Credential vault
src/core/Vault.cpp - Timestamp service
src/core/Timestamp.cpp
Security services
- Crypto service
src/core/CryptoService.cpp - Sodium initialization
src/core/SodiumInitializer.cpp - Secure key
src/core/SecureKey.cpp - Secure buffer
src/core/SecureBuffer.cpp
Vault persistence
- Vault storage
src/core/VaultStorage.cpp - Binary file format
include/core/VaultFileFormat.hpp - Vault serializer
src/core/VaultSerializer.cpp
Other components
- User
- Local filesystem
Connections 17
- User → Interactive app: uses
README.md - Interactive app → Console I/O: reads and prints
README.md - Interactive app → Startup banner: shows
README.md - Interactive app → Credential vault: manages credentials
README.md - Interactive app → Vault storage: loads and saves
README.md - Interactive app → Password generator: requests passwords
README.md - Credential vault → Credential validation: validates inputs
src/core/Vault.cpp - Credential vault → Credential model: stores records
- Credential vault → Timestamp service: timestamps changes
- Vault storage → Crypto service: derives and encrypts
src/core/VaultStorage.cpp - Vault storage → Vault serializer: serializes credentials
src/core/VaultStorage.cpp - Vault storage → Binary file format: validates header
src/core/VaultStorage.cpp - Vault storage → Local filesystem: reads and writes
src/core/VaultStorage.cpp - Crypto service → Sodium initialization: initializes library
src/core/CryptoService.cpp - Crypto service → Secure key: returns derived key
- Crypto service → Secure buffer: returns plaintext buffer
- Vault serializer → Secure buffer: uses protected buffer