mirror of
https://github.com/kevinveenbirkenbach/splitted-secret.git
synced 2024-11-22 02:01:05 +01:00
Updated Readme file
This commit is contained in:
parent
4caec4e1dc
commit
260d7dfbb7
1
.gitignore
vendored
1
.gitignore
vendored
@ -1 +1,2 @@
|
||||
__pycache__
|
||||
testcases.txt
|
116
Readme.md
116
Readme.md
@ -1,66 +1,72 @@
|
||||
# Splitted Secret
|
||||
The purpose of this software is to splitt a secret over multiple people. Just if a defined amount of this people meet together they can encrypt the secret and have access to it.
|
||||
|
||||
# testing
|
||||
```bash
|
||||
python scripts/main.py --mode cleanup &&
|
||||
echo "werewrw" > data/decrypted/main_data/test123.txt
|
||||
echo "werewrw" > data/decrypted/main_data/test124.txt
|
||||
mkdir data/decrypted/main_data/folder
|
||||
echo "werewrw" > data/decrypted/main_data/folder/test124.txt
|
||||
|
||||
python scripts/main.py --amount 3 --quota 50 --mode encrypt --add-user-information --master-password "ewrwerwerew" << END_OF_INPUTS
|
||||
alpha bravo
|
||||
123123812908
|
||||
asfdasd@asdskjd.de
|
||||
street in straat
|
||||
charlie delta
|
||||
1888888
|
||||
sadasfdasd@asdskjd.de
|
||||
street in strutt
|
||||
echo2 foxtrott
|
||||
99999999
|
||||
asfdasd@sdskjd.de
|
||||
street in strasdlasöd
|
||||
END_OF_INPUTS
|
||||
python scripts/main.py --mode decrypt --master-password "ewrwerwerew"
|
||||
|
||||
|
||||
python scripts/main.py --mode cleanup --file-types decrypted &&
|
||||
python scripts/main.py --mode decrypt --user "1" --user-password "Y4GYTEW80SCQQDTIKOJ6YNCIP6MBBEM68SCKBAA1VWAQFRSPNGHEBKHSFZQENDRB" << END_OF_INPUTS
|
||||
2
|
||||
VGCQPW2LIKJ7SDFFLUZXBXGFPZ6L8RGPTS7TLCNN9GLR82RPHRSN34YZUXF0L27V
|
||||
END_OF_INPUTS
|
||||
```
|
||||
# Requirements to know
|
||||
- Amount of People
|
||||
- How much people need to reunite for decrypting
|
||||
|
||||
# Requirements to implement
|
||||
- Plattform independend
|
||||
- easy to use
|
||||
|
||||
# required software
|
||||
## requirements
|
||||
|
||||
### system
|
||||
This software is developed for and on a [Arch Linux](https://archlinux.org/) system.
|
||||
|
||||
### setup
|
||||
|
||||
Before executing the script it may be necessary to install the following software packages:
|
||||
|
||||
```bash
|
||||
pacman -S gpg tar python pip python-pip
|
||||
pip install numpy
|
||||
gpg
|
||||
ecryptfs-utils
|
||||
ecryptfs-simple
|
||||
python
|
||||
pip
|
||||
```
|
||||
## commands
|
||||
|
||||
## cleanup data
|
||||
|
||||
### delete all data
|
||||
|
||||
To delete all data execute:
|
||||
|
||||
```bash
|
||||
python scripts/main.py --mode cleanup
|
||||
```
|
||||
|
||||
### delete decrypted data
|
||||
To delete all encrypted data execute:
|
||||
|
||||
```bash
|
||||
python scripts/main.py --mode cleanup --file-types decrypted
|
||||
```
|
||||
|
||||
### delete all encrypted data
|
||||
To delete all encrypted data execute:
|
||||
|
||||
```bash
|
||||
python scripts/main.py --mode cleanup --file-types encrypted
|
||||
```
|
||||
|
||||
## decrypt
|
||||
|
||||
### decrypt automatic (todo)
|
||||
To decrypt the data for a defined user type in:
|
||||
|
||||
```bash
|
||||
python scripts/main.py --mode decrypt
|
||||
```
|
||||
|
||||
### decrypt defined user
|
||||
To decrypt the data for a defined user type in:
|
||||
|
||||
```bash
|
||||
python scripts/main.py --mode decrypt --user "<<user_id>>"
|
||||
```
|
||||
|
||||
## encrypt
|
||||
|
||||
### encrypt all data
|
||||
|
||||
```bash
|
||||
python scripts/main.py --amount 3 --quota 50 --mode encrypt --add-user-information --master-password "{{master_password}}"
|
||||
```
|
||||
|
||||
### encrypt master-password fuile
|
||||
|
||||
## todo
|
||||
- implement tails setup script
|
||||
- add data-input attribut
|
||||
- add data-output attribut
|
||||
- write scenario test
|
||||
|
||||
## Further Information
|
||||
- https://www.tutorialspoint.com/python/python_command_line_arguments.htm
|
||||
- https://docs.python.org/3/library/argparse.html#module-argparse
|
||||
- https://wiki.ubuntuusers.de/GoCryptFS/
|
||||
- https://pynative.com/python-generate-random-string/
|
||||
- https://www.studimup.de/abitur/stochastik/anzahl-der-m%C3%B6glichketen-berechnen-kombinatorik/
|
||||
- https://numpy.org/doc/stable/reference/generated/numpy.base_repr.html?highlight=base_repr#numpy.base_repr
|
||||
- https://linuxconfig.org/how-to-create-compressed-encrypted-archives-with-tar-and-gpg
|
Loading…
Reference in New Issue
Block a user