Ir al contenido

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.

0odwiedzin

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.


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ługaTożsamość / UżytkownikPrzykładowe fikcyjne hasłoUwagi dotyczące integracji
Interfejs Wazuh (Indexer)adminzR9mK2vX5pW8qN3tY6cR4vB1Główne konto dostępu do administracji internetowej.
Wewnętrzne API Wazuhwazuh-wuimP5nT8qB2vK9wR3xY6cS4dB9.Wymagane zakończenie kropką . w celu spełnienia dyrektywy dotyczącej symboli.
Usługa komunikacyjnakibanaserveryQ3wV8xR9pK2mN6tT5sR4vC1Konto używane do komunikacji wewnętrznej między węzłami.

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):

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

Zainicjuj tymczasowy kontener generatora, aby automatycznie udostępnić infrastrukturę klucza publicznego (PKI) i podpisy cyfrowe usług:

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

3. 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:

  • 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.
  • 9200 (TCP) - OpenSearch API: Port odczytu/zapisu bazy danych indeksowania. Filebeat wprowadza tutaj alerty, a Dashboard pobiera je, aby wyświetlić je na wykresach.
  • 443 ➔ 5601 (TCP) - Portal HTTPS: Usługa wewnętrzna korzysta z portu 5601, 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.

Po ustrukturyzowaniu pliku docker-compose.yml, uruchom infrastrukturę w tle:

Ventana de terminal
sudo docker compose up -d

Ostrzeż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.