Ir al contenido

Wazuh-Architektur und Deployment mit Docker Compose

Leitfaden für das modulare Deployment von Wazuh 4.9 in Docker-Containern, Zuweisung komplexer alphanumerischer Anmeldedaten und Sicherheits-Port-Routing-Map.

0Lesungen

Dieser Leitfaden beschreibt das standardmäßige technische Verfahren für die Bereitstellung von Wazuh 4.9 in einer Docker-Umgebung mit einem einzigen Knoten (single-node). Dieser Modul behandelt die Ressourcenplanung, die Vorbereitung der Host-Umgebung, die Strukturierung der Datei docker-compose.yml und die Architektur der Sicherheitsnetzwerk-Routing.


1. Planung von Anmeldeinformationen und Härtung

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

Um Parsing-Fehler während der Container-Initialisierung durch die Docker-Engine zu vermeiden (wie z. B. die fehlerhafte Interpretation von Sonderzeichen wie $ oder * in YAML-Dateien) und um die Sicherheitsrichtlinien von Wazuh strikt einzuhalten, wurde eine Matrix aus hoch-entropischen alphanumerischen Anmeldedaten für die Hauptdienste definiert:

Komponente / DienstIdentität / BenutzerFiktives BeispielpasswortIntegrationshinweise
Wazuh-Schnittstelle (Indexer)adminzR9mK2vX5pW8qN3tY6cR4vB1Hauptzugangskonto für die Webverwaltung.
Wazuh-interne APIwazuh-wuimP5nT8qB2vK9wR3xY6cS4dB9.Es ist zwingend erforderlich, mit einem Punkt . zu enden, um der Symbolrichtlinie zu entsprechen.
KommunikationsdienstkibanaserveryQ3wV8xR9pK2mN6tT5sR4vC1Konto, das für die interne Kommunikation zwischen Knoten verwendet wird.

2. Bereitstellung der Umgebung auf dem Host (Ubuntu)

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

Das vollständige Deployment wird unter dem Host-Verzeichnis konsolidiert: /opt/wazuh-stack/single-node.

A. Klonen des offiziellen Repository-Zweigs

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

Wazuh benötigt SSL/TLS-Zertifikate, um die Kommunikation zwischen seinen drei Hauptcontainern (Indexer, Manager und Dashboard) Ende-zu-Ende zu verschlüsseln. Greifen Sie auf Ihre Host-Konsole zu und klonen Sie die exakte zertifizierte Version (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. Generierung der Zertifizierungsstelle und TLS-Zertifikate

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

Initialisieren Sie den temporären Generator-Container, um die Public-Key-Infrastruktur (PKI) und die digitalen Signaturen der Dienste automatisch bereitzustellen:

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

Diese Datei enthält die endgültige Deklaration der Dienste, optimierte Kernel-Speichergrenzen und die anfänglichen statischen Anmeldeinformationen der Umgebung.

Dateipfad: /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:

Um den Analysten des Blue Teams eine korrekte Konfiguration der Perimeter-Filterregeln (wie pfSense-Firewalls oder Host-Richtlinien) zu ermöglichen, wird die technische Funktion der gemappten Ports wie folgt erläutert:

  • 1514 (TCP/UDP) - Agents: Kritischer Kommunikationsport. Remote-Collector-Agents senden hier ihre entschlüsselten Logs und Metadaten in Echtzeit.
  • 1515 (TCP) - Authd: Port des Agent-Registrierungsdienstes. Er wird ausschließlich beim Pairing eines neuen Knotens verwendet, um den symmetrischen Verschlüsselungsschlüssel zu generieren und zu übertragen.
  • 514 (UDP) - Syslog: Optionaler Dienst zur Sammlung von Netzwerk-Logs von Geräten, die keine nativen Agenten unterstützen (wie Router, pfSense-Firewalls und Switches).
  • 55000 (TCP) - REST-API: Steuerungsschnittstelle des Managers. Sie wird vom Dashboard verwendet, um interne Verwaltungsanfragen zu verarbeiten.
  • 9200 (TCP) - OpenSearch API: Lese-/Schreibport der Indexierungsdatenbank. Filebeat speist die Alarme hier ein, und das Dashboard ruft sie ab, um sie in den Diagrammen anzuzeigen.
  • 443 ➔ 5601 (TCP) - HTTPS-Portal: Der interne Dienst nutzt den Port 5601, wird jedoch in Docker auf den Standardport 443 (HTTPS) auf dem Host gemappt, um einen sauberen und direkten Zugriff über den Browser ohne die Angabe ungewöhnlicher Ports zu ermöglichen.

Sobald die Datei docker-compose.yml strukturiert ist, wird die Infrastruktur im Hintergrund hochgefahren:

Ventana de terminal
sudo docker compose up -d

Sicherheitswarnung

Auch wenn die Container in der Docker-Engine korrekt initialisiert werden, wird die Suite weder funktionsfähig noch sicher sein, bis die im folgenden Dokument detaillierten verschlüsselten Hashes generiert und injiziert wurden.