Architektura Wazuh i wdrożenie przy użyciu Docker Compose
Przewodnik po modularnym wdrażaniu Wazuh 4.9 w kontenerach Docker, przydzielaniu złożonych alfanumerycznych danych uwierzytelniających oraz mapowaniu routingu portów bezpieczeństwa.
Niniejszy przewodnik szczegółowo opisuje standardową procedurę techniczną wdrażania Wazuh 4.9 w jednonodowym środowisku Docker (single-node). Moduł ten obejmuje planowanie zasobów, przygotowanie środowiska hosta, strukturyzację pliku docker-compose.yml oraz architekturę routingu sieci bezpieczeństwa.
1. Planowanie poświadczeń i zabezpieczeń
Sección titulada «1. Planificación de Credenciales y Endurecimiento»Aby uniknąć błędów parsowania podczas inicjalizacji kontenerów przez silnik Docker (takich jak błędna interpretacja znaków specjalnych, takich jak $ lub * w plikach YAML) i ściśle przestrzegać wytycznych bezpieczeństwa Wazuh, zdefiniowano macierz alfanumerycznych danych uwierzytelniających o wysokiej entropii dla głównych usług:
| Komponent / Usługa | Tożsamość / Użytkownik | Przykładowe fikcyjne hasło | Uwagi dotyczące integracji |
|---|---|---|---|
| Interfejs Wazuh (Indexer) | admin | zR9mK2vX5pW8qN3tY6cR4vB1 | Główne konto dostępu do administracji internetowej. |
| Wewnętrzne API Wazuh | wazuh-wui | mP5nT8qB2vK9wR3xY6cS4dB9. | Wymagane zakończenie kropką . w celu spełnienia dyrektywy dotyczącej symboli. |
| Usługa komunikacyjna | kibanaserver | yQ3wV8xR9pK2mN6tT5sR4vC1 | Konto używane do komunikacji wewnętrznej między węzłami. |
2. Przygotowanie środowiska na hoście (Ubuntu)
Sección titulada «2. Aprovisionamiento del Entorno en el Host (Ubuntu)»Pełne wdrożenie zostanie skonsolidowane w katalogu hosta: /opt/wazuh-stack/single-node.
A. Klonowanie gałęzi oficjalnego repozytorium
Sección titulada «A. Clonar la Rama del Repositorio Oficial»Wazuh wymaga certyfikatów SSL/TLS do szyfrowania end-to-end komunikacji między jego trzema głównymi kontenerami (Indexer, Manager i Dashboard). Zaloguj się do konsoli hosta i sklonuj dokładnie certyfikowaną wersję (v4.9.0):
# 1. Crear el directorio y clonar el repositorio oficial de desplieguesudo mkdir -p /opt/wazuh-stacksudo chown -R $USER:$USER /opt/wazuh-stackgit clone https://github.com/wazuh/wazuh-docker.git -b v4.9.0 /opt/wazuh-stack
# 2. Posicionarse en el directorio del nodo únicocd /opt/wazuh-stack/single-nodeB. Generowanie urzędu certyfikacji i certyfikatów TLS
Sección titulada «B. Generación de la Autoridad de Certificación y Certificados TLS»Zainicjuj tymczasowy kontener generatora, aby automatycznie udostępnić infrastrukturę klucza publicznego (PKI) i podpisy cyfrowe usług:
sudo docker compose -f generate-indexer-certs.yml run --rm generator3. Plik Docker Compose dla środowiska produkcyjnego
Sección titulada «3. Archivo Docker Compose de Producción»Ten plik zawiera ostateczną deklarację usług, zoptymalizowane limity pamięci jądra oraz początkowe statyczne poświadczenia środowiska.
Ścieżka pliku: /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. Mapa przekierowania portów (Sieć bezpieczeństwa)
Sección titulada «4. Mapa de Enrutamiento de Puertos (Red de Seguridad)»Aby umożliwić analitykom Blue Team prawidłową konfigurację reguł filtrowania brzegowego (takich jak zapory sieciowe pfSense lub polityki hosta), poniżej wyszczególniono techniczną funkcję zmapowanych portów:
A. Kontener: wazuh.manager (Mózg analityczny)
Sección titulada «A. Contenedor: wazuh.manager (Cerebro de Análisis)»1514(TCP/UDP) - Agenci: Krytyczny port komunikacyjny. Zdalni agenci zbierający dane przesyłają tą drogą odszyfrowane logi i metadane w czasie rzeczywistym.1515(TCP) - Authd: Port usługi rejestracji agentów. Jest używany wyłącznie podczas parowania nowego węzła w celu wygenerowania i przesłania symetrycznego klucza szyfrującego.514(UDP) - Syslog: Opcjonalna usługa zbierania logów sieciowych z urządzeń nieobsługujących natywnych agentów (takich jak routery, zapory sieciowe pfSense i przełączniki).55000(TCP) - API REST: Interfejs kontrolny Managera. Jest on wykorzystywany przez Dashboard do przetwarzania zapytań administracyjnych wewnętrznych.
B. Kontener: wazuh.indexer (Przechowywanie)
Sección titulada «B. Contenedor: wazuh.indexer (Almacenamiento)»9200(TCP) - OpenSearch API: Port odczytu/zapisu bazy danych indeksowania. Filebeat wprowadza tutaj alerty, a Dashboard pobiera je, aby wyświetlić je na wykresach.
C. Kontener: wazuh.dashboard (Konsola Web)
Sección titulada «C. Contenedor: wazuh.dashboard (Consola Web)»443 ➔ 5601(TCP) - Portal HTTPS: Usługa wewnętrzna korzysta z portu5601, ale w Dockerze jest on mapowany na standardowy port 443 (HTTPS) na hoście, aby umożliwić czysty i bezpośredni dostęp z przeglądarki bez konieczności określania niestandardowych portów.
5. Inicjalizacja kontenerów
Sección titulada «5. Inicialización de Contenedores»Po ustrukturyzowaniu pliku docker-compose.yml, uruchom infrastrukturę w tle:
sudo docker compose up -dOstrzeżenie o bezpieczeństwie
Mimo że kontenery zainicjują się poprawnie w silniku Docker, pakiet nie będzie funkcjonalny ani bezpieczny, dopóki nie zostaną wygenerowane i wstrzyknięte zaszyfrowane hashe szczegółowo opisane w następującym dokumencie.

