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.
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.
1. Pianificazione delle Credenziali e Hardening
Sección titulada «1. Planificación de Credenciales y Endurecimiento»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 / Servizio | Identità / Utente | Password Fittizia di Esempio | Note di Integrazione |
|---|---|---|---|
| Interfaccia di Wazuh (Indexer) | admin | zR9mK2vX5pW8qN3tY6cR4vB1 | Account di accesso principale per l'amministrazione web. |
| API interna di Wazuh | wazuh-wui | mP5nT8qB2vK9wR3xY6cS4dB9. | È obbligatorio terminare con un punto . per rispettare la direttiva dei simboli. |
| Servizio di comunicazione | kibanaserver | yQ3wV8xR9pK2mN6tT5sR4vC1 | Account utilizzato per la comunicazione interna tra i nodi. |
2. Provisioning dell'Ambiente sull'Host (Ubuntu)
Sección titulada «2. Aprovisionamiento del Entorno en el Host (Ubuntu)»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):
# 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. 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:
sudo docker compose -f generate-indexer-certs.yml run --rm generator3. File Docker Compose di Produzione
Sección titulada «3. Archivo Docker Compose de Producción»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:4. Mappatura delle Porte (Rete di Sicurezza)
Sección titulada «4. Mapa de Enrutamiento de Puertos (Red de Seguridad)»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:
A. Container: wazuh.manager (Motore di analisi)
Sección titulada «A. Contenedor: wazuh.manager (Cerebro de Análisis)»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.
B. Container: wazuh.indexer (Archiviazione)
Sección titulada «B. Contenedor: wazuh.indexer (Almacenamiento)»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 porta5601, 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.
5. Inizializzazione dei Container
Sección titulada «5. Inicialización de Contenedores»Una volta strutturato il file docker-compose.yml, viene avviata l'infrastruttura in background:
sudo docker compose up -dAvvertenza 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.

