
프로덕션 플랫폼에서 추출한 기만 엔지니어링 도구로, 실시간 공격자 트래픽, 공급망 카나리 토큰, 허니팟 로그를 → MITRE ATT&CK 점수화하고, 서명되고 버전 관리 가능한 기만 구성 명세를 제공합니다. 순수 Python, MIT.

실제 인터넷 트래픽을 처리하는 프로덕션 보안 플랫폼에서 분리해 내어, 제품/비밀 정보와의 결합을 모두 제거하고 MIT 라이선스로 공개한 네 가지 기만 엔지니어링 도구입니다.
이것은 실험실 데모가 아닙니다. 각 도구는 WraithWall의 일부입니다. WraithWall은 리버스 프록시 뒤에서 허니팟이 24시간 내내 데이터를 공급하는, 1인 개발 기만 플랫폼입니다. 이 도구들은 단독으로도 충분히 재사용 가능한 부분들입니다. 허니팟을 운영하거나, 카나리를 심거나, 기만 설정을 코드처럼 버전 관리하고 싶다면 이 도구들이 적합합니다.
모든 프로젝트는 자체 README, 예제, 테스트, CLI를 갖춘 독립적인 pip install 가능 패키지입니다. 플랫폼에 대한 의존성은 없습니다 — 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 서명된 명세입니다. 검증, 서명, 확인을 통해 기만 설정을 diff 가능하고 변조 증거가 남도록 합니다. | cd dml-spec && pip install . | v2 (0.2.0 준비됨, 아직 업로드되지 않음) |
| wraithmesh | 분산 센서 메시 — Cowrie 로그를 tail하고, 캠페인을 로컬에서 축약하며, 서명된 동등 클래스 관측값을 상호 검증하는 애그리게이터로 업링크합니다. 기본적으로 프라이버시를 보존하는 송출. | 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에 선언되어 있습니다.네 프로젝트 모두 MIT License로 배포됩니다 — © 2026 Niffyhunt. 사용하고, 포크하고, 배포하세요. 출처 표기는 감사하지만 필수는 아닙니다.
WraithWall 프로젝트의 일부 · 제작 Niffy_hunt · X의 @wraithwalll · GitHub의 wraithwall