Un framework de développement d'implants Windows pour l'ingénierie offensive et la recherche C2.
Un framework moderne de développement d'implants Windows pour l'ingénierie offensive et la recherche C2.
Suture utilise Crystal Palace pour construire un binaire plat qui associe un loader indépendant de la position (PIC) à une charge utile PICO modulaire. Les projets composent des bibliothèques de capacités au moment de l'édition de liens avec mergelib. La démo enregistre des modules au démarrage et distribue les commandes entrantes par nom. Un petit serveur Go journalise le trafic TCP et HTTP pour inspection.
Statut du lab. Sept variantes ont été compilées et liées. Le comportement à l'exécution reste non vérifié. Le désassemblage statique montre que le résolveur de la démo s'appelle lui-même en tentant de résoudre
GetModuleHandleA. Le chemin WinHTTP HTTPS demande des exceptions pour plusieurs erreurs de certificat serveur. Utilisez ce projet dans un lab isolé et autorisé.
loader.spec de chaque projet contrôle la composition des bibliothèques. Le binaire externe est plat et contient un stub PE embarqué avec ses propres métadonnées d'import.| Chemin | Contenu |
|---|---|
agent/src/ | Loader, stub, point d'entrée et répartiteur de modules |
agent/libs/ | Bibliothèques de débogage, utilitaires et de transport, ainsi que le support de test, les définitions de remap et les interfaces de capacités header-only |
basic/ et demo/ | Exemple minimal et exemple de répartition de modules |
tests/ | Sources de test de LibUtils et du répartiteur |
tools/ et server/ | Runner local et serveur de test Go optionnel |
La compilation vérifiée a utilisé Windows 11 x64 avec la chaîne d'outils MSYS2 UCRT64, MinGW-w64 GCC 16.1.0 et Temurin JDK 25.0.4.1. Disposez de Bash, GNU Make, x86_64-w64-mingw32-gcc, Python 3, zip et java dans le PATH. La compilation attend également crystal-palace/crystalpalace.jar et les fichiers de remap sous agent/libs/cp-dfr-defs/, y compris le fichier dfr_agent.spec spécifique au projet.
Depuis la racine du projet, compilez d'abord l'archive LibTCG. Les specs de l'éditeur de liens du projet l'attendent à côté des répertoires de bibliothèques.
make -C agent/libs/libtcg x64
cp agent/libs/libtcg/libtcg.x64.zip agent/libs/libtcg.x64.zip
make -C basic shellcode
Si la recette d'archive dans common.mk déclenche une IndentationError sous MSYS2, placez import zipfile; immédiatement après le guillemet d'ouverture dans la commande python3 -c. Cela supprime l'espace blanc initial introduit par la continuation de ligne. L'audit de build a utilisé cet ajustement dans sa copie de travail.
| Commande | Sortie |
|---|---|
make basic | Build et runner TCP basique |
make demo | Build et runner TCP de démonstration |
make -C basic http ou make -C demo http | Variante HTTP et runner |
make basic-debug ou make demo-debug | Variante TCP de débogage et runner |
make test | Charge utile PICO de test et runner |
Les sorties sont placées dans bin/. Effectuez les builds des variantes séquentiellement et copiez tout artefact que vous souhaitez conserver avant de compiler une autre variante. Les projets partagent les mêmes noms de fichiers de sortie.
| Build | Octets |
|---|---|
| TCP basique | 6 769 |
| HTTP basique | 7 922 |
| TCP basique debug | 9 086 |
| TCP démo | 13 311 |
| HTTP démo | 14 464 |
| TCP démo debug | 15 524 |
| Suite de tests | 18 460 |
Ces tailles ont été reproduites à l'aide de l'archive LibTCG disponible. Un build propre dans un répertoire de travail qui a régénéré l'archive à partir des sources incluses a produit une charge utile TCP basique de 6 830 octets. Le PICO de test mesurait 18 444 octets après le renommage de sa bannière en Suture.
Les sources de test enregistrent 17 tests utilitaires et huit tests de répartition de modules via LibCPLTest. Les assertions échouées ne sont pas fatales et sont journalisées via le flux du débogueur Windows. Un make test réussi confirme le build. Les résultats des tests nécessitent la sortie du débogueur depuis une session d'exécution isolée.
Utilisez scaffold.sh pour créer un projet à partir du modèle basique. Consultez le modèle de bibliothèque pour la structure de la bibliothèque et les conventions mergelib.
Consultez LICENSE.txt pour les mentions incluses. L'arborescence inclut du code provenant de Crystal Palace, LibTCG et cp-dfr-defs. Consultez les mentions amont incluses pour LibCPLTest et le wrapper LibWinHttp. Les fichiers cp-dfr-defs vendus sont basés sur le commit amont 202473b et incluent la surcouche locale dfr_agent.spec.
Illustration de mascotte générée pour ce projet. Les références incluent le remix de la mascotte BingusLdr et l'illustration officielle du personnage Cobalt Strike.