Ir al contenido

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.

0lecturas

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.


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 / ServiceIdentiteit / GebruikerFictief voorbeeldwachtwoordIntegratienotities
Wazuh-interface (Indexer)adminzR9mK2vX5pW8qN3tY6cR4vB1Hoofdtoegangsaccount voor webbeheer.
Wazuh interne APIwazuh-wuimP5nT8qB2vK9wR3xY6cS4dB9.Het is verplicht om af te sluiten met een punt . om te voldoen aan de symboolrichtlijn.
CommunicatiedienstkibanaserveryQ3wV8xR9pK2mN6tT5sR4vC1Account gebruikt voor interne communicatie tussen knooppunten.

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

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

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

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:

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:

  • 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.
  • 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.
  • 443 ➔ 5601 (TCP) - HTTPS-portaal: De interne service gebruikt poort 5601, 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.

Zodra het bestand docker-compose.yml is gestructureerd, wordt de infrastructuur op de achtergrond opgestart:

Ventana de terminal
sudo docker compose up -d

Beveiligingswaarschuwing

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.