Updat README.md
This commit is contained in:
parent
6239a38ff7
commit
25c1a73901
114
README.md
114
README.md
@ -1,2 +1,114 @@
|
|||||||
# Unnamed Password Manager
|
# Unnamed Password Manager
|
||||||
Hi
|
### Introduction
|
||||||
|
This is a password manager. Keep your passwords safe. :><br>
|
||||||
|
|
||||||
|
### Features:
|
||||||
|
- Fully local storage
|
||||||
|
- Symmetric AES encryption
|
||||||
|
- Multiple users
|
||||||
|
- Cross platform
|
||||||
|
- Web ui
|
||||||
|
|
||||||
|
## Working
|
||||||
|
Why use Unnamed Password Manager (UNPM)
|
||||||
|
### Before UNPM
|
||||||
|
"Never use common password"
|
||||||
|
- A wise person
|
||||||
|
```mermaid
|
||||||
|
flowchart LR
|
||||||
|
vw[Visit Website]
|
||||||
|
--> s[Sign up using unique password]
|
||||||
|
--> fp["Forgot Password 😭"]
|
||||||
|
vw[Visit Website]
|
||||||
|
--> sa[Sign up with common password]
|
||||||
|
--> gh[Get all your accounts hacked]
|
||||||
|
```
|
||||||
|
### After UNPM
|
||||||
|
```mermaid
|
||||||
|
flowchart LR
|
||||||
|
vw[Visit Website]
|
||||||
|
--> s[Sign up using unique password]
|
||||||
|
--> sp[Save password safely in UNPM]
|
||||||
|
vwa[Visit Website again]
|
||||||
|
--> gp[Get password using our web-app]
|
||||||
|
--> l[Login]
|
||||||
|
```
|
||||||
|
|
||||||
|
## FAQ
|
||||||
|
#### How to Backup?
|
||||||
|
- Check where AppData is standard stored if your OS is not mentioned here.
|
||||||
|
- Linux:
|
||||||
|
- - Backup the file at the location "~/.local/share/Unnamed_Password_Manager/\<USERNAME\>"
|
||||||
|
- - Paste it in the same location or follow the directions for the OS.
|
||||||
|
|
||||||
|
|
||||||
|
# Dev docs
|
||||||
|
## Rest API
|
||||||
|
##### WARNING:
|
||||||
|
Do NOT use this api for ANY reason EXCEPT if usage is ONLY local, i.e.,
|
||||||
|
this api is NOT built for usage over an external network and doing so
|
||||||
|
WILL NOT BE SECURE
|
||||||
|
###### Note:
|
||||||
|
Server throws 405 METHOD NOT ALLOWED if the url is mistyped
|
||||||
|
|
||||||
|
```mermaid
|
||||||
|
sequenceDiagram
|
||||||
|
autonumber
|
||||||
|
actor User
|
||||||
|
box App
|
||||||
|
participant Frontend
|
||||||
|
participant Backend
|
||||||
|
end
|
||||||
|
|
||||||
|
Note over User, Backend : LOGIN
|
||||||
|
User -->> Frontend : Wants to login
|
||||||
|
Frontend -->> Backend : { user_name : "...", password : "..." } to /login
|
||||||
|
Backend -->> Frontend : Success : http 200
|
||||||
|
Backend -->> Frontend : user_name / password not given : http 400
|
||||||
|
Backend -->> User : user_name / password is wrong : http 403
|
||||||
|
|
||||||
|
Note over User, Backend : LOGOUT
|
||||||
|
User -->> Frontend : Wants to logout
|
||||||
|
Frontend -->> Backend : /logout
|
||||||
|
Backend -->> Frontend : Success : http 200
|
||||||
|
Backend -->> User : Not logged in : http 403
|
||||||
|
|
||||||
|
Note over User, Backend : ADD USER
|
||||||
|
User -->> Frontend : Wants to add user
|
||||||
|
Frontend -->> Backend : { user_name : "...", password : "..." } to /add_user
|
||||||
|
Backend -->> Frontend : Success : http 200
|
||||||
|
Backend -->> Frontend : user_name / password not given : http 400
|
||||||
|
Backend -->> User : user_name is taken : http 403
|
||||||
|
|
||||||
|
Note over User, Backend : GET DATA
|
||||||
|
User -->> Frontend : field/ entry, etc.
|
||||||
|
Frontend -->> Backend : /get_data
|
||||||
|
Backend -->> User : Not logged in : http 403
|
||||||
|
|
||||||
|
Note over User, Backend : CHANGE PASSWORD
|
||||||
|
User -->> Frontend : Wants to change password
|
||||||
|
Frontend -->> Backend : { password : "..." } to /change_password
|
||||||
|
Backend -->> Frontend : password not given : http 400
|
||||||
|
Backend -->> User : Not logged in : http 403
|
||||||
|
|
||||||
|
Note over User, Backend : ADD ENTRY
|
||||||
|
User -->> Frontend : Wants to add entry
|
||||||
|
Frontend -->> Backend : entry data to /add_entry
|
||||||
|
Note over Frontend, Backend : entry data is { entry_name : "...", fields : "..." }
|
||||||
|
Note over Frontend, Backend : fields should be string({ field1 : "...", field2 : "...", ... })
|
||||||
|
Backend -->> Frontend : Entry data is not correct : http 400
|
||||||
|
Backend -->> User : Not logged in : http 403
|
||||||
|
|
||||||
|
Note over User, Backend : DELETE ENTRY
|
||||||
|
User -->> Frontend : Wants to delete entry
|
||||||
|
Frontend -->> Backend : { entry_name : "..." } to /delete_entry
|
||||||
|
Backend -->> Frontend : entry_name not given : http 400
|
||||||
|
Backend -->> User : Not logged in or entry_name does not exist : http 403
|
||||||
|
|
||||||
|
Note over User, Backend : EDIT ENTRY NAME
|
||||||
|
User -->> Frontend : Wants to change entry name
|
||||||
|
Frontend -->> Backend : { old_entry_name : "...", new_entry_name : "..." }
|
||||||
|
Backend -->> Frontend : Success : http 200
|
||||||
|
Backend -->> Frontend : old or new entry names not given : http 400
|
||||||
|
Backend -->> User : Old user name doesn't exist or the new one already exists
|
||||||
|
```
|
||||||
|
Loading…
x
Reference in New Issue
Block a user