Uma estrutura de desenvolvimento de implantes para Windows voltada à engenharia ofensiva e à pesquisa de C2.
Um Framework Moderno de Desenvolvimento de Implantes para Windows voltado à Engenharia Ofensiva e à Pesquisa de C2.
O Suture usa o Crystal Palace para construir um binário flat que combina um loader independente de posição (PIC) com um payload PICO modular. Os projetos compõem bibliotecas de capacidades em tempo de link com o mergelib. A demo registra módulos na inicialização e despacha comandos recebidos por nome. Um pequeno servidor em Go registra o tráfego TCP e HTTP para inspeção.
Leia o relatório do laboratório
Status do laboratório. Sete variantes foram compiladas e linkadas. O comportamento em tempo de execução permanece não verificado. A desmontagem estática mostra o resolver da demo chamando a si mesmo ao tentar resolver
GetModuleHandleA. O caminho HTTPS do WinHTTP solicita exceções para vários erros de certificado do servidor. Use este projeto em um laboratório isolado e autorizado.
loader.spec de cada projeto controla a composição de bibliotecas. O binário externo é flat e contém uma stub PE embutida com seus próprios metadados de importação.| Caminho | Conteúdo |
|---|---|
agent/src/ | Loader, stub, ponto de entrada e dispatcher de módulos |
agent/libs/ | Bibliotecas de depuração, utilitários e transporte, além de suporte a testes, definições de remap e interfaces de capacidade header-only |
basic/ e demo/ | Exemplo mínimo e exemplo de despacho de módulos |
tests/ | Fontes de teste do LibUtils e do dispatcher |
tools/ e server/ | Runner local e servidor de teste opcional em Go |
A compilação verificada usou Windows 11 x64 com a toolchain MSYS2 UCRT64, MinGW-w64 GCC 16.1.0 e Temurin JDK 25.0.4.1. Tenha Bash, GNU Make, x86_64-w64-mingw32-gcc, Python 3, zip e java no PATH. A compilação também espera crystal-palace/crystalpalace.jar e os arquivos de remap em agent/libs/cp-dfr-defs/, incluindo o dfr_agent.spec específico do projeto.
A partir da raiz do projeto, compile primeiro o arquivo LibTCG. As especificações de linker do projeto esperam encontrá-lo ao lado dos diretórios de bibliotecas.
make -C agent/libs/libtcg x64
cp agent/libs/libtcg/libtcg.x64.zip agent/libs/libtcg.x64.zip
make -C basic shellcode
Se a receita de arquivamento em common.mk gerar IndentationError no MSYS2, coloque import zipfile; imediatamente após a aspa de abertura no comando python3 -c. Isso remove o espaço em branco inicial introduzido pela continuação de linha. A auditoria de build usou esse ajuste em sua cópia de rascunho.
| Comando | Saída |
|---|---|
make basic | Build e runner TCP básico |
make demo | Build e runner TCP de demonstração |
make -C basic http ou make -C demo http | Variante HTTP e runner |
make basic-debug ou make demo-debug | Variante TCP de depuração e runner |
make test | Payload PICO de teste e runner |
As saídas vão para bin/. Compile as variantes sequencialmente e copie qualquer artefato que deseja manter antes de compilar outra variante. Os projetos compartilham os mesmos nomes de arquivo de saída.
| Build | Bytes |
|---|---|
| TCP básico | 6.769 |
| HTTP básico | 7.922 |
| TCP básico de depuração | 9.086 |
| TCP de demonstração | 13.311 |
| HTTP de demonstração | 14.464 |
| TCP de demonstração de depuração | 15.524 |
| Suíte de testes | 18.460 |
Esses tamanhos foram reproduzidos usando o arquivo LibTCG disponível. Um build limpo em rascunho que regenerou o arquivo a partir do código-fonte incluído produziu um payload TCP básico de 6.830 bytes. O PICO de teste mediu 18.444 bytes após seu banner ser renomeado para Suture.
As fontes de teste registram 17 testes de utilitários e oito testes de despacho de módulo por meio do LibCPLTest. As asserções com falha não são fatais e são registradas via stream do depurador do Windows. Um make test bem-sucedido confirma o build. Os resultados dos testes exigem saída do depurador de uma sessão de runtime isolada.
Use scaffold.sh para criar um projeto a partir do template básico. Consulte o template de biblioteca para o layout da biblioteca e as convenções do mergelib.
Consulte LICENSE.txt para os avisos incluídos. A árvore inclui código do Crystal Palace, do LibTCG e do cp-dfr-defs. Consulte os avisos upstream incluídos para o LibCPLTest e o wrapper LibWinHttp. Os arquivos cp-dfr-defs vendorizados são baseados no commit upstream 202473b e incluem a sobreposição local dfr_agent.spec.
Ilustração do mascote gerada para este projeto. As referências incluem o remix do mascote BingusLdr e a arte oficial do personagem Cobalt Strike.