beelzebub — Безопасный low-code фреймворк времени выполнения для deception, использующий ИИ для виртуализации систем. | Kitploit

Неинтерактивный режим: `./install.sh --local` или `./install.sh --docker`. Используйте
`./install.sh --local --no-run` для установки и сборки без запуска локальной
среды выполнения. На хостах без прав root локальная установка не запускается автоматически, если
конфигурация по умолчанию включает привилегированные порты.

### Локальная установка (Go)```bash
make start     # installs any declared plugins, compiles them in, and runs

### `beelzebub validate`

Анализирует и проверяет все файлы конфигурации без запуска каких-либо сервисов. Полезно в CI-пайплайнах. См. [Проверка конфигурации](https://github.com/beelzebub-labs/beelzebub/blob/HEAD/docs/configuration-validation.md) для описания архитектуры проверки и справочника правил.```bash
beelzebub validate --conf-core ./configurations/beelzebub.yaml --conf-services ./configurations/services/

### Написание плагина```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{})
}

| Command | Что делает |
|---|---|
| `plugin install <link>` | получает плагин, подключает его и пересобирает; также добавляет его в `configurations/plugins.yaml` |
| `plugin install` | устанавливает всё, что объявлено в `configurations/plugins.yaml` |
| `plugin list` | показывает установленные плагины и то, что скомпилировано в бинарный файл |
| `plugin update [name]` | повторно получает по указанному ref и заново фиксирует коммит |
| `plugin remove <name>` | удаляет плагин из `configurations/plugins.yaml`, отключает его и выводит шаг пересборки |

Источники плагинов развёртывания настраиваются в `configurations/plugins.yaml`:```yaml
plugins:
  - source: github.com/your-org/myplugin
  - source: github.com/your-org/[email protected]

Установленные плагины компилируются в бинарный файл Beelzebub и выполняются в том же
процессе, что и среда выполнения. Устанавливайте плагины только из репозиториев, которым вы доверяете.

## Наблюдаемость

### Метрики Prometheus

Beelzebub предоставляет метрики Prometheus на настроенной конечной точке (по умолчанию: `:2112/metrics`):

| Метрика | Описание |
|--------|-------------|
| `beelzebub_events_total` | Всего событий обмана во всех сервисах |
| `beelzebub_events_ssh_total` | События SSH |
| `beelzebub_events_http_total` | События HTTP |
| `beelzebub_events_tcp_total` | События TCP |
| `beelzebub_events_telnet_total` | События TELNET |
| `beelzebub_events_mcp_total` | События MCP |

### Интеграция с RabbitMQ

Публикуйте все события обмана в очередь сообщений для последующей интеграции с SIEM:```yaml
core:
  tracings:
    rabbit-mq:
      enabled: true
      uri: "amqp://guest:guest@localhost:5672/"

## Качество кода

- **CI**: GitHub Actions при каждом коммите и pull request
- **Статический анализ**: CodeQL и Go Report Card
- **Покрытие**: отслеживается через [Codecov](https://codecov.io/gh/beelzebub-labs/beelzebub)
- **Ревью кода**: все вклады проходят рецензирование

## Лицензия

Beelzebub распространяется под [лицензией GNU GPL v3](https://github.com/beelzebub-labs/beelzebub/blob/HEAD/LICENSE).

## Вклад в проект

Команда Beelzebub приветствует вклад и участие в проекте. Если вы хотите сообщить об ошибках, добавить новые функции или задать вопросы, пожалуйста, обратитесь к нашему [Руководству для участников](https://github.com/beelzebub-labs/beelzebub/blob/HEAD/CONTRIBUTING.md) за подробной информацией. Мы призываем всех участников и мейнтейнеров соблюдать наш [Кодекс поведения](https://github.com/beelzebub-labs/beelzebub/blob/HEAD/CODE_OF_CONDUCT.md) и развивать дружелюбное и уважительное сообщество.

Удачного хакерства!

## Справочник по конфигурации

Beelzebub использует двухуровневую систему конфигурации:

1. **Основная конфигурация** (`beelzebub.yaml`)  глобальные настройки: логирование, трассировка, Prometheus
2. **Конфигурации сервисов** (`services/*.yaml`)  один файл на каждый сервис-приманку

### Основная конфигурация```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"

Доступно через `http://beelzebub:port/mcp` (транспорт Streamable HTTP).

### HTTP-сервис обмана

HTTP-сервисы обмана отвечают на веб-запросы настраиваемыми ответами на основе сопоставления с шаблонами URL. Поддерживают TLS, статические обработчики, ответы на основе LLM и генератор бесконечного лабиринта.

**Имитация 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 на базе LLM** (локальный Ollama):```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"

### Сервис обмана TELNET

Сервисы обмана TELNET эмулируют терминальные устройства (маршрутизаторы, коммутаторы, устаревшие системы) с полным процессом аутентификации и интеграцией LLM.

**TELNET на базе 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"

### Сервис обмана TCP

Сервисы обмана TCP охватывают бинарные и текстовые протоколы: базы данных, брокеры сообщений, службы каталогов, удалённый доступ и многое другое. Поддерживаются режим только с баннером, интерактивное сопоставление по регулярным выражениям и интеграция с 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 на основе 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."

Популярное

beelzebub

Оглавление

Ключевые возможности

Демо обмана с LLM

Быстрый старт

Установщик```bash

Docker```bash

Справочник по CLI

`beelzebub run`

`beelzebub plugin`

Система плагинов

Интерфейсы```go

Установка внешних плагинов```bash

Declare plugins in configurations/plugins.yaml, or:

Тестирование```bash

Unit tests

Integration tests (requires Docker)

Validate configuration without starting services

Конфигурация сервисов

Сервисы обмана

MCP-сервис обмана

Как это работает

SSH Deception Service

При поддержке