thisistfs/rogue-frameworkAFL++ 퍼징, 크로스 아키텍처 QEMU 에뮬레이션, 하니스 개발, Ghidra 헤드리스 분석, 커스텀 뮤테이터, 익스플로잇 개발용 패치 비교를 위한 데스크톱 워크벤치
Rogue Framework는 AFL++, 크로스 아키텍처 QEMU 퍼징, 하네스 개발, 경량 Ghidra 헤드리스 분석, 사용자 정의 뮤테이터, 패치 비교를 위한 데스크톱 워크벤치입니다. 이는 의도적으로 버튼만 누르는 래퍼가 아닌 감사 가능한 워크벤치로 설계되었습니다: 생성된 모든 AFL++ 명령은 실행 전에 확인할 수 있으며, 생성된 하네스는 연구자가 편집할 수 있는 일반 소스 파일입니다. 이는 "익스플로잇 개발자를 위한 BurpSuite"를 지향합니다.
Rogue Framework는 현재 PyQt6와 함께 Linux 및 Python 3.11+를 대상으로 합니다.
Kali Linux에서 설치 프로그램은 Python 환경을 설정하고, 공식
AFL++ stable 브랜치를 클론하여 전체 배포판과 계측된 QEMU
백엔드를 빌드한 다음, Ghidra 헤드리스, 네이티브/멀티아키텍처 GDB, GDB 서버, QEMU
사용자/시스템 에뮬레이션, 컴파일러/빌드 종속성, 사용자 런처, 그리고
영구 셸 PATH 항목을 설치합니다. AFL++는 무시된 로컬
AFLplusplus/ 디렉터리에 다운로드되며 Rogue Framework의 일부로 배포되지 않습니다:
chmod +x install.sh
./install.sh
rogue-framework
공통 크로스 컴파일러와 해당 게스트 sysroot도 함께 설치합니다(훨씬 큰 다운로드임):
./install.sh --with-cross-toolchains
설치 프로그램은 멱등적입니다. 기존 설치를 점검하려면 ./install.sh --check를 사용하고, AFL++/QEMU 재빌드를 강제하려면 ./install.sh --rebuild-afl을 사용하세요. 다운로드한 체크아웃을 최신 공식 안정 리비전으로 명시적으로 fast-forward하려면 ./install.sh --update-afl을 사용하세요.
데스크톱 사용자로 실행하세요. 이 스크립트는 apt 패키지에 대해서만 sudo를 요청합니다. 새로 작성된 PATH는 이미 실행 중인 부모 셸을 변경할 수 없으므로, 새 터미널을 열거나 ~/.zshrc/~/.bashrc를 source하거나, 설치 프로그램이 출력하는 절대 경로 ~/.local/bin/rogue-framework를 통해 Rogue를 실행하세요.
체크아웃에서 수동으로 시작하는 방법도 여전히 사용할 수 있습니다:
python3 run.py
편집 가능한 환경의 경우:
python3 -m pip install -e .
rogue-framework
크로스 아키텍처 동적 바이너리는 QEMU_LD_PREFIX로 선택한 일치하는 게스트 sysroot가 필요하며, 이는 본질적으로 대상/배포판에 따라 다릅니다. Ghidra의 analyzeHeadless 경로는 Tools → External tools에서 재정의할 수 있습니다.
.rgp 프로젝트는 이식 가능한 프로젝트 정의를 담은 읽기 가능한 버전 관리 JSON입니다. 크고 변경 가능한 아티팩트는 관리되는 동반 워크스페이스에 저장됩니다:
example.rgp
example.rgp-work/
workspace.json
project.sqlite3
corpus/
output/
harnesses/
mutators/
analysis/
logs/
runs/
staging/
recovery/
backups/
objects/sha256/
이 분할은 프로젝트 파일을 검토 가능하게 유지하고 크래시 코퍼스, 발견 사항, 분석 인덱스 또는 Ghidra 상태를 JSON에 포함하지 않도록 합니다. workspace.json은 매니페스트를 올바른 워크스페이스 ID에 바인딩하며, project.sqlite3는 운영/인덱싱된 상태를 저장합니다. 관리되는 참조는 workspace://를 사용하고, 명시적으로 외부 리소스인 경우 external://를 사용합니다. 머신 로컬 도구 경로와 UI 상태는 이식 가능한 프로젝트 외부에 저장됩니다.
다른 이름으로 저장은 새 프로젝트 및 워크스페이스 ID를 가진 독립적인 복제본을 생성합니다. Rogue는 열린 문서를 전환하기 전에 대상을 준비하고 검증하므로, 복제에 실패하면 소스 프로젝트는 변경되지 않습니다. 정규 저장은 권고적 작성자 임대와 리비전/SHA-256 충돌 검사를 사용하고, 이전 정상 매니페스트를 보존하며, fsync를 통해 파일을 원자적으로 게시하고, 활성 편집기 초안을 포함한 크래시 복구 스냅샷을 유지합니다. 생성된 하네스, 뮤테이터, Ghidra JSON, 패치-디프 결과 및 최소화된 발견 사항도 트랜잭션 방식으로 게시되므로, 교체에 실패해도 이전의 유효한 아티팩트가 삭제되지 않습니다.
.fuzz 프로젝트Rogue는 레거시 스키마 0–2 .fuzz 매니페스트와 그에 딸린 .fuzz-work 컴패니언을 가져올 수 있습니다. 레거시 소스는 결코 정규 대상이 되지 않습니다. 첫 저장 시 레거시 소스를 형제 .rgp 프로젝트와 .rgp-work 워크스페이스로 업그레이드하면서 원본 레거시 파일은 유지합니다. 새 프로젝트와 다른 이름으로 저장 대상은 항상 .rgp를 사용합니다.