mirror of
https://github.com/kevinveenbirkenbach/splitted-secret.git
synced 2024-11-22 10:11: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__
|
__pycache__
|
||||||
|
testcases.txt
|
116
Readme.md
116
Readme.md
@ -1,66 +1,72 @@
|
|||||||
# Splitted Secret
|
# 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.
|
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
|
## requirements
|
||||||
```bash
|
|
||||||
python scripts/main.py --mode cleanup &&
|
### system
|
||||||
echo "werewrw" > data/decrypted/main_data/test123.txt
|
This software is developed for and on a [Arch Linux](https://archlinux.org/) system.
|
||||||
echo "werewrw" > data/decrypted/main_data/test124.txt
|
|
||||||
mkdir data/decrypted/main_data/folder
|
### setup
|
||||||
echo "werewrw" > data/decrypted/main_data/folder/test124.txt
|
|
||||||
|
Before executing the script it may be necessary to install the following software packages:
|
||||||
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
|
|
||||||
```bash
|
```bash
|
||||||
|
pacman -S gpg tar python pip python-pip
|
||||||
pip install numpy
|
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
|
## todo
|
||||||
- implement tails setup script
|
|
||||||
- add data-input attribut
|
- add data-input attribut
|
||||||
- add data-output attribut
|
- add data-output attribut
|
||||||
- write scenario test
|
- 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