Deadend

Executável leve de honeypot com script, que carrega scripts Lua de um diretório, compila-os em memória, ouve com um listener TCP por script e executa emulação de serviço quando uma porta é acionada. A ideia é confundir a equipe vermelha ou agentes maliciosos durante a observação do servidor e a varredura de portas.

O código é limpo e simples de entender, sendo bom para projetos educacionais.

Manual de API e Scripting

Atenção! A versão atual é incompatível com scripts feitos para versão <0.3.0. Como este programa foi usado por apenas alguns usuários, decidi não alterar o primeiro número na versão semântica.

Compilação

Requisitos:

• CMake 3.20+
• Compilador C23
• Pacote de desenvolvimento Lua (cabeçalhos + biblioteca)

Linux

cmake -S . -B build
cmake --build build -j
./build/deadend -dir ./examples

Windows (PowerShell)

Instale o LUA primeiro:

pacman -S mingw-w64-x86_64-lua

Em seguida, compile e execute:

cmake -S . -B build
cmake --build build --config Release
.\build\Release\deadend.exe -dir .\examples

Uso

deadend -dir <path>

Nomenclatura dos arquivos de script

O Deadend carrega apenas arquivos que correspondem a:

• 1.lua ... 65535.lua
• Nomes não numéricos são ignorados silenciosamente.

Cada nome de arquivo válido indica em qual porta TCP o script irá atuar.

Scripts de exemplo

• examples/22.lua: comportamento básico de resposta Telnet
• examples/80.lua: comportamento HTTP simples