
本番環境のプラットフォームから抽出されたデセプションエンジニアリングツール。ライブの攻撃者トラフィック、サプライチェーンカナリートークン、ハニーポットログを取り込み → MITRE ATT&CKスコアリング、および署名済みでバージョン管理可能なデセプション設定仕様。Pure Python、MIT。

実際のインターネットトラフィックを受け付ける本番セキュリティプラットフォームから取り出し、 製品やシークレットとの結合をすべて取り除いた上で MIT ライセンスで公開した、4つのデセプションエンジニアリングツールです。
これはラボのデモではありません。各ツールは WraithWall の一部です — WraithWall は、ハニーポットを24時間稼働させてリバースプロキシの背後で動く、個人開発のデセプションプラットフォームです。 ここに含まれるのは、単体でも本当に再利用できる部分です。ハニーポットを運用している方、カナリアを仕込んでいる方、 あるいはデセプション設定をコードのようにバージョン管理したい方にぴったりです。
各プロジェクトはスタンドアロンで pip install 可能なパッケージであり、独自の README、サンプル、テスト、CLI を備えています。
プラットフォームへの依存はありません — Flask もデータベースもシークレットも不要です。
| プロジェクト | 機能 | インストール | PyPI |
|---|---|---|---|
| canary-kit | サプライチェーンカナリートークンの発行・登録・検出 — 受信したビーコンを、仕込んだトークンに直接照合します。プラガブルなストレージ、オプションで Redis 対応。 | pip install canary-kit | 公開済み 0.1.0 |
| honeypot-mitre | 生の Cowrie ハニーポットログを、構造化された MITRE ATT&CK テクニック、決定論的スコア、リプレイ重複排除に変換 — LLM は不要です(オプションの追加機能として利用可能)。 | pip install honeypot-mitre | 公開済み 0.1.0 |
| dml-spec | Deception Markup Language — トラップ/カナリア設定のための、バージョン管理された 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 になる予定です(まだ開発中。本ツールキットには含まれません)。
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 で宣言されています。4つのプロジェクトはすべて MIT License の下でリリースされています — © 2026 Niffyhunt。 使用、フォーク、配布は自由です。クレジット表記は歓迎しますが、必須ではありません。
WraithWall プロジェクトの一部 · 作者 Niffy_hunt · X の @wraithwalll · GitHub の wraithwall