Skip to content
Snippets Groups Projects
Jiří Rája's avatar
Jiří Rája authored
Refined the release candidate

See merge request cryton/cryton-worker!45
014cc1ed

Coverage

Cryton Worker

Cryton Worker is used for executing attack modules remotely. It utilizes RabbitMQ as its asynchronous remote procedures call protocol. It connects to the Rabbit MQ server and consumes messages from the Core component or any other app that implements its RabbitMQ API.

Cryton toolset is tested and targeted primarily on Debian and Kali Linux. Please keep in mind that only the latest version is supported and issues regarding different OS or distributions may not be resolved.

For more information see the documentation.

Quick-start

To be able to execute attack scenarios, you also need to install Cryton Core.
Modules provided by Cryton can be found here. Their installation will be covered in this section.

Make sure Git, Docker, and Docker Compose plugin are installed:

Optionally, check out these Docker post-installation steps.

The following script clones the necessary repositories (Worker and modules), updates Worker's settings, and runs the Docker Compose configuration which starts the Worker, and its prerequisites (Metasploit and Empire framework).

git clone https://gitlab.ics.muni.cz/cryton/cryton-modules.git
cd cryton-modules
git checkout $(git tag --list "2023.1.*" | tail -n 1)
cd ..
export CRYTON_MODULES_PATH=$(pwd)/cryton-modules/modules
git clone https://gitlab.ics.muni.cz/cryton/cryton-worker.git
cd cryton-worker
git checkout $(git tag --list "2023.1.*" | tail -n 1)
sed -i "s|CRYTON_WORKER_MODULES_DIR=CHANGE_ME|CRYTON_WORKER_MODULES_DIR=$CRYTON_MODULES_PATH|" .env
sed -i "s|CRYTON_WORKER_EMPIRE_HOST=127.0.0.1|CRYTON_WORKER_EMPIRE_HOST=cryton-empire|" .env
docker compose up -d

For more information see the documentation.

Contributing

Contributions are welcome. Please contribute to the project mirror on gitlab.com. For more information see the contribution page.