OT Pentest Framework

Tools & lab files

Tools for your OT security lab

These are the tools and simulators that go with the book and the framework. Build a safe lab, point them at simulated equipment, and learn how attacks really work before you need to defend against one.

Downloads are on the way

Download links will be added here as each tool is released alongside the book. Follow github.com/utilsec and subscribe to Guarding Gears to hear when they go live.

Recon

smappy

A passive, Shodan-powered scanner in Python, based on Smap by Somdev Sangwan. It looks up what Shodan already knows about an IP address instead of touching the target. Works with the free InternetDB or a paid Shodan API key, and it knows the common OT/ICS ports.

Framework phase: Reconnaissance

Recon

GLEAN, RAKE & OTED

A toolkit for finding exposed OT assets from public sources. GLEAN is a deterministic collector, RAKE is an AI agent harness, and OTED is a library of OT exposure objectives. It is passive only and refuses to touch industrial ports.

Framework phase: Reconnaissance

Recon target

Cold Start Beverage Co.

A fictional beverage manufacturer used as a safe, legal OSINT practice target for the book's reconnaissance exercises. The website is live at chugcoldstart.com.

Framework phase: Reconnaissance

Discovery

OT RUNG

Recon Utility for Networked Gear. A menu-driven multi-protocol tool for network discovery and read-only interrogation of Modbus, S7, EtherNet/IP, DNP3, BACnet and SNMP devices, with an asset register. It starts in safe mode, and write operations must be unlocked on purpose. Also comes in a no-install PowerShell edition, SPRUNG.

Framework phase: Discovery & Collection

Discovery

TAPROOT

TAP Record Offline Observation Tool. Reads a PCAP or PCAPNG file and lists every IP address, MAC address and communicating port, with evidence tiers so the results hold up in an assessment. Includes a browser edition with a network map.

Framework phase: Discovery & Collection

Simulator

Conveyor line PLC (plc_sim.py)

A simulated manufacturing conveyor PLC with Modbus/TCP and a web HMI. It includes a VFD, photo-eyes, interlocks and a motor thermal model, so you can practice in the lab before going near real equipment.

Framework phase: Execution & Impact

Simulator

Water treatment PLC (WTP-PLC-01)

A simulated drinking-water treatment plant PLC with chemical dosing, filtration and level control. You can practice analyzer spoofing and unauthorized Modbus writes, and see how they affect the process.

Framework phase: Impair Process Control

Simulator

Songbird steering gear PLC (SG-PLC-01)

A simulated cruise-ship steering gear PLC with a marine bridge HMI, autopilot and local control takeover. Unauthorized Modbus writes visibly move the rudder.

Framework phase: Impair Process Control

Simulator

ENCO-SIM

A simulated building hydronic heating controller with a vendor-style telnet CLI, Modbus/TCP and a web HMI. It's built to demo sensor-injection and coil-write attacks.

Framework phase: Execution

Defense

MOTH

Modbus Observation & Threat Honeypot. A realistic wastewater lift station behind a Modbus/TCP server that logs pings, port scans and every Modbus command it receives.

Framework phase: Detection

Use responsibly

These tools are for training and authorized use only. Run them in your own lab against your own simulated or test equipment. Never run them against production OT/ICS systems or systems you don't have written permission to test.