Архитектура (высокоуровневая)

Сервисы подключены к выделенной Docker-сети через bridge (по умолчанию 172.20.0.0/16). Включён контейнер атакующего для выполнения контролируемых попыток эксплуатации изолированного сервиса MindsDB.

Порты (хост → контейнер)

• 80 → nginx proxy
• 443 → nginx proxy (если включён SSL)
• 8080 → панель обратного прокси
• 47334 → MindsDB (API/web)
• 47335 → MindsDB (API/aux)
• 5432 → Postgres (внутренний, не рекомендуется открывать наружу)
• 9200 → Elasticsearch
• 5601 → Kibana
• 1025/8025 → Mailhog (SMTP/web)

По умолчанию Postgres не предназначен для доступа из публичного интернета. Файл compose сопоставляет внутренние сервисы для локального использования в лаборатории.

Быстрый старт (локально)

Предварительные требования:

• Docker (v20+) и Docker Compose v2+ (docker compose)
• Рекомендуется не менее 8 ГБ ОЗУ для полного развёртывания (Elasticsearch + Kibana требуют памяти)

1. Клонируйте репозиторий:

2. Скопируйте пример файла окружения и проверьте секреты:

Важно: Убедитесь, что DB_PASSWORD в .env совпадает с паролем, который ожидает файл compose. В docker-compose.yml есть значение по умолчанию (${DB_PASSWORD:-P@ssw0rd123!}). Либо задайте DB_PASSWORD=P@ssw0rd123! в .env, либо отредактируйте docker-compose.yml, чтобы использовать предпочитаемый вами пароль. При несовпадении MindsDB не сможет подключиться к Postgres, и сервисы не запустятся корректно.

3. (Необязательно) Отредактируйте .env для настройки поведения (включение/отключение функций, задание IP слушателя атакующего и т. д.).

4. Запустите лабораторию (полный режим):

5. После того как сервисы станут здоровыми, проверьте следующие конечные точки:

• MindsDB: curl http://localhost:47334/api/status
• Kibana: http://localhost:5601
• Панель обратного прокси: http://localhost:8080

6. Чтобы остановить и удалить контейнеры:

Чтобы удалить тома (разрушительно):

Профили и варианты ресурсов

В README упоминаются минимальный профиль и профиль мониторинга. Для их поддержки вы можете либо:

• Использовать ключи profiles: в docker-compose.yml, чтобы разделить сервисы на профили minimal и monitoring, либо
• Создать переопределяющий файл compose, например docker-compose.minimal.yml, который отключает тяжёлые компоненты (Elasticsearch/Kibana/Wazuh) для тестов с низким потреблением ресурсов.

Рекомендуемый минимальный подход к тестированию — закомментировать или пропустить Elasticsearch/Kibana/Wazuh и запустить только: mindsdb, postgres, nginx-proxy и attacker.

Как работает лаборатория (подробно)

• Обратный прокси (nginx-proxy): выступает в роли внешней конечной точки и направляет трафик атакующего к уязвимому сервису MindsDB. Прокси также предоставляет простую панель на порту 8080 для быстрых проверок.

• MindsDB (уязвимый образ): собран из уязвимого релиза, указанного в README. Хранит данные в Postgres и предоставляет конечные точки API, которые намеренно уязвимы в старых версиях.

• Postgres: хранит конфигурацию и артефакты MindsDB. Инициализационные SQL-скрипты и начальные данные предоставлены в configs/postgres/*.sql.

• ELK Stack (Elasticsearch, Logstash, Kibana): собирает логи с прокси и приложения, чтобы вы могли строить правила обнаружения и панели мониторинга.

• Wazuh (необязательно): агент и менеджер мониторинга безопасности. Включён как заглушка для демонстрации интеграции; TLS-сертификаты и учётные данные в конфигурации являются заглушками и должны быть подготовлены для полной функциональности.

• Контейнер атакующего: среда с утилитами (curl, netcat, python) и смонтированной папкой exploits/ для запуска скриптов заданий внутри той же Docker-сети (при желании изолированной от сети вашего хоста).

• Сервис резервного копирования: пример контейнера для демонстрации реалистичных корпоративных рабочих процессов (резервное копирование дампов БД из Postgres).

Как использовать лабораторию (практический процесс)

1. Запустите лабораторию (см. Быстрый старт).
2. С вашего хоста или войдя в контейнер атакующего (docker compose exec -it attacker /bin/bash), выполните разведку против прокси (порт 80/8080) и API MindsDB (47334).
3. Проходите уровни обучения (разведка → path traversal → RCE → закрепление → защита). Этот репозиторий намеренно не включает готовый эксплойт-код. Если вам нужны скрипты заданий или санитизированные шаги PoC, мы можем добавить их в exploits/ и docs/challenges/ с руководствами и безопасными проверками.
4. Наблюдайте за логами в ELK и используйте включённое правило Sigma (rules/sigma/cve-2026-27483.yml) как отправную точку для обнаружений. Создайте визуализации в Kibana для выделения подозрительных путей загрузки, аномальных запросов и неожиданной активности файловой системы.

Пример: выполните базовую разведку из контейнера атакующего

Смоук-тесты

Скрипт смоук-теста предоставлен в scripts/smoke_test.sh (если присутствует). Он выполняет следующие проверки:

• Собирает и запускает стек compose
• Ожидает ответа от MindsDB /api/status
• Проверяет, что обратный прокси nginx отвечает на порту 8080
• Проверяет конечную точку статуса Kibana
• Ожидает здорового состояния кластера Elasticsearch (yellow|green)
• Проверяет готовность Postgres с помощью pg_isready

Запустите его локально:

Если смоук-тест завершится неудачей, соберите логи в smoke_compose_logs.txt и поделитесь ими для отладки:

Обнаружение и логирование

• Конвейер Logstash предоставлен в configs/logstash/logstash.conf для пересылки логов в Elasticsearch. Включённое правило Sigma rules/sigma/cve-2026-27483.yml — это простой пример, который помечает подозрительные паттерны path traversal (запросы, содержащие ..). Используйте его как отправную точку и дорабатывайте для снижения ложных срабатываний.

• Создайте панели Kibana для визуализации:

  • URI загрузок/запросов, содержащих паттерны обхода
  • Аномальные user agents и исходные IP-адреса
  • Изменения в логах, связанных с файловой системой

Устранение неполадок (частые проблемы)

• Ошибки аутентификации Postgres: обычно это связано с несовпадением пароля БД между .env и docker-compose.yml. Убедитесь, что оба файла используют один и тот же секрет.
• Ошибки MindsDB/500: проверьте docker compose logs -f mindsdb на наличие стектрейсов и ошибок подключения к БД.
• Elasticsearch OOM или не запускается: увеличьте ОЗУ хоста или уменьшите ES_JAVA_OPTS в docker-compose.yml (пример: -Xms256m -Xmx256m) для маломощных хостов.
• Сбой healthcheck nginx: убедитесь, что конфигурация прокси указывает на правильный внутренний хост (mindsdb:47334) и что контейнер mindsdb здоров.

Если вам нужна помощь с отладкой, запустите смоук-тест и поделитесь smoke_compose_logs.txt.

Безопасность и законность

• Лаборатория включает намеренно уязвимые компоненты. Используйте только в изолированных, непроизводственных средах.
• Не разворачивайте эту лабораторию на публично маршрутизируемой инфраструктуре.
• Не включайте эксплойт-код в публичные коммиты; если вы добавляете шаги PoC, санитизируйте их и следуйте практике ответственного раскрытия уязвимостей.

Участие в разработке

Приветствуются любые вклады. Предлагаемые способы помощи:

• Улучшение документации в docs/ (развёртывание, задания, обнаружение, реагирование на инциденты)
• Добавление санитизированных скриптов заданий в exploits/ с пошаговыми учебными руководствами
• Добавление смоук-тестов и CI-процессов для проверки лаборатории при push/PR

Пожалуйста, открывайте PR против ветки main и следуйте рекомендациям CONTRIBUTING при добавлении учебных материалов по эксплуатации.

Благодарности

• Обнаружение уязвимости: XlabAITeam
• Оригинальный PoC: Lohitya Pushkar (thewhiteh4t)
• Разработка лаборатории: Security Research Community

Сделано с ❤️ для сообщества специалистов по безопасности.