Try it in a lab¶
You can try ReD-Pot on one Linux machine with Docker: a lab VM, not a production server. The lab runs the manager and
3 decoys (file server FS01, domain controller DC01, web server WEB01) on an isolated Docker bridge network, and
simulated workstations attack them as containers. The script tests/lab_scenarios.sh in the repository does all of it.
Lab only
The lab bridge mode is for evaluation. In this mode decoys can reach the Docker host's bridge IP. Do not use it to protect a real network.
git clone https://github.com/RedSideSecurity/ReD-Pot.git
cd ReD-Pot
sudo docker build -t rpot:1.0.1 .
python3 -m venv .venv && .venv/bin/pip install -r requirements.txt # rpotctl needs the Python packages
sudo env PATH="$PWD/.venv/bin:$PATH" IMG=rpot:1.0.1 tests/lab_scenarios.sh all # setup + attack; run as root
# Console: https://127.0.0.1:8740 (admin token: console.admin_token in ./lab/rpot.json)
| Command | What it does |
|---|---|
tests/lab_scenarios.sh setup |
builds the lab only (rpotctl init --net-mode bridge with 3 decoys, rpotctl compose, docker compose up) |
tests/lab_scenarios.sh attack |
runs the simulated workstations against a running lab |
tests/lab_scenarios.sh all |
both |
tests/lab_scenarios.sh down |
stops the lab (./lab is kept) |
DRY_RUN=1 tests/lab_scenarios.sh all |
prints every command instead of running it |
Settings come from the environment: P (project name, default rpotlab), IMG, DIR (default ./lab), PRE
(lab subnet prefix, default 172.30.50), DOMAIN, PROFILE and the decoy names FS_NAME, DC_NAME, WEB_NAME.
Note
Set IMG to the tag you built (IMG=rpot:1.0.1 above). The script's built-in default image tag is rpot:1.0.0.
What the simulated workstations do¶
| Scenario | Expected result |
|---|---|
| an allow-listed scanner | recorded, no incident |
| a stray touch | L1 |
| an HR user opening a share by mistake | L3 |
| SSH password spraying | L3 |
| the full breadcrumb chain FS01 → WEB01 → DC01 with a bait document | L5 |
| Active Directory recon with a GPP password, LDAP spraying and Kerberoasting | L4 / L5 |
Internet attackers with real public source IPs from 12 countries, for the world map:
Without Python packages on the host, run the CLI from the image instead, for example
docker run --rm --user 0 -v $PWD/lab:/d rpot:1.0.1 ctl init -d /d --net-mode bridge ...
(the same for ctl compose and ctl geoip). A lab is limited to 3 decoys like any other install.