blueproxy

합법적 모의침투 범위 내 TCP 프록시. 변조(mutation) 및 코덱 파이프라인을 지원한다.

요구사항

• Python >= 3.11
• Windows (WinDivert 패킷 캡처 시 관리자 권한 필요)

설치

pip install -e .

실행

# GUI 모드 (기본)
blueproxy

# CLI 모드
blueproxy <command> [options]

CLI 명령어

명령어	설명
control-plane	제어판 API 서버
engine	TCP 프록시 엔진
socks5	SOCKS5 변조 프록시
windivert	Windows WinDivert 패킷 캡처
windows-collector	Windows 수집기 브릿지
replay	PCAP 리플레이
perf	성능 벤치마크
integrity-sync	정책/규칙 SHA256 해시 동기화
android-sim	Android 수집기 시뮬레이터
ios-sim	iOS 수집기 시뮬레이터

모든 명령어는 --config 옵션을 지원한다 (기본값: configs/phase1.yaml).

주요 기능

• TCP 프록시: 라우트 기반 TCP 리스너 + SOCKS5 프록시
• 패킷 변조: delay, drop, replace, inject (YAML 규칙 기반)
• 코덱 파이프라인: raw-bytes, base64, hex, gzip 등 체이닝
• 인터셉트: 실시간 패킷 검사 및 전달/차단/교체
• WinDivert: Windows 커널 레벨 패킷 캡처
• 범위 제어: CIDR/도메인 허용 목록 기반 스코프 검증
• 감사 로그: 모든 변조/인터셉트 작업 기록
• 무결성 검증: 정책 및 규칙 파일 SHA256 해시 검증

프로젝트 구조

configs/        설정 파일
policies/       인게이지먼트 정책 템플릿
rules/          변조 규칙 정의
vendor/         WinDivert 바이너리 (DLL, SYS)
tcp_proxy/      프록시 엔진 및 제어판

빌드 (standalone exe)

pip install pyinstaller
pyinstaller blueproxy.spec

결과물: dist/blueproxy.exe