Ir al contenido

Arquitectura de Wazuh i Desplegament amb Docker Compose

Guia de desplegament modular de Wazuh 4.9 en contenedors Docker, assignació de credencials alfanumèriques complexes i mapa d'enrutament de ports de seguretat.

0lectures

Esta guía detalla el procedimiento técnico estándar para el despliegue de Wazuh 4.9 en un entorno Dockerizado de nodo único. Este módulo aborda la planificación de recursos, la preparación del entorno del host, la estructuración del archivo docker-compose.yml y la arquitectura de enrutamiento de red de seguridad.


Para evitar errores de parseo durante la inicialización de los contenedores por el motor de Docker y cumplir estrictamente las directivas de seguridad de Wazuh, se ha definido una matriz de credenciales alfanuméricas de alta entropía para los servicios principales.

Componente / ServicioIdentidad / UsuarioContraseña Ficticia de EjemploNotas de Integración
Interfaz de Wazuh (Indexer)adminzR9mK2vX5pW8qN3tY6cR4vB1Cuenta de acceso principal de administración web.
API Interna de Wazuhwazuh-wuimP5nT8qB2vK9wR3xY6cS4dB9.Obligatorio terminar en punto . para cumplir la directiva de símbolos.
Servicio de ComunicaciónkibanaserveryQ3wV8xR9pK2mN6tT5sR4vC1Compte utilitzada per a la comunicació interna entre nodes.

El despliegue completo se consolidará bajo el directorio del host: /opt/wazuh-stack/single-node.

Wazuh requere certificats SSL/TLS per cifrar de punta a punta les comunicacions entre els seus tres contenidors principals (Indexer, Manager i Dashboard). Accedeix a la teva consola de l'host i clona la versió exacta certificada (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

Generación de la Autoridad de Certificación y Certificados TLS

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

Inicializa el contenedor temporal generador para aprovisionar automáticamente la infraestructura de claves públicas (PKI) y las firmas digitales de los servicios.

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

Aquest arxiu conté la declaració final de serveis, límits de memòria de kernel optimitzats i les credencials estàtiques inicials de l'entorn.

Ruta del archivo: /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:

Mapa de Enrutamiento de Puertos (Red de Seguridad)

Sección titulada «4. Mapa de Enrutamiento de Puertos (Red de Seguridad)»

Para permitir que los analistas del Blue Team configuren correctamente las reglas de filtrado perimetral (tales como firewalls pfSense o políticas del host), se detalla la función técnica de los puertos mapeados.

  • 1514 (TCP/UDP) - Agentes: Puerto de comunicación crítico. Los agentes recopiladores remotos envían por aquí sus logs descifrados y metadatos en tiempo real.
  • 1515 (TCP) - Authd: Puerto del servicio de registro de agentes. Se utiliza exclusivamente al emparejar un nuevo nodo para generar y transmitir la clave de cifrado simétrica.
  • 514 (UDP) - Syslog: Servei opcional per a la recollida de logs de xarxa de dispositius que no suporten agents natius (com routers, firewalls pfSense i switches).
  • 55000 (TCP) - API REST: Interfaz de control del Manager. Es consumida por el Dashboard para procesar consultas de administración interna.
  • 9200 (TCP) - OpenSearch API: Puerto de lectura/escritura de la base de datos de indexación. Filebeat introduce las alertas aquí y el Dashboard las recupera para mostrarlas en los gráficos.
  • 443 ➔ 5601 (TCP) - Portal HTTPS: El servei intern utilitza el port 5601, però es mapeja a Docker al port estàndard 443 (HTTPS) de l'host per permetre accessos nets i directes des del navegador sense especificar ports atípics.

Una vez estructurado el archivo docker-compose.yml, levanta la infraestructura en segundo plano.

Ventana de terminal
sudo docker compose up -d

Advertencia de Seguridad

Aunque los contenedores inicialicen correctamente en el motor de Docker, la suite no será funcional ni segura hasta que se generen e inyecten los hashes encriptados detallados en el siguiente documento.