https://github.com/sp8cky/password-manager
Python implementation of a password manager.
https://github.com/sp8cky/password-manager
cyber-security cybersecurity password password-manager passwordmanager
Last synced: 10 months ago
JSON representation
Python implementation of a password manager.
- Host: GitHub
- URL: https://github.com/sp8cky/password-manager
- Owner: sp8cky
- License: mit
- Created: 2024-09-27T13:43:05.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-10-20T19:24:19.000Z (about 1 year ago)
- Last Synced: 2025-01-21T23:17:42.266Z (12 months ago)
- Topics: cyber-security, cybersecurity, password, password-manager, passwordmanager
- Language: Python
- Homepage:
- Size: 69.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Password-Manager
This is one of my first projects in cybersecurity that I developed to deepen my knowledge and gain practical experience.
This is a console-based password manager developed in Python that leverages SQLite for secure storage. Utilizes Fernet for encrypting passwords and bcrypt for hashing the master password, ensuring robust protection for your sensitive data
I welcome your feedback and comments for improvement as well as tips to help me develop the project further.
## Table of Contents
1. [Implemented Features](#Implemented-Features)
2. [Installation and usage](#installation-and-usage)
3. [Contributing](#contributing)
4. [License](#license)
5. [Credits](#credits)
6. [Disclaimer](#disclaimer)
## Implemented Features
- Database options: Create/open/delete a .key-database
- Entry options: Add/delete one/delete all/view entries (website, username, password)
- Generate a pseudogenerated password
- En- and decryption of all passwords with fernet
- En- and decryption your files with master password
- Hashing and salting with bcrypt
### Security Libraries
- **Cryptography** with **Fernet**: Used for symmetric encryption of passwords.
- **bcrypt**: Used for salting to protect against rainbow table attacks, securely hashing the master password for enhanced security.
### Project status
- Still in progress
### Future implementations
- Additional features and improvements will be added as the project progresses.
## Installation and usage
### Installation Steps
Clone the repository and navigate into the directory
```bash
git clone https://github.com/sp8cky/Password-Manager && cd Password-Manager
```
Install dependencies
```bash
pip install -r requirements.txt
```
### Start
Start the main script from root directory:
```bash
python src/password_manager.py
```
### Usage
1. **Create a new database:** At startup, you can create a new password database and set a master password.
2. **Set a master password:** Once the database is created, you will be prompted to set a master password. This protects access to the database.
3. **Manage entries:**
- After verifying the master password, you can add, view or delete entries.
- **Adding a new entry:** You can save website names, usernames and passwords.
- **View entries:** All saved passwords can be listed.
- **Password Generator:** PWM offers an option to create randomly generated passwords.
### Database management
PWM stores your passwords in an SQLite database, which is encrypted with a `.key` file. Each database is protected with an individual key. The key is generated automatically when you create a new database.
- **Delete database:** You can securely delete a database by selecting the "Delete Database" option in the main menu.
- **Key files:** Make sure that the `.key` file is stored securely. Without this file you will not be able to access your database.
### Project structure
- `password_manager_class.py`: Contains the PasswordManager class that encapsulates important variables and methods for database operations.
- `password_manager.py`: Main script that executes the password manager.
- `encryption_handler.py`: Encryption logic (encryption/decryption of passwords and master password management).
- `input_handler.py`: Contains functions for user input and menu control.
- `db_handler.py`: Manages database operations (creating, opening, deleting entries).
## Contributing
Feedback and Contributions: It's my first cybersecurity project, Feedback and contributions are welcome! If you encounter any issues or have suggestions for improvements, feel free to open an issue or submit a pull request on GitHub.
### How to Contribute
1. Fork the repository
2. Create a feature branch: `git checkout -b feature/your-feature`
3. Commit your changes: `git commit -m 'Add some feature'`
4. Push to the branch: `git push origin feature/your-feature`
5. Open a pull request
## Credits:
This project was created by sp8cky.
## License:
This project is licensed under the MIT-License. See the LICENSE file for details.
## Disclaimer
This project is for educational purposes only and is provided as is. Use it at your own risk. I take no responsibility for any damages or problems that may arise from the use of the password manager.