thisistfs/rogue-frameworkDesktop-Arbeitsumgebung für AFL++-Fuzzing, architekturübergreifende QEMU-Emulation, Harness-Entwicklung, Ghidra-Headless-Analyse, benutzerdefinierte Mutatoren und Patch-Vergleich für die Exploit-Entwicklung.
Rogue Framework ist eine Desktop-Workbench für AFL++, architekturübergreifendes QEMU-Fuzzing, Harness-Entwicklung, leichtgewichtige Ghidra-Headless-Analyse, benutzerdefinierte Mutatoren und Patch-Vergleich. Es ist bewusst eine auditierbare Workbench und kein reiner Button-Wrapper: Jeder generierte AFL++-Befehl ist vor der Ausführung sichtbar, und generierte Harnesses sind gewöhnliche Quelldateien, die der Forscher bearbeiten kann. Es soll „das BurpSuite der Exploit-Entwickler" sein.
Rogue Framework zielt derzeit auf Linux und Python 3.11+ mit PyQt6 ab.
Unter Kali Linux richtet der Installer die Python-Umgebung ein, klont den offiziellen
AFL++-stable-Branch und baut dessen vollständige Distribution sowie das instrumentierte QEMU-
Backend, installiert anschließend Ghidra Headless, natives/multiarch GDB, GDB-Server, QEMU-
User-/System-Emulation, Compiler-/Build-Abhängigkeiten, einen Benutzer-Launcher und
persistente Shell-PATH-Einträge. AFL++ wird in das ignorierte lokale
AFLplusplus/-Verzeichnis heruntergeladen und ist nicht Teil der Distribution von Rogue Framework:
chmod +x install.sh
./install.sh
rogue-framework
Installiere zusätzlich gängige Cross-Compiler und deren Gast-Sysroots (dies ist ein deutlich größerer Download) mit:
./install.sh --with-cross-toolchains
Der Installer ist idempotent. Verwende ./install.sh --check, um eine bestehende
Installation zu prüfen, oder ./install.sh --rebuild-afl, um einen erzwungenen AFL++/QEMU-Neubuild
auszulösen. Verwende ./install.sh --update-afl, um den heruntergeladenen
Checkout explizit auf die neueste offizielle stabile Revision zu aktualisieren (Fast-Forward).
Führe es als Desktop-Benutzer aus; es fordert sudo nur für apt-Pakete an. Ein neu
geschriebener PATH kann die bereits laufende übergeordnete Shell nicht ändern, daher öffne entweder ein neues
Terminal, lade ~/.zshrc/~/.bashrc neu oder starte Rogue über den absoluten
Pfad ~/.local/bin/rogue-framework, den der Installer ausgibt.
Der manuelle Start aus dem Checkout bleibt weiterhin verfügbar:
python3 run.py
Für eine bearbeitbare Umgebung:
python3 -m pip install -e .
rogue-framework
Plattformübergreifende dynamische Binärdateien benötigen einen passenden Gast-Sysroot, der mit
QEMU_LD_PREFIX ausgewählt wird; dies ist inhärent ziel-/distributionsspezifisch. Ghidras
analyzeHeadless-Pfad kann unter Tools → External tools überschrieben werden.
Ein .rgp-Projekt ist lesbares, versioniertes JSON, das die portable Projektdefinition enthält. Große und veränderliche Artefakte befinden sich in seinem verwalteten Begleit-Workspace:
example.rgp
example.rgp-work/
workspace.json
project.sqlite3
corpus/
output/
harnesses/
mutators/
analysis/
logs/
runs/
staging/
recovery/
backups/
objects/sha256/
Diese Aufteilung hält die Projektdateien überprüfbar und vermeidet die Einbettung von Crash-Corpora, Findings, Analyseindizes oder Ghidra-Zuständen in JSON. workspace.json bindet das Manifest an die korrekte Workspace-Identität, während project.sqlite3 den operativen/indexierten Zustand speichert. Verwaltete Referenzen verwenden workspace://; explizit externe Ressourcen verwenden external://. Maschinenlokale Tool-Pfade und UI-Zustände werden außerhalb des portablen Projekts gespeichert.
Save As erstellt einen unabhängigen Klon mit neuen Projekt- und Workspace-Identitäten. Rogue validiert das Ziel vor dem Wechsel des geöffneten Dokuments, sodass ein fehlgeschlagener Klon das Quellprojekt unverändert lässt. Kanonische Speicherungen verwenden einen Advisory-Writer-Lease plus Revisions-/SHA-256-Konfliktprüfungen, bewahren vorherige gültige Manifeste, veröffentlichen Dateien atomar mit fsync und pflegen Crash-Recovery-Snapshots einschließlich aktiver Editor-Entwürfe. Generierte Harnesses, Mutatoren, Ghidra-JSON, Patch-Diff-Ergebnisse und minimierte Findings werden ebenfalls transaktional veröffentlicht, sodass ein fehlgeschlagener Ersatz das zuvor gültige Artefakt nicht löscht.
.fuzz-ProjekteRogue kann Legacy-.fuzz-Manifeste der Schemaversion 0–2 und ihre .fuzz-work-Begleiter importieren. Die Legacy-Quelle ist niemals das kanonische Ziel: Beim ersten Speichern wird sie zu einem benachbarten .rgp-Projekt und .rgp-work-Workspace hochgestuft, während die ursprünglichen Legacy-Dateien erhalten bleiben. Neue Projekte und Save-As-Ziele verwenden immer .rgp.