Un framework de desarrollo de implantes para Windows destinado a la ingeniería ofensiva y la investigación de C2.
Un framework moderno para el desarrollo de implantes en Windows para ingeniería ofensiva e investigación de C2.
Suture utiliza Crystal Palace para construir un binario plano que combina un cargador independiente de posición (PIC) con una carga útil PICO modular. Los proyectos componen bibliotecas de capacidades en tiempo de enlace con mergelib. La demo registra módulos al inicio y despacha los comandos entrantes por nombre. Un pequeño servidor en Go registra el tráfico TCP y HTTP para su inspección.
Leer el informe del laboratorio
Estado del laboratorio. Se compilaron y enlazaron siete variantes. El comportamiento en tiempo de ejecución sigue sin verificarse. El desensamblado estático muestra que el resolver de la demo se llama a sí mismo mientras intenta resolver
GetModuleHandleA. La ruta HTTPS de WinHTTP solicita excepciones para varios errores de certificado del servidor. Utilice este proyecto en un laboratorio aislado y autorizado.
loader.spec de cada proyecto controla la composición de bibliotecas. El binario externo es plano y contiene un stub PE incrustado con sus propios metadatos de importación.| Ruta | Contenido |
|---|---|
agent/src/ | Cargador, stub, punto de entrada y despachador de módulos |
agent/libs/ | Bibliotecas de depuración, utilidades y transporte, además de soporte de pruebas, definiciones de remap e interfaces de capacidades solo de cabecera |
basic/ y demo/ | Ejemplo mínimo y ejemplo de despacho de módulos |
tests/ | Fuentes de pruebas de LibUtils y del despachador |
tools/ y server/ | Ejecutor local y servidor de pruebas opcional en Go |
La compilación verificada utilizó Windows 11 x64 con la cadena de herramientas MSYS2 UCRT64, MinGW-w64 GCC 16.1.0 y Temurin JDK 25.0.4.1. Tenga Bash, GNU Make, x86_64-w64-mingw32-gcc, Python 3, zip y java en el PATH. La compilación también espera crystal-palace/crystalpalace.jar y los archivos de remap bajo agent/libs/cp-dfr-defs/, incluido el dfr_agent.spec específico del proyecto.
Desde la raíz del proyecto, compile primero el archivo LibTCG. Las especificaciones del enlazador del proyecto lo esperan junto a los directorios de bibliotecas.
make -C agent/libs/libtcg x64
cp agent/libs/libtcg/libtcg.x64.zip agent/libs/libtcg.x64.zip
make -C basic shellcode
Si la receta de archivo en common.mk genera un IndentationError bajo MSYS2, coloque import zipfile; inmediatamente después de la comilla de apertura en el comando python3 -c. Esto elimina el espacio en blanco inicial introducido por la continuación de línea. La auditoría de compilación utilizó ese ajuste en su copia de trabajo.
| Comando | Salida |
|---|---|
make basic | Compilación y ejecutor TCP básico |
make demo | Compilación y ejecutor TCP de demostración |
make -C basic http o make -C demo http | Variante HTTP y ejecutor |
make basic-debug o make demo-debug | Variante de depuración TCP y ejecutor |
make test | Payload PICO de prueba y ejecutor |
Las salidas van a bin/. Compile las variantes de forma secuencial y copie cualquier artefacto que desee conservar antes de compilar otra variante. Los proyectos comparten los nombres de archivo de salida.
| Compilación | Bytes |
|---|---|
| TCP básico | 6.769 |
| HTTP básico | 7.922 |
| TCP básico de depuración | 9.086 |
| TCP de demostración | 13.311 |
| HTTP de demostración | 14.464 |
| TCP de demostración de depuración | 15.524 |
| Suite de pruebas | 18.460 |
Estos tamaños se reprodujeron utilizando el archivo LibTCG disponible. Una compilación limpia desde cero que regeneró el archivo a partir del código fuente incluido produjo un payload TCP básico de 6.830 bytes. El PICO de prueba midió 18.444 bytes después de que su banner fuera renombrado a Suture.
Las fuentes de prueba registran 17 pruebas de utilidades y ocho pruebas de despacho de módulos a través de LibCPLTest. Las aserciones fallidas no son fatales y se registran a través del flujo del depurador de Windows. Un make test exitoso confirma la compilación. Los resultados de las pruebas requieren la salida del depurador de una sesión de ejecución aislada.
Utilice scaffold.sh para crear un proyecto a partir de la plantilla básica. Consulte la plantilla de biblioteca para conocer la estructura de la biblioteca y las convenciones de mergelib.
Consulte LICENSE.txt para los avisos incluidos. El árbol incluye código de Crystal Palace, LibTCG y cp-dfr-defs. Consulte los avisos upstream incluidos para LibCPLTest y el wrapper LibWinHttp. Los archivos cp-dfr-defs incluidos se basan en el commit upstream 202473b e incluyen la superposición local dfr_agent.spec.
Ilustración de mascota generada para este proyecto. Las referencias incluyen el remix de la mascota BingusLdr y el arte oficial del personaje de Cobalt Strike.