← 返回列表

attack_range: Splunk Attack Range

聚合站 SecWiki技术 入库 2026-11-18T11:36:02

Attack Range Logo

The Splunk Attack Range builds instrumented cloud environments (AWS, Azure, GCP), simulates attacks, and forwards data into Splunk for detection development and testing.

Attack Range Architecture

What it does:

Click the picture to watch the demo 👇

Preferred: Docker Compose

  1. Prerequisites: Docker and Docker Compose. Configure your cloud provider (AWS, Azure, or GCP) and mount credentials as below.
  2. Clone and start:
    git clone \ cd attack_range_2 docker compose -f docker/docker-compose.yml up
  3. Use the app or API:
    - Web app: open http://localhost:4321 — build/destroy ranges, view status, run simulations, share access.
    - API: http://localhost:4000 — REST API; interactive docs at http://localhost:4000/openapi/swagger.
  4. Build a range (two steps):
    - In the app: pick a template (e.g. aws/splunk_minimal_aws) and start the build. When status is Waiting for VPN, download the WireGuard config, connect with WireGuard, then continue the build.
    - Or via API: POST /attack-range/build with {"template": "aws/splunk_minimal_aws"}, poll GET /attack-range/status/<id>, use the returned WireGuard config, connect, then POST /attack-range/build with {"attack_range_id": "<id>"}.
  5. CLI in Docker (optional):
    docker compose --profile cli -f docker/docker-compose.yml run --rm attack_range build -t aws/splunk_minimal_aws Other actions: destroy, simulate, apply-role, share. See Detailed documentation for CLI usage and flags.
Method Use case
Docker Compose (recommended) Run API + web app + optional CLI with one docker compose; no local Python/Ansible/Terraform.
Web app Build, destroy, simulate, and share via the UI at port 4321.
REST API Automate from scripts or CI; full OpenAPI docs at /openapi/swagger.
CLI `attack_range.py build

Please use the GitHub issue tracker to submit bugs or request features.

If you have questions or need support, you can:

We welcome feedback and contributions from the community! Please see our contribution guidelines for more information on how to get involved.

原文链接:https://github.com/splunk/attack_range