Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kafetzisthomas/passmanagerweb
Securely manage your passwords of your online accounts.
https://github.com/kafetzisthomas/passmanagerweb
cloud django django-project encryption open-source password-generator password-manager python
Last synced: 5 days ago
JSON representation
Securely manage your passwords of your online accounts.
- Host: GitHub
- URL: https://github.com/kafetzisthomas/passmanagerweb
- Owner: KafetzisThomas
- License: gpl-3.0
- Created: 2024-06-18T08:29:02.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2024-12-21T14:24:28.000Z (15 days ago)
- Last Synced: 2024-12-21T14:30:53.663Z (15 days ago)
- Topics: cloud, django, django-project, encryption, open-source, password-generator, password-manager, python
- Language: Python
- Homepage: https://passmanagerweb.onrender.com/
- Size: 2.64 MB
- Stars: 12
- Watchers: 4
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
Securely manage your passwords of your online accounts.
https://passmanagerweb.onrender.com/
Written in Python/Django
Homepage |
FAQ |
Contributors
---
## Features
- [X] **AES 256 Encryption**: Securely store and manage passwords with AES 256-bit encryption, ensuring top-tier security for **sensitive information**.
- [X] **Multi-Factor Authentication**: Protect your account with your favorite authenticator app.
- [X] **Password Generator Tool**: Built-in tool to generate `strong`, `random` passwords, with `customizable` options (length, character types).
- [X] **Password Health Monitoring**: Built-in tool to check the strength and health of stored passwords, identifying `weak`, `reused`, or `compromised` passwords.
- [X] **Import/Export Passwords**: `Upload` passwords from a CSV file or `download` your stored passwords in `CSV` format for easy backup or migration.
- [X] **Automatic Logout**: Automatically logs you out after a **customizable** period of inactivity. Choose the **timeout** duration that best suits your needs.
- [X] **Cloudflare CAPTCHA Verification**: Protects against automated attacks by using CAPTCHA to verify human users.
## Purpose
The primary goal of this project is to **provide an open-source application that anyone can use and learn from**. While the deployed app is available for use, my main intention is not to attract active users or compete with major applications like [Bitwarden](https://bitwarden.com/). Instead, I aim to share the code, primarily written in Django, with those who might find it useful for similar projects or personal use.
If you find this project interesting, helpful, or inspiring, please consider giving a `star`, `following`, or even `donating` to support further development.
## Setup for Local Development
### Set up Virtual Environment
```bash
➜ cd path/to/root/directory
$ python3 -m venv env/
$ source env/bin/activate
```
### Install Dependencies
```bash
$ pip3 install -r requirements.txt
```
### Create Enviroment Variable file
```bash
$ touch main/.env
$ nano main/.env
```
Add the following environment variables (modify as needed):
```bash
➜ SECRET_KEY="example_secret_key" # https://stackoverflow.com/a/57678930
➜ ENCRYPTION_KEY="example_encryption_key" # https://cryptography.io/en/latest/fernet/#cryptography.fernet.Fernet
➜ DEBUG=True # For development
➜ EMAIL_HOST_USER="example_email_host"
➜ EMAIL_HOST_PASSWORD="example_email_password"
```
Save changes and close the file.
### Migrate Database
```bash
$ python3 manage.py migrate
```
### Run Django Server
```bash
$ python3 manage.py runserver
```
Now you can access the website at `http://127.0.0.1:8000/` or `http://localhost:8000/`.
## Run Tests
```bash
➜ cd path/to/root/directory
$ python3 manage.py test users.tests passmanager.tests
```
## Screenshots
Vault
Password Generator
New Item
Edit Item
## Contributing Guidelines for PassManager
### Pull Requests
When submitting a pull request, please keep these points in mind:
* **Simplicity**: Keep your changes straightforward and focused. Complex changes are harder to review and integrate.
* **Avoid Non-Standard Libraries**: Whenever possible, refrain from adding new non-standard libraries. If your idea necessitates one, kindly discuss it first by opening an issue. This helps in evaluating the necessity and compatibility of the library.
* **Ensure It Runs**: Before submitting a pull request, ensure that your code runs without errors and adheres to the project's coding standards.
* **Pass All Tests**: Make sure all existing [tests](#run-tests) pass and add new tests as necessary. Pull requests will not be merged unless all tests pass successfully.
### Filing Bug Reports and Submitting Pull Requests
If you encounter a bug, please follow these steps to report it:
* **Bug Reports**: File bug reports on the [GitHub Issues](https://github.com/KafetzisThomas/PassManagerWeb/issues) page.
* **Pull Requests**: Open pull requests on the [GitHub Pull Requests](https://github.com/KafetzisThomas/PassManagerWeb/pulls) page.
Before contributing, please review the [License](https://github.com/KafetzisThomas/PassManagerWeb/blob/main/LICENSE) to understand the terms and conditions governing the use and distribution of PassManager.
Thank you for your interest in improving PassManager!