Skip to content

Blue-infosec/echothreat

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Echo<Threat

Echo<Threat is a modular synthetic log generation tool designed for detection engineering and simulation-based verification workflows.

It enables teams to generate authentic ECS-aligned logs using YAML configs and Jinja2 templates, perfect for tuning, backtesting, or verifying detection logic at scale.

Why Echo<Threat?

Detection rules often stall in the verification phase, not for lack of ideas, but for lack of authentic data to test against.

Echo<Threat solves this by letting you:

  • Simulate realistic logs across multiple Windows event sources (Security, Sysmon)
  • Generate one or thousands of events, dynamically randomized
  • Define behavioral chains (e.g., file drop → C2 → Mass Logon → New Service)
  • Ingest directly into your SIEM (Elastic, Splunk, etc.) via NDJSON

Project Structure

echothreat/
├── echothreat.py               # CLI input / core logic
├── configs/                    # YAML input values for each event
├── generators/
│   └── windows_log_generator.py # Renders log output from template + config
├── templates/                  # Jinja2 templates (e.g., security_4624_elastic.j2)
├── utils/
│   └── random.py               # rand() function for dynamic value generation
├── presets/                    # Multi-step attack chain definitions (YAML)
├── output/                     # Rendered logs (file, filebeat-ready)

Features

  • ECS-native field support
  • NDJSON output (Elastic-compatible)
  • Modular template system with rand() for host/user/IP
  • Preset chains using count: and throttle: logic
  • Ingest pipeline compatibility (sim.host_name → host.name)
  • CLI flags to control every step of the simulation

Maintainer

Echo<Threat was created and is maintained by Hal Denton
Originally released under DEATHGroup Labs LLC

"Special thanks to Black Hills Information Security (BHIS) for supporting the detection engineering community and pushing verification standards forward."

Tutorials

Echo<Threat

Detection Engineering LifeCycle

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 63.1%
  • Jinja 36.9%