Wazuh-architectuur en implementatie met Docker Compose
Modulaire gids voor de uitrol van Wazuh 4.9 in Docker-containers, toewijzing van complexe alfanumerieke inloggegevens en een routekaart voor beveiligingspoorten.
Deze gids beschrijft de standaard technische procedure voor de uitrol van Wazuh 4.9 in een single-node Docker-omgeving (single-node). Deze module behandelt de resourceplanning, de voorbereiding van de hostomgeving, de structuur van het docker-compose.yml-bestand en de beveiligingsnetwerkroutingarchitectuur.
1. Planning van inloggegevens en hardening
Sección titulada «1. Planificación de Credenciales y Endurecimiento»Om parseerfouten tijdens de initialisatie van de containers door de Docker-engine te voorkomen (zoals de onjuiste interpretatie van speciale tekens zoals $ of * in YAML-bestanden) en om strikt te voldoen aan de beveiligingsrichtlijnen van Wazuh, is er een matrix van alfanumerieke inloggegevens met een hoge entropie gedefinieerd voor de belangrijkste services:
| Component / Service | Identiteit / Gebruiker | Fictief voorbeeldwachtwoord | Integratienotities |
|---|---|---|---|
| Wazuh-interface (Indexer) | admin | zR9mK2vX5pW8qN3tY6cR4vB1 | Hoofdtoegangsaccount voor webbeheer. |
| Wazuh interne API | wazuh-wui | mP5nT8qB2vK9wR3xY6cS4dB9. | Het is verplicht om af te sluiten met een punt . om te voldoen aan de symboolrichtlijn. |
| Communicatiedienst | kibanaserver | yQ3wV8xR9pK2mN6tT5sR4vC1 | Account gebruikt voor interne communicatie tussen knooppunten. |
2. Inrichting van de omgeving op de host (Ubuntu)
Sección titulada «2. Aprovisionamiento del Entorno en el Host (Ubuntu)»De volledige uitrol wordt geconsolideerd onder de hostdirectory: /opt/wazuh-stack/single-node.
A. De branch van de officiële repository klonen
Sección titulada «A. Clonar la Rama del Repositorio Oficial»Wazuh vereist SSL/TLS-certificaten om de communicatie tussen de drie belangrijkste containers (Indexer, Manager en Dashboard) end-to-end te versleutelen. Ga naar je hostconsole en clone de exacte gecertificeerde versie (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. Genereren van de certificeringsautoriteit en TLS-certificaten
Sección titulada «B. Generación de la Autoridad de Certificación y Certificados TLS»Initialiseer de tijdelijke generatorcontainer om automatisch de public key infrastructure (PKI) en de digitale handtekeningen van de services in te richten:
sudo docker compose -f generate-indexer-certs.yml run --rm generator3. Docker Compose-bestand voor productie
Sección titulada «3. Archivo Docker Compose de Producción»Dit bestand bevat de definitieve servicedeclaratie, geoptimaliseerde kernelgeheugenlimieten en de initiële statische inloggegevens van de omgeving.
Bestandspad: /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. Poortrouteringskaart (Beveiligingsnetwerk)
Sección titulada «4. Mapa de Enrutamiento de Puertos (Red de Seguridad)»Om Blue Team-analisten in staat te stellen de perimeter-filterregels (zoals pfSense-firewalls of host-policies) correct te configureren, wordt de technische functie van de gemapte poorten hieronder toegelicht:
A. Container: wazuh.manager (Analyse-brein)
Sección titulada «A. Contenedor: wazuh.manager (Cerebro de Análisis)»1514(TCP/UDP) - Agenten: Kritieke communicatiepoort. De externe verzamelende agenten sturen hier hun ontcijferde logs en metadata in realtime naartoe.1515(TCP) - Authd: Poort voor de agentregistratiedienst. Deze wordt uitsluitend gebruikt bij het koppelen van een nieuwe node om de symmetrische encryptiesleutel te genereren en te verzenden.514(UDP) - Syslog: Optionele service voor het verzamelen van netwerklogs van apparaten die geen native agenten ondersteunen (zoals routers, pfSense-firewalls en switches).55000(TCP) - REST API: Controle-interface van de Manager. Deze wordt door het Dashboard gebruikt voor het verwerken van interne administratieve queries.
B. Container: wazuh.indexer (Opslag)
Sección titulada «B. Contenedor: wazuh.indexer (Almacenamiento)»9200(TCP) - OpenSearch API: Lees/schrijfpoort voor de indexeringsdatabase. Filebeat voert hier de alerts in en het Dashboard haalt ze op om ze in de grafieken weer te geven.
C. Container: wazuh.dashboard (Webconsole)
Sección titulada «C. Contenedor: wazuh.dashboard (Consola Web)»443 ➔ 5601(TCP) - HTTPS-portaal: De interne service gebruikt poort5601, maar wordt in Docker gemapt naar de standaardpoort 443 (HTTPS) op de host om eenvoudige en directe toegang via de browser mogelijk te maken zonder atypische poorten te hoeven specificeren.
5. Initialisatie van Containers
Sección titulada «5. Inicialización de Contenedores»Zodra het bestand docker-compose.yml is gestructureerd, wordt de infrastructuur op de achtergrond opgestart:
sudo docker compose up -dBeveiligingswaarschuwing
Hoewel de containers correct worden geïnitialiseerd in de Docker-engine, zal de suite niet functioneel of veilig zijn totdat de versleutelde hashes, zoals beschreven in het volgende document, zijn gegenereerd en geïnjecteerd.

