Ir al contenido

Architettura di Wazuh e Deployment con Docker Compose

Guida al deployment modulare di Wazuh 4.9 in container Docker, assegnazione di credenziali alfanumeriche complesse e mappa di routing delle porte di sicurezza.

0letture

Questa guida dettaglia la procedura tecnica standard per il deployment di Wazuh 4.9 in un ambiente Dockerized a nodo singolo (single-node). Questo modulo affronta la pianificazione delle risorse, la preparazione dell'ambiente host, la strutturazione del file docker-compose.yml e l'architettura di routing della rete di sicurezza.


Per evitare errori di parsing durante l'inizializzazione dei container da parte del motore Docker (come l'interpretazione errata di caratteri speciali come $ o * nei file YAML) e per rispettare rigorosamente le direttive di sicurezza di Wazuh, è stata definita una matrice di credenziali alfanumeriche ad alta entropia per i servizi principali:

Componente / ServizioIdentità / UtentePassword Fittizia di EsempioNote di Integrazione
Interfaccia di Wazuh (Indexer)adminzR9mK2vX5pW8qN3tY6cR4vB1Account di accesso principale per l'amministrazione web.
API interna di Wazuhwazuh-wuimP5nT8qB2vK9wR3xY6cS4dB9.È obbligatorio terminare con un punto . per rispettare la direttiva dei simboli.
Servizio di comunicazionekibanaserveryQ3wV8xR9pK2mN6tT5sR4vC1Account utilizzato per la comunicazione interna tra i nodi.

Il deployment completo sarà consolidato nella directory dell'host: /opt/wazuh-stack/single-node.

A. Clonare il Branch del Repository Ufficiale

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

Wazuh richiede certificati SSL/TLS per cifrare end-to-end le comunicazioni tra i suoi tre container principali (Indexer, Manager e Dashboard). Accedi alla console dell'host e clona la versione esatta certificata (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. Generazione dell'Autorità di Certificazione e dei Certificati TLS

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

Inizializza il container temporaneo generatore per eseguire automaticamente il provisioning dell'infrastruttura a chiave pubblica (PKI) e delle firme digitali dei servizi:

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

Questo file contiene la dichiarazione finale dei servizi, i limiti di memoria del kernel ottimizzati e le credenziali statiche iniziali dell'ambiente.

Percorso del file: /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:

Per consentire agli analisti del Blue Team di configurare correttamente le regole di filtraggio perimetrale (come i firewall pfSense o le policy dell'host), viene dettagliata la funzione tecnica delle porte mappate:

  • 1514 (TCP/UDP) - Agent: Porta di comunicazione critica. Gli agent di raccolta remoti inviano tramite questa porta i propri log decifrati e i metadati in tempo reale.
  • 1515 (TCP) - Authd: Porta del servizio di registrazione degli agent. Viene utilizzata esclusivamente durante l'accoppiamento di un nuovo nodo per generare e trasmettere la chiave di cifratura simmetrica.
  • 514 (UDP) - Syslog: Servizio opzionale per la raccolta dei log di rete da dispositivi che non supportano agent nativi (come router, firewall pfSense e switch).
  • 55000 (TCP) - API REST: Interfaccia di controllo del Manager. Viene utilizzata dal Dashboard per elaborare le query di amministrazione interna.
  • 9200 (TCP) - OpenSearch API: Porta di lettura/scrittura del database di indicizzazione. Filebeat introduce gli avvisi qui e la Dashboard li recupera per mostrarli nei grafici.

C. Contenitore: wazuh.dashboard (Console Web)

Sección titulada «C. Contenedor: wazuh.dashboard (Consola Web)»
  • 443 ➔ 5601 (TCP) - Portale HTTPS: Il servizio interno utilizza la porta 5601, ma viene mappata in Docker sulla porta standard 443 (HTTPS) sull'host per consentire accessi puliti e diretti dal browser senza specificare porte non standard.

Una volta strutturato il file docker-compose.yml, viene avviata l'infrastruttura in background:

Ventana de terminal
sudo docker compose up -d

Avvertenza di Sicurezza

Sebbene i container vengano inizializzati correttamente nel motore Docker, la suite non sarà né funzionale né sicura finché non verranno generati e iniettati gli hash crittografati dettagliati nel documento seguente.