susdb

SusDB is a secure user string database system designed to manage and protect sensitive user data. This wiki serves as a guide to understanding SusDB's architecture, features, data security, and the post office metaphor that helps illustrate its functions.

Table of Contents

• Introduction
• Features
• Architecture
• Data Security
• Account Recovery
• The Classical Post Office Story
• Testing SusDB locally using Docker

Introduction

SusDB is a secure and efficient database system built to manage sensitive user data. It focuses on securing user strings and enables data recovery when needed. It operates using a post office metaphor, where each user has a secured "box" to store their sensitive data.

For a detailed overview of SusDB, visit the Introduction page.

Features

SusDB boasts a set of essential features that ensure data privacy and security. These features include hashing user strings, integrity checks, data serialization, and account recovery management. Understanding these features is crucial for utilizing SusDB effectively.

Explore the full list of features on the Features page.

Architecture

The architecture of SusDB revolves around securely storing user data and ensuring its integrity. The system uses a unique file-based approach for database management and a central repository (Redis) for critical resources. Learn how SusDB operates to protect user data.

Check out the Architecture page for a comprehensive understanding.

Data Security

Data security is a top priority for SusDB. It relies on the Argon2 hashing algorithm to safeguard user strings, ensuring that sensitive information remains confidential. Frequent maintenance and backup procedures are in place to protect against data loss and corruption.

Visit the Data Security page for a deep dive into how SusDB prioritizes your data's safety.

Account Recovery

SusDB includes an account recovery system to assist users in regaining access to their data if they forget their user strings. This process involves verifying user identity and integrity checks to protect sensitive information.

Learn more about the account recovery process in the Account Recovery section.

The Classical Post Office Story

To help understand SusDB's operations, we've drawn a metaphor with a classical post office. Just like a post office assigns secure boxes and manages keys, SusDB uses file IDs to protect user data. Redis serves as a central repository, but it doesn't store data directly. This metaphor highlights SusDB's unique approach to data management.

Read the Classical Post Office Story for a creative perspective on SusDB's functions.

Running Locally

Pull the susdb Container Image

To get the latest susdb container image from Docker Hub, run:

sudo docker pull terre8055/susdb:0.0.1

Run the susdb Container

To run the susdb container and mount a volume for local access to log files and dbm, use the following command:

First, make sure this directory and file exists on your local machine

mkdir -p $HOME/sus-db/ && touch $HOME/sus-db/susdb.log

if you are running docker as rootless;

docker run --name <any-name> -v /path/to/home/sus-db/:/path/to/home/sus-db/ -it terre8055/susdb:0.0.1 

else; add the sudo

This command mounts your local $HOME/sus-db directory to the container's $HOME/sus-db directory, enabling access to log files and dbm.

Store User Data

To store user data using susdb, run the following command:

docker run --name tiger-woodye -v /path/to/home/sus-db/:/path/to/home/sus-db/ -it terre8055/susdb:0.0.1  python /app/src/susdb_cli.py store --string='Mike'

A unique id will be generated used to access for local dbs Replace <user_string: str> with the actual user string you want to store.

Deserialize and Retrieve User Data

To retrieve user data using susdb, run the following command:

docker run --name tiger-woodye -v /path/to/home/sus-db/:/path/to/home/sus-db/ -it terre8055/susdb:0.0.1  python /app/src/susdb_cli.py retrieve --key=<data_to_retrieve: str> --uid=<uid: str>

Replace <uid: str> with the generated unique id after storing your string. Replace <key: str> with the actual user data you want to retrieve.

Display contents of user db

To display user db using susdb, run the following command:

docker run --name tiger-woodye -v /path/to/home/sus-db/:/path/to/home/sus-db/ -it terre8055/susdb:0.0.1  python /app/src/susdb_cli.py python /app/src/susdb_cli.py view --uid=<uid: str>

Replace <uid: str> with the generated unique id after storing your string.

Verify Crentials

To verify user cred using susdb, run the following command:

docker run --name tiger-woodye -v /path/to/home/sus-db/:/path/to/home/sus-db/ -it terre8055/susdb:0.0.1  python /app/src/susdb_cli.py python /app/src/susdb_cli.py verify --string=<user_string: str> --uid=<uid: str>

Replace <uid: str> with the generated unique id after storing your string. Replace <user_string: str> with the actual user string.

Conclusion

SusDB is designed to secure and manage sensitive user data efficiently. Its unique architecture and security features make it an ideal choice for applications that require privacy and data protection. Explore the wiki to learn how to utilize SusDB effectively and ensure the security of your user data.

Find docs here SUS-DB Documentation

Issues are welcome and will be resolved as early as possible