Инструменты deception-engineering, извлечённые из production-платформы, которая берёт живой трафик атакующих, supply-chain canary-токены, логи honeypot → оценку по MITRE ATT&CK и подписанную, версионируемую спецификацию deception-конфигурации. Чистый Python, MIT.

Четыре инструмента для проектирования обмана, извлечённые из производственной security-платформы, которая принимает живой интернет-трафик, очищенные от всех продуктовых/секретных связей и выпущенные под MIT.
Это не лабораторная демонстрация. Каждый инструмент — часть WraithWall — платформы обмана, созданной одним разработчиком, работающей за обратным прокси с honeypot, который питает её круглосуточно. Это те части, которые действительно можно переиспользовать отдельно: если вы запускаете honeypot, размещаете canary-токены или хотите версионировать конфигурацию обмана как код, они для вас.
Каждый проект — это самостоятельный пакет, устанавливаемый через pip install, со своим README, примерами,
тестами и CLI. Никакой зависимости от платформы — ни Flask, ни базы данных, ни секретов.
| Проект | Что делает | Установка | PyPI |
|---|---|---|---|
| canary-kit | Создаёт, регистрирует и обнаруживает canary-токены цепочки поставок — сопоставляет входящий beacon напрямую с токеном, который вы разместили. Подключаемое хранилище, опциональный Redis. | pip install canary-kit | Опубликовано 0.1.0 |
| honeypot-mitre | Превращает сырые логи honeypot Cowrie в структурированные техники MITRE ATT&CK, детерминированную оценку и дедупликацию повторов — LLM не требуется (это опциональное дополнение). | pip install honeypot-mitre | Опубликовано 0.1.0 |
| dml-spec | Deception Markup Language — версионируемая спецификация конфигурации ловушек/canary с HMAC-подписью. Валидация, подпись и проверка, чтобы ваш обман был диффабельным и защищённым от подмены. | cd dml-spec && pip install . | v2 (0.2.0 готова, ещё не загружена) |
| wraithmesh | Распределённая сенсорная сеть — отслеживает логи Cowrie, локально сворачивает кампании, передаёт подписанные наблюдения классов эквивалентности агрегаторам для взаимного подтверждения. Приватность исходящего трафика по умолчанию. | cd honeypot-mitre && pip install . && cd ../wraithmesh && pip install . | v2 (0.2.0 готова, ещё не загружена) |
Связанные опубликованные пакеты вне этой папки: wraithwall (платформа), ravenscan (raven CLI).
Клиент HTTP API будет wraithwall-sdk (всё ещё в разработке; не входит в этот toolkit).
Полный чек-лист релиза v2 см. в PACKAGE_INVENTORY.md.
# 1. Canary Kit — mint a token, then detect its beacon
cd canary-kit && pip install .
canary-kit --registry demo.json mint internal-sdk 2.4.1 --type runtime
# ...the token later beacons home from an environment you don't control:
canary-kit --registry demo.json beacon <token-from-mint> --ip 198.51.100.23
# 2. Honeypot → MITRE — raw cowrie log to scored, mapped sessions
cd ../honeypot-mitre && pip install .
honeypot-mitre examples/sample_cowrie.json # → per-session techniques + score + dedup key
# 3. DML — validate, sign, and verify a deception document
cd ../dml-spec && pip install .
export DML_KEY="your-signing-key"
dml validate examples/example_traps.yaml
dml sign examples/example_traps.yaml --key-env DML_KEY > signed.yaml
dml verify signed.yaml --key-env DML_KEY
# 4. WraithMesh — Cowrie tail to signed campaign observations
cd ../wraithmesh && pip install .
export WRAITHMESH_KEY="demo-key"
wraithmesh init-manifest --output /tmp/mesh.json
wraithmesh sensor run --config /tmp/mesh.json --once --log ../honeypot-mitre/examples/sample_cowrie.json
Полное описание API, CLI и заметки по проектированию см. в README каждого проекта.
pyproject.toml.Все четыре проекта выпущены под MIT License — © 2026 Niffyhunt. Используйте их, форкайте, распространяйте. Указание авторства приветствуется, но не требуется.
Часть проекта WraithWall · от Niffy_hunt · @wraithwalll в X · wraithwall на GitHub