beelzebub — Un framework de runtime de decepción seguro y de bajo código, que aprovecha la IA para la virtualización de sistemas. | Kitploit

No interactivo: `./install.sh --local` o `./install.sh --docker`. Usa
`./install.sh --local --no-run` para instalar y compilar sin iniciar el entorno de
ejecución local. En hosts no root, la instalación local no se inicia automáticamente
cuando la configuración predeterminada incluye puertos privilegiados.

### Local (Go)```bash
make start     # installs any declared plugins, compiles them in, and runs

### `beelzebub validate`

Analiza y valida todos los archivos de configuración sin iniciar ningún servicio. Útil en pipelines de CI. Ver [Validación de Configuración](https://github.com/beelzebub-labs/beelzebub/blob/HEAD/docs/configuration-validation.md) para conocer la arquitectura de validación y la referencia de reglas.```bash
beelzebub validate --conf-core ./configurations/beelzebub.yaml --conf-services ./configurations/services/

### Escribiendo un plugin```go
package myplugin

import (
    "context"
    "github.com/beelzebub-labs/beelzebub/v3/pkg/plugin"
)

type MyPlugin struct{}

func (p *MyPlugin) Metadata() plugin.Metadata {
    return plugin.Metadata{
        Name:        "MyPlugin",
        Description: "Custom deception response generator",
        Version:     "1.0.0",
        Author:      "your-name",
    }
}

func (p *MyPlugin) Execute(_ context.Context, req plugin.CommandRequest) (string, error) {
    return "simulated response to: " + req.Command, nil
}

func init() {
    plugin.Register(&MyPlugin{})
}

| Comando | Qué hace |
|---|---|
| `plugin install <link>` | obtiene un plugin, lo integra, reconstruye; también lo añade a `configurations/plugins.yaml` |
| `plugin install` | instala todo lo declarado en `configurations/plugins.yaml` |
| `plugin list` | muestra los plugins instalados frente a lo compilado en el binario |
| `plugin update [name]` | vuelve a obtener la referencia declarada y fija de nuevo el commit |
| `plugin remove <name>` | elimina un plugin de `configurations/plugins.yaml`, lo desvincula e indica el paso de reconstrucción |

Las fuentes de plugins de despliegue se configuran en `configurations/plugins.yaml`:```yaml
plugins:
  - source: github.com/your-org/myplugin
  - source: github.com/your-org/[email protected]

Installed plugins are compiled into the Beelzebub binary and run in the same
process as the runtime. Install plugins only from repositories you trust.

## Observabilidad

### Métricas de Prometheus

Beelzebub expone métricas de Prometheus en el endpoint configurado (por defecto: `:2112/metrics`):

| Metric | Description |
|--------|-------------|
| `beelzebub_events_total` | Total de eventos de engaño en todos los servicios |
| `beelzebub_events_ssh_total` | Eventos SSH |
| `beelzebub_events_http_total` | Eventos HTTP |
| `beelzebub_events_tcp_total` | Eventos TCP |
| `beelzebub_events_telnet_total` | Eventos TELNET |
| `beelzebub_events_mcp_total` | Eventos MCP |

### Integración con RabbitMQ

Publica todos los eventos de engaño en una cola de mensajes para la integración posterior con SIEM:```yaml
core:
  tracings:
    rabbit-mq:
      enabled: true
      uri: "amqp://guest:guest@localhost:5672/"

## Calidad del Código

- **CI**: GitHub Actions en cada commit y pull request
- **Análisis estático**: CodeQL y Go Report Card
- **Cobertura**: Monitoreada mediante [Codecov](https://codecov.io/gh/beelzebub-labs/beelzebub)
- **Revisión de código**: Todas las contribuciones pasan por revisión de pares

## Licencia

Beelzebub está licenciado bajo la [Licencia GNU GPL v3](https://github.com/beelzebub-labs/beelzebub/blob/HEAD/LICENSE).

## Contribuciones

El equipo de Beelzebub da la bienvenida a contribuciones y participación en el proyecto. Ya sea que desees reportar errores, contribuir con nuevas funciones o tengas alguna pregunta, consulta nuestra [Guía para Contribuyentes](https://github.com/beelzebub-labs/beelzebub/blob/HEAD/CONTRIBUTING.md) para obtener información detallada. Animamos a todos los participantes y mantenedores a adherirse a nuestro [Código de Conducta](https://github.com/beelzebub-labs/beelzebub/blob/HEAD/CODE_OF_CONDUCT.md) y a fomentar una comunidad solidaria y respetuosa.

¡Feliz hacking!

## Referencia de Configuración

Beelzebub utiliza un sistema de configuración de dos niveles:

1. **Configuración principal** (`beelzebub.yaml`)  configuración global: logging, tracing, Prometheus
2. **Configuraciones de servicios** (`services/*.yaml`)  un archivo por servicio señuelo

### Configuración Principal```yaml
core:
  logging:
    debug: false
    debugReportCaller: false
    logDisableTimestamp: true
    logsPath: ./logs
  tracings:
    rabbit-mq:
      enabled: false
      uri: "amqp://guest:guest@localhost:5672/"
  prometheus:
    path: "/metrics"
    port: ":2112"

Accesible a través de `http://beelzebub:port/mcp` (transporte HTTP Streamable).

### Servicio de Engaño HTTP

Los servicios de engaño HTTP responden a solicitudes web con respuestas configurables basadas en la coincidencia de patrones de URL. Admite TLS, manejadores estáticos, respuestas impulsadas por LLM y el generador de laberintos infinito.

**Simulación de WordPress** (`http-80.yaml`):```yaml
apiVersion: "v1"
protocol: "http"
address: ":80"
description: "Wordpress 6.0"
commands:
  - regex: "^(/index.php|/index.html|/)$"
    handler: |
      <html><header><title>Wordpress 6 test page</title></header>
      <body><h1>Hello from Wordpress</h1></body></html>
    headers:
      - "Content-Type: text/html"
      - "Server: Apache/2.4.53 (Debian)"
      - "X-Powered-By: PHP/7.4.29"
    statusCode: 200
  - regex: "^(/wp-login.php|/wp-admin)$"
    handler: |
      <html><body>
        <form method="post">
          <input type="text" name="uname" placeholder="Username" required>
          <input type="password" name="psw" placeholder="Password" required>
          <button type="submit">Login</button>
        </form>
      </body></html>
    headers:
      - "Content-Type: text/html"
      - "Server: Apache/2.4.53 (Debian)"
    statusCode: 200
  - regex: "^.*$"
    handler: "<html><body><h1>Not found!</h1></body></html>"
    headers:
      - "Content-Type: text/html"
    statusCode: 404

**SSH potenciado por LLM** (Ollama local):```yaml
apiVersion: "v1"
protocol: "ssh"
address: ":2222"
description: "SSH Ollama Llama3"
commands:
  - regex: "^(.+)$"
    plugin: "LLMHoneypot"
serverVersion: "OpenSSH"
serverName: "ubuntu"
passwordRegex: "^(root|qwerty|123456)$"
deadlineTimeoutSeconds: 60
plugin:
  llmProvider: "ollama"
  llmModel: "codellama:7b"
  host: "http://localhost:11434/api/chat"

### Servicio de engaño TELNET

Los servicios de engaño TELNET emulan dispositivos basados en terminales (routers, switches, sistemas heredados) con un flujo de autenticación completo e integración con LLM.

**TELNET impulsado por LLM**:```yaml
apiVersion: "v1"
protocol: "telnet"
address: ":23"
description: "TELNET LLM"
commands:
  - regex: "^(.+)$"
    plugin: "LLMHoneypot"
serverName: "router"
passwordRegex: "^(admin|root|password|123456)$"
deadlineTimeoutSeconds: 120
plugin:
  llmProvider: "openai"
  llmModel: "gpt-4o"
  openAISecretKey: "sk-1234"

### Servicio de engaño TCP

Los servicios de engaño TCP cubren protocolos binarios y basados en texto: bases de datos, brokers de mensajes, servicios de directorio, acceso remoto y más. Soporta modo solo banner, coincidencia interactiva de expresiones regulares e integración con LLM.

**Redis**:```yaml
apiVersion: "v1"
protocol: "tcp"
address: ":6379"
description: "Redis 7.0.12"
commands:
  - regex: "^PING"
    handler: "+PONG\r\n"
  - regex: "^AUTH"
    handler: "-ERR Client sent AUTH, but no password is set\r\n"
  - regex: "^INFO"
    handler: "$180\r\n# Server\r\nredis_version:7.0.12\r\nos:Linux 5.15.0-76-generic x86_64\r\ntcp_port:6379\r\n\r\n"
  - regex: "^(.+)$"
    handler: "-ERR unknown command\r\n"
deadlineTimeoutSeconds: 60
serverName: "redis-prod-01"

**PostgreSQL impulsado por LLM**:```yaml
apiVersion: "v1"
protocol: "tcp"
address: ":5432"
description: "PostgreSQL 15.3"
commands:
  - regex: "^(.+)$"
    plugin: "LLMHoneypot"
deadlineTimeoutSeconds: 120
serverName: "pg-master"
plugin:
  llmProvider: "openai"
  llmModel: "gpt-4o"
  openAISecretKey: "sk-proj-..."
  prompt: "You are simulating a PostgreSQL 15.3 server. Respond to incoming TCP data as a PostgreSQL server would."

Más Populares

beelzebub

Tabla de contenidos

Características principales

Demo de engaño con LLM

Inicio rápido

Instalador```bash

Docker```bash

Referencia de CLI

`beelzebub run`

`beelzebub plugin`

Plugin System

Interfaces```go

Instalando Plugins Externos```bash

Declare plugins in configurations/plugins.yaml, or:

Pruebas```bash

Unit tests

Integration tests (requires Docker)

Validate configuration without starting services

Configuración de servicios

Servicios de engaño

Servicio de engaño MCP

Cómo funciona

Servicio de Decepción SSH

Con el apoyo de