Repolode
beelzebub-labs

beelzebub-labs/beelzebub

Framework de deception open source em Go para implantar serviços SSH, HTTP, TCP, TELNET e MCP-isca e registrar interações de atacantes como evidências.

Estrelas
2,232
Forks
221
Issues abertas
11
Último commit
há 5 dias

O que é?

Beelzebub é um framework de deception para equipes de segurança que querem estudar atividades direcionadas a serviços-isca. Os serviços, as rotas e as regras de resposta são definidos em YAML, e cada resposta pode ser estática ou gerada por um provedor de LLM. Plugins confiáveis em Go podem ser compilados para ampliar os serviços e as respostas.

Quando um atacante interage com um serviço-isca, o runtime registra evidências como comandos, detalhes de requisições HTTP e contexto da sessão, conforme o protocolo. Os eventos podem ser gravados em logs locais, publicados no RabbitMQ ou enviados ao Beelzebub Platform, e as métricas do Prometheus podem ser habilitadas separadamente.

O projeto oferece serviços-isca SSH, HTTP, TCP, TELNET e MCP, com 18 configurações de exemplo que abrangem serviços como MySQL, Redis, SMB e MQTT. Pode ser executado como binário Go, com Docker Compose ou no Kubernetes usando Helm.

Recursos principais

  • 01Defina serviços-isca, rotas e respostas em YAML.
  • 02Gere respostas adaptativas com provedores de LLM ou use handlers estáticos sem um provedor.
  • 03Registre comandos, detalhes de requisições HTTP e contexto da sessão durante as interações.
  • 04Envie eventos para logs locais, RabbitMQ ou Beelzebub Platform.
  • 05Disponibilize ferramentas-isca para serviços MCP e observe invocações suspeitas de agentes.

Casos de uso

  • Estudar como atacantes sondam serviços SSH, Telnet ou semelhantes a bancos de dados em um laboratório isolado.
  • Implantar serviços-isca HTTP ou MCP para coletar evidências de requisições suspeitas ou tentativas de prompt injection.
  • Integrar eventos de interação com serviços-isca a um pipeline existente de logs ou alertas via RabbitMQ.

Início rápido

  1. 1

    Clone o repositório

    git clone https://github.com/beelzebub-labs/beelzebub.git
  2. 2

    Acesse o diretório do projeto

    cd beelzebub
  3. 3

    Execute o instalador no modo Docker

    ./install.sh --docker
  4. 4

    Teste o chamariz HTTP padrão na porta 8080

    curl -i http://localhost:8080/

Antes de usar

  • Licenciado sob a GPL-3.0, uma licença copyleft que exige que obras derivadas sejam distribuídas sob os mesmos termos.
  • O instalador inicia serviços de exemplo em portas privilegiadas; portanto, deve ser executado apenas em um host de laboratório isolado que você tenha autorização para usar.
  • Chamarizes baseados em LLM exigem um provedor configurado, e a configuração do Docker precisa do Docker Engine com Compose v2.

Em coleções

Tópicos

Perguntas frequentes

O que é beelzebub?
Framework de deception open source em Go para implantar serviços SSH, HTTP, TCP, TELNET e MCP-isca e registrar interações de atacantes como evidências. Beelzebub é um framework de deception para equipes de segurança que querem estudar atividades direcionadas a serviços-isca. Os serviços, as rotas e as regras de resposta são definidos em YAML, e cada resposta pode ser estática ou gerada por um provedor de LLM. Plugins confiáveis em Go podem ser compilados para ampliar os serviços e as respostas.
beelzebub é gratuito? Qual é a licença?
beelzebub é open source sob a licença GPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
beelzebub ainda é mantido?
Manutenção ativa. O último commit de beelzebub foi em 3 de nov. de 2026.
Para que posso usar beelzebub?
Estudar como atacantes sondam serviços SSH, Telnet ou semelhantes a bancos de dados em um laboratório isolado. Implantar serviços-isca HTTP ou MCP para coletar evidências de requisições suspeitas ou tentativas de prompt injection. Integrar eventos de interação com serviços-isca a um pipeline existente de logs ou alertas via RabbitMQ.
Como instalar beelzebub?
Clone o repositório: git clone https://github.com/beelzebub-labs/beelzebub.git Acesse o diretório do projeto: cd beelzebub Execute o instalador no modo Docker: ./install.sh --docker Teste o chamariz HTTP padrão na porta 8080: curl -i http://localhost:8080/
Onde consigo beelzebub?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/beelzebub-labs/beelzebub

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados