Un framework per lo sviluppo di implant Windows per offensive engineering e ricerca C2.
Un framework moderno per lo sviluppo di implant Windows per l'ingegneria offensiva e la ricerca su C2.
Suture utilizza Crystal Palace per costruire un binario flat che abbina un loader position-independent (PIC) a un payload PICO modulare. I progetti compongono le librerie di capacità in fase di link con mergelib. La demo registra i moduli all'avvio e smista i comandi in arrivo per nome. Un piccolo server Go registra il traffico TCP e HTTP per l'ispezione.
Stato del lab. Sette varianti sono state compilate e linkate. Il comportamento a runtime rimane non verificato. Il disassemblaggio statico mostra il resolver della demo che chiama se stesso mentre tenta di risolvere
GetModuleHandleA. Il percorso WinHTTP HTTPS richiede eccezioni per diversi errori di certificato del server. Utilizza questo progetto in un lab isolato e autorizzato.
loader.spec di ciascun progetto controlla la composizione delle librerie. Il binario esterno è flat e contiene una stub PE incorporata con i propri metadati di import.| Percorso | Contenuti |
|---|---|
agent/src/ | Loader, stub, punto di ingresso e dispatcher dei moduli |
agent/libs/ | Librerie di debug, utility e trasporto, oltre al supporto per i test, alle definizioni di remap e alle interfacce di capacità header-only |
basic/ e demo/ | Esempio minimale ed esempio di dispatch dei moduli |
tests/ | Sorgenti dei test di LibUtils e del dispatcher |
tools/ e server/ | Runner locale e server di test Go opzionale |
La build verificata ha utilizzato Windows 11 x64 con la toolchain MSYS2 UCRT64, MinGW-w64 GCC 16.1.0 e Temurin JDK 25.0.4.1. Assicurati di avere Bash, GNU Make, x86_64-w64-mingw32-gcc, Python 3, zip e java nel PATH. La build si aspetta inoltre crystal-palace/crystalpalace.jar e i file di remap sotto agent/libs/cp-dfr-defs/, incluso il file dfr_agent.spec specifico del progetto.
Dalla radice del progetto, compila prima l'archivio LibTCG. Le spec del linker del progetto lo attendono accanto alle directory delle librerie.
make -C agent/libs/libtcg x64
cp agent/libs/libtcg/libtcg.x64.zip agent/libs/libtcg.x64.zip
make -C basic shellcode
Se la recipe di archiviazione in common.mk genera IndentationError in MSYS2, inserisci import zipfile; immediatamente dopo la virgoletta di apertura nel comando python3 -c. Questo rimuove gli spazi bianchi iniziali introdotti dalla continuazione di riga. L'audit della build ha utilizzato questa modifica nella sua copia temporanea.
| Comando | Output |
|---|---|
make basic | Build e runner TCP di base |
make demo | Build e runner TCP demo |
make -C basic http o make -C demo http | Variante HTTP e runner |
make basic-debug o make demo-debug | Variante TCP di debug e runner |
make test | Payload PICO di test e runner |
Gli output vengono salvati in bin/. Compila le varianti in sequenza e copia qualsiasi artefatto che desideri conservare prima di compilare un'altra variante. I progetti condividono i nomi dei file di output.
| Build | Byte |
|---|---|
| TCP di base | 6.769 |
| HTTP di base | 7.922 |
| TCP di base debug | 9.086 |
| TCP demo | 13.311 |
| HTTP demo | 14.464 |
| TCP demo debug | 15.524 |
| Suite di test | 18.460 |
Queste dimensioni sono state riprodotte utilizzando l'archivio LibTCG disponibile. Una build temporanea pulita che ha rigenerato l'archivio dal codice sorgente incluso ha prodotto un payload TCP di base di 6.830 byte. Il PICO di test ha misurato 18.444 byte dopo che il suo banner è stato rinominato in Suture.
I sorgenti di test registrano 17 test di utilità e otto test di dispatch dei moduli tramite LibCPLTest. Le asserzioni fallite non sono fatali e vengono registrate tramite lo stream del debugger di Windows. Un make test riuscito conferma la build. I risultati dei test richiedono l'output del debugger da una sessione di runtime isolata.
Usa scaffold.sh per creare un progetto dal template di base. Consulta il template della libreria per la struttura della libreria e le convenzioni di mergelib.
Consulta LICENSE.txt per le note incluse. L'albero include codice da Crystal Palace, LibTCG e cp-dfr-defs. Consulta le note upstream incluse per LibCPLTest e il wrapper LibWinHttp. I file cp-dfr-defs vendored si basano sul commit upstream 202473b e includono l'overlay locale dfr_agent.spec.
Illustrazione della mascotte generata per questo progetto. I riferimenti includono il remix della mascotte BingusLdr e l'artwork ufficiale del personaggio Cobalt Strike.