theTHE : The Threat Hunting Environment

You are a Threat Hunter. While investigating, did you find yourself with more than 20 tabs opened in your browser, scattered .txt files with data and some terminals showing up in the background? theTHE centralizes all the information on an investigation in a single project and shares its results with your team (and with nobody else).

theTHE caches your API responses, so you don’t need to repeat the requests. Don’t share your keys, let the users make calls to the services.

theTHE also contains some command-line tools integrated so you don’t have to open a terminal and pipe the results in a .txt file.

Installation

First, clone this repository with:

git clone https://github.com/ElevenPaths/thethe.git

Last, build the images and run the containers

docker-compose up -d

You should see thethe in http://localhost

Also Read – Nginx Log Check : Nginx Log Security Analysis Script

Default User

  • By default, there is only one user admin with password admin
  • Change the admin password as soon as you login into thethe the very first time.

API Keys

  • There are not API keys stored by default in the system.
  • To add an API key, there is an option in the user menu (right upper corner).
  • All API keys (a new API management system is in development) must be written as CSV values:

service_name_1,api_value_1
service_name_2,api_value_2



service_name_n,api_value_n

What if a service must have more than one API key, secret, etc…

secret,api_value



cookie,cookie_value

and so on…

Database Backups & Restoration

MongoDB has a bind volume to ease external storage and backups in a folder mongodb_data

In any case, we have provided you a couple of scripts to backup (a compressed file) and restore data from your mongo container.

Inside utils folder:

Make a backup

backup_thethe_db.sh <mongodb_container_name>

Restore from a backup

restore_thethe_db.sh <mongodb_container_name>

Updating

Make a database backup! (look section “Database backups and restoration”)

git pull

If the source code has been changed all the mounted volumes should reflect the changes, but in certain cases (third party libraries, etc) the images must be rebuilt.

Stop the containers:

docker-compose stop

Rebuild images:

docker-compose build

Restart the system

docker-compose up -d

Development Environment

If you want to collaborate with the project a development version is provided:

Get The Repository

git clone https://github.com/ElevenPaths/thethe.git

Docker

docker-compose -f docker-compose_dev.yml up -d

Run the frontend

cd frontend
npm install
npm run serve

R K

Recent Posts

Understanding the Model Context Protocol (MCP) and How It Works

Introduction to the Model Context Protocol (MCP) The Model Context Protocol (MCP) is an open…

5 days ago

The file Command – Quickly Identify File Contents in Linux

While file extensions in Linux are optional and often misleading, the file command helps decode what a…

5 days ago

How to Use the touch Command in Linux

The touch command is one of the quickest ways to create new empty files or update timestamps…

5 days ago

How to Search Files and Folders in Linux Using the find Command

Handling large numbers of files is routine for Linux users, and that’s where the find command shines.…

5 days ago

How to Move and Rename Files in Linux with the mv Command

Managing files and directories is foundational for Linux workflows, and the mv (“move”) command makes it easy…

5 days ago

How to Create Directories in Linux with the mkdir Command

Creating directories is one of the earliest skills you'll use on a Linux system. The mkdir (make…

5 days ago