Skip to content

FeDevv/PassVault

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

17 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ“ PassVault - Java Password Manager

PassVault is a simple password manager written in Java, designed to securely store user account credentials using AES-128 encryption and a master password required once per session.


✨ Features

  • βœ… Store accounts with platform, username, email, and password
  • πŸ”’ AES encryption for passwords (with random IV and salt per encryption)
  • 🧠 Master password required only once per session
  • πŸ” Secure credential verification
  • ✏️ Update existing accounts
  • ❌ Securely delete accounts
  • πŸ“‚ Persistent local file-based storage
  • Command-line interface

πŸ› οΈ Technologies Used

  • Java 17+
  • IntelliJ IDEA
  • AES with PBKDF2 (HmacSHA256) for key derivation
  • Local file system for persistence

πŸ—ƒοΈ Project Structure

  • Main.java – Entry point and text-based user interface
  • Account.java – Represents a user account
  • AccountDAO.java – Interface for CRUD operations
  • AccountFileDAO.java – DAO implementation using file storage
  • CryptoUtils.java – AES encryption/decryption logic
  • SessionManager.java – Handles the master password for the session
  • accounts.txt – Stores account data (with encrypted passwords)

πŸ” Security Design

  • Passwords are never stored in plain text.
  • Every encryption generates a unique IV and salt.
  • The master password is never saved; it is used only to derive the encryption key at runtime.
  • All error messages are intentionally generic to avoid leaking sensitive information (e.g., "account not found" instead of "wrong password").

⚠️ File Format Limitation

The application uses a semicolon (;) as a delimiter to separate account fields (platform, username, email, encrypted password) when saving data to the file.

Important:
Do not use semicolons (;) in any of the following fields:

  • Platform
  • Username
  • Email
  • Password

Using ; will break file parsing and may cause data corruption or application errors.


πŸ‘€ Author

Created with β˜• by Federico Bonucci
GitHub: FeDevv
Email: ricobon03@gmail.com


πŸ“„ License

This project is licensed under the MIT License.


MIT License

Copyright (c) 2025 Federico Bonucci

Permission is hereby granted, free of charge, to any person obtaining a copy  
of this software and associated documentation files (the "Software"), to deal  
in the Software without restriction, including without limitation the rights  
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell  
copies of the Software, and to permit persons to whom the Software is  
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all  
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR  
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,  
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE  
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER  
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,  
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE  
SOFTWARE.

About

Password management Software - do not use if not for research/study purposes -

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published