Ir al contenido

Архитектура Wazuh и развертывание с помощью Docker Compose

Руководство по модульному развертыванию Wazuh 4.9 в контейнерах Docker, назначению сложных буквенно-цифровых учетных данных и карте маршрутизации портов безопасности.

0просмотры

Это руководство описывает стандартную техническую процедуру развертывания Wazuh 4.9 в одноузловой Docker-среде (single-node). Этот модуль охватывает планирование ресурсов, подготовку среды хоста, структурирование файла docker-compose.yml и архитектуру маршрутизации сетевой безопасности.


1. Планирование учетных данных и укрепление защиты

Sección titulada «1. Planificación de Credenciales y Endurecimiento»

Чтобы избежать ошибок парсинга во время инициализации контейнеров движком Docker (таких как неправильная интерпретация специальных символов, например $ или *, в YAML-файлах) и строго соблюдать директивы безопасности Wazuh, была определена матрица буквенно-цифровых учетных данных с высокой энтропией для основных служб:

Компонент / СервисИдентификатор / ПользовательПример фиктивного пароляПримечания по интеграции
Интерфейс Wazuh (Indexer)adminzR9mK2vX5pW8qN3tY6cR4vB1Основная учетная запись для веб-администрирования.
Внутренний API Wazuhwazuh-wuimP5nT8qB2vK9wR3xY6cS4dB9.Обязательно завершать точкой . для соблюдения политики символов.
Коммуникационный сервисkibanaserveryQ3wV8xR9pK2mN6tT5sR4vC1Учетная запись, используемая для внутреннего взаимодействия между узлами.

2. Подготовка окружения на хосте (Ubuntu)

Sección titulada «2. Aprovisionamiento del Entorno en el Host (Ubuntu)»

Полное развертывание будет размещено в директории хоста: /opt/wazuh-stack/single-node.

A. Клонирование ветки официального репозитория

Sección titulada «A. Clonar la Rama del Repositorio Oficial»

Wazuh требует сертификаты SSL/TLS для сквозного шифрования трафика между тремя основными контейнерами (Indexer, Manager и Dashboard). Зайдите в консоль хоста и клонируйте именно ту версию, которая сертифицирована (v4.9.0):

Ventana de terminal
# 1. Crear el directorio y clonar el repositorio oficial de despliegue
sudo mkdir -p /opt/wazuh-stack
sudo chown -R $USER:$USER /opt/wazuh-stack
git clone https://github.com/wazuh/wazuh-docker.git -b v4.9.0 /opt/wazuh-stack
# 2. Posicionarse en el directorio del nodo único
cd /opt/wazuh-stack/single-node

B. Генерация удостоверяющего центра и TLS-сертификатов

Sección titulada «B. Generación de la Autoridad de Certificación y Certificados TLS»

Инициализируйте временный контейнер-генератор для автоматической подготовки инфраструктуры открытых ключей (PKI) и цифровых подписей сервисов:

Ventana de terminal
sudo docker compose -f generate-indexer-certs.yml run --rm generator

3. Файл Docker Compose для продакшена

Sección titulada «3. Archivo Docker Compose de Producción»

Этот файл содержит окончательное описание сервисов, оптимизированные лимиты памяти ядра и начальные статические учетные данные окружения.

Путь к файлу: /opt/wazuh-stack/single-node/docker-compose.yml

# Wazuh App Copyright (C) 2017, Wazuh Inc. (License GPLv2)
services:
wazuh.manager:
image: wazuh/wazuh-manager:4.9.0
hostname: wazuh.manager
restart: always
ports:
- "1514:1514"
- "1515:1515"
- "514:514/udp"
- "55000:55000"
ulimits:
memlock:
soft: -1
hard: -1
nofile:
soft: 655360
hard: 655360
environment:
- INDEXER_URL=https://wazuh.indexer:9200
- INDEXER_USERNAME=admin
- INDEXER_PASSWORD=zR9mK2vX5pW8qN3tY6cR4vB1
- FILEBEAT_SSL_VERIFICATION_MODE=full
- SSL_CERTIFICATE_AUTHORITIES=/etc/ssl/root-ca.pem
- SSL_CERTIFICATE=/etc/ssl/filebeat.pem
- SSL_KEY=/etc/ssl/filebeat.key
- API_USERNAME=wazuh-wui
- API_PASSWORD=mP5nT8qB2vK9wR3xY6cS4dB9.
- TZ=Europe/Madrid
volumes:
- wazuh_api_configuration:/var/ossec/api/configuration
- wazuh_etc:/var/ossec/etc
- wazuh_logs:/var/ossec/logs
- wazuh_queue:/var/ossec/queue
- wazuh_var_multigroups:/var/ossec/var/multigroups
- wazuh_integrations:/var/ossec/integrations
- wazuh_active_response:/var/ossec/active-response/bin
- wazuh_agentless:/var/ossec/agentless
- wazuh_wodles:/var/ossec/wodles
- filebeat_etc:/etc/filebeat
- filebeat_var:/var/lib/filebeat
- ./config/wazuh_indexer_ssl_certs/root-ca-manager.pem:/etc/ssl/root-ca.pem
- ./config/wazuh_indexer_ssl_certs/wazuh.manager.pem:/etc/ssl/filebeat.pem
- ./config/wazuh_indexer_ssl_certs/wazuh.manager-key.pem:/etc/ssl/filebeat.key
- ./config/wazuh_cluster/wazuh_manager.conf:/wazuh-config-mount/etc/ossec.conf
wazuh.indexer:
image: wazuh/wazuh-indexer:4.9.0
hostname: wazuh.indexer
restart: always
ports:
- "9200:9200"
environment:
- "OPENSEARCH_JAVA_OPTS=-Xms1g -Xmx1g"
- TZ=Europe/Madrid
ulimits:
memlock:
soft: -1
hard: -1
nofile:
soft: 65536
hard: 65536
volumes:
- wazuh-indexer-data:/var/lib/wazuh-indexer
- ./config/wazuh_indexer_ssl_certs/root-ca.pem:/usr/share/wazuh-indexer/certs/root-ca.pem
- ./config/wazuh_indexer_ssl_certs/wazuh.indexer-key.pem:/usr/share/wazuh-indexer/certs/wazuh.indexer.key
- ./config/wazuh_indexer_ssl_certs/wazuh.indexer.pem:/usr/share/wazuh-indexer/certs/wazuh.indexer.pem
- ./config/wazuh_indexer_ssl_certs/admin.pem:/usr/share/wazuh-indexer/certs/admin.pem
- ./config/wazuh_indexer_ssl_certs/admin-key.pem:/usr/share/wazuh-indexer/certs/admin-key.pem
- ./config/wazuh_indexer/wazuh.indexer.yml:/usr/share/wazuh-indexer/opensearch.yml
- ./config/wazuh_indexer/internal_users.yml:/usr/share/wazuh-indexer/opensearch-security/internal_users.yml
wazuh.dashboard:
image: wazuh/wazuh-dashboard:4.9.0
hostname: wazuh.dashboard
restart: always
ports:
- "443:5601"
environment:
- INDEXER_USERNAME=admin
- INDEXER_PASSWORD=zR9mK2vX5pW8qN3tY6cR4vB1
- WAZUH_API_URL=https://wazuh.manager
- DASHBOARD_USERNAME=kibanaserver
- DASHBOARD_PASSWORD=yQ3wV8xR9pK2mN6tT5sR4vC1
- API_USERNAME=wazuh-wui
- API_PASSWORD=mP5nT8qB2vK9wR3xY6cS4dB9.
- TZ=Europe/Madrid
volumes:
- ./config/wazuh_indexer_ssl_certs/wazuh.dashboard.pem:/usr/share/wazuh-dashboard/certs/wazuh-dashboard.pem
- ./config/wazuh_indexer_ssl_certs/wazuh.dashboard-key.pem:/usr/share/wazuh-dashboard/certs/wazuh-dashboard-key.pem
- ./config/wazuh_indexer_ssl_certs/root-ca.pem:/usr/share/wazuh-dashboard/certs/root-ca.pem
- ./config/wazuh_dashboard/opensearch_dashboards.yml:/usr/share/wazuh-dashboard/config/opensearch_dashboards.yml
- ./config/wazuh_dashboard/wazuh.yml:/usr/share/wazuh-dashboard/data/wazuh/config/wazuh.yml
- wazuh-dashboard-config:/usr/share/wazuh-dashboard/data/wazuh/config
- wazuh-dashboard-custom:/usr/share/wazuh-dashboard/plugins/wazuh/public/assets/custom
depends_on:
- wazuh.indexer
links:
- wazuh.indexer:wazuh.indexer
- wazuh.manager:wazuh.manager
networks:
default:
name: wazuh_local
volumes:
wazuh_api_configuration:
wazuh_etc:
wazuh_logs:
wazuh_queue:
wazuh_var_multigroups:
wazuh_integrations:
wazuh_active_response:
wazuh_agentless:
wazuh_wodles:
filebeat_etc:
filebeat_var:
wazuh-indexer-data:
wazuh-dashboard-config:
wazuh-dashboard-custom:

4. Карта маршрутизации портов (Сеть безопасности)

Sección titulada «4. Mapa de Enrutamiento de Puertos (Red de Seguridad)»

Чтобы аналитики Blue Team могли правильно настроить правила фильтрации периметра (такие как межсетевые экраны pfSense или политики хоста), ниже приведено техническое описание назначений проброшенных портов:

A. Контейнер: wazuh.manager (Центр анализа)

Sección titulada «A. Contenedor: wazuh.manager (Cerebro de Análisis)»
  • 1514 (TCP/UDP) - Агенты: Критический коммуникационный порт. Удаленные агенты-сборщики отправляют сюда свои расшифрованные логи и метаданные в режиме реального времени.
  • 1515 (TCP) - Authd: Порт службы регистрации агентов. Используется исключительно при сопряжении нового узла для генерации и передачи симметричного ключа шифрования.
  • 514 (UDP) - Syslog: Опциональная служба для сбора сетевых логов с устройств, не поддерживающих нативных агентов (таких как роутеры, межсетевые экраны pfSense и коммутаторы).
  • 55000 (TCP) - REST API: Интерфейс управления Manager. Используется Dashboard для обработки внутренних административных запросов.

B. Контейнер: wazuh.indexer (Хранилище)

Sección titulada «B. Contenedor: wazuh.indexer (Almacenamiento)»
  • 9200 (TCP) - OpenSearch API: Порт чтения/записи базы данных индексации. Filebeat передает сюда оповещения, а Dashboard извлекает их для отображения на графиках.

C. Контейнер: wazuh.dashboard (Веб-консоль)

Sección titulada «C. Contenedor: wazuh.dashboard (Consola Web)»
  • 443 ➔ 5601 (TCP) - HTTPS-портал: Внутренняя служба использует порт 5601, но в Docker он пробрасывается на стандартный порт 443 (HTTPS) хоста, чтобы обеспечить чистый и прямой доступ из браузера без указания нестандартных портов.

5. Инициализация контейнеров

Sección titulada «5. Inicialización de Contenedores»

После того как файл docker-compose.yml будет структурирован, запустите инфраструктуру в фоновом режиме:

Ventana de terminal
sudo docker compose up -d

Предупреждение о безопасности

Даже если контейнеры успешно инициализируются в движке Docker, пакет не будет функциональным или безопасным до тех пор, пока не будут созданы и внедрены зашифрованные хеши, подробно описанные в следующем документе.