Troubleshooting e monitoraggio di Wazuh
Risoluzione di errori di configurazione in Docker Compose, eccezioni 5007 per password non sicura, corruzione di inode e comandi di auditing Blue Team.
Questa guida tecnica raccoglie le criticità rilevate durante le fasi di architettura, deployment e integrazione della piattaforma di sicurezza Wazuh 4.9 su Docker, insieme ai rispettivi flussi di diagnostica e alle istruzioni operative di auditing per gli analisti del Blue Team.
1. Registro degli Errori Critici e Risoluzioni di Architettura
Sección titulada «1. Bitácora de Errores Críticos y Resoluciones de Arquitectura»Incidente 1: Fallimento dell'autenticazione per interpolazione di variabili ($)
Sección titulada «Incidencia 1: Fallo en Autenticación por Interpolación de Variables ($)»- Sintomo dell'errore: I container rifiutavano le password complesse iniziali e generavano eccezioni crittografiche nei log di inizializzazione.
- Diagnostica di sistema: Il motore Docker Compose interpreta nativamente il carattere speciale
$nei file di configurazione YAML come una direttiva di chiamata o interpolazione di variabili locali del sistema host. Poiché la chiave dell'admin conteneva un carattere speciale, veniva iniettata una password troncata. - Risoluzione applicata: Sostituzione integrale del dizionario delle chiavi con password alfanumeriche complesse ad alta entropia, senza simboli di escape in conflitto.
Incidente 2: Ciclo di Riavvio Infinito nel Contenitore Manager (Errore 5007)
Sección titulada «Incidencia 2: Bucle de Reinicio Infinito en Contenedor Manager (Error 5007)»- Sintomo di Errore: La query dei container segnalava al gestore
wazuh.managerin un ciclo continuo di riavvio. L'audit dei log restituiva l'eccezione:wazuh.core.exception.WazuhError: Error 5007 - Insecure user password provided. - Diagnostica di sistema: Il firmware di Wazuh, a partire dalla versione 4.9, impone una direttiva rigorosa di password hardening (Password Hardening) per l'API REST. Richiede obbligatoriamente la combinazione di lettere maiuscole, minuscole, cifre e almeno un simbolo speciale di punteggiatura.
- Risoluzione applicata: Modifica della chiave API (
mP5nT8qB2vK9wR3xY6cS4dB9.) introducendo un punto.alla fine della stessa per soddisfare i requisiti del validatore nativo di espressioni regolari.
Incidente 3: Corruzione degli inode del file internal_users.yml
Sección titulada «Incidencia 3: Corrupción por Inodos del Archivo internal_users.yml»- Sintomo dell'errore: Il motore OpenSearch rifiutava i comandi di sincronizzazione sostenendo che le identità non esistevano nelle tabelle delle credenziali. Il file appariva completamente vuoto all'interno del container.
- Diagnostica di sistema: Collisione di inode a livello di file system durante il tentativo di montare e modificare live un file dell'host verso un volume Docker. OpenSearch svuotava i metadati per riscriverli, perdendo il riferimento fisico.
- Risoluzione Applicata: Progettazione di un processo asincrono robusto:
- Generare hash bcrypt in modo isolato nel contenitore.
- Modificare fisicamente il file originale direttamente dall'host.
- Forzare la lettura utilizzando la firma SSL dello script
securityadmin.sh.
Incidente 4: Blocco di Caricamento Perpetuo “Wazuh dashboard server is not ready yet”
Sección titulada «Incidencia 4: Cuelgue de Carga Perpetuo “Wazuh dashboard server is not ready yet”»- Sintomo dell'Errore: Dopo la purga dei volumi di sistema, il frontend web è rimasto inaccessibile in modo perpetuo.
- Diagnostica di Sistema: L'istruzione
down -vdistrugge i database locali montati sull'host. All'avvio del cluster, OpenSearch si inizializza con i suoi hash predefiniti di fabbrica, interrompendo la comunicazione con la Dashboard che utilizza chiavi complesse. - Risoluzione Applicata: È obbligatorio rieseguire completamente il Passaggio 1 (Sincronizzazione degli Hash Criptografici) del Modulo 2 dopo ogni purga dei volumi del cluster.
Incidente 5: Crash-Loop della Dashboard per Chiavi Duplicate (Duplicated Mapping Key)
Sección titulada «Incidencia 5: Crash-Loop del Dashboard por Claves Duplicadas (Duplicated Mapping Key)»- Sintomo di Errore: Il container web
wazuh.dashboardsi fermava lanciando nella sua traccia di errore:FATAL Error: Error getting configuration: duplicated mapping key at line 8 [...] hosts:. - Diagnostica di Sistema: L'interfaccia web tenta di auto-iniettare la struttura del Manager nel file
wazuh.ymlse non lo localizza durante la prima inizializzazione. Se l'amministratore modifica manualmente il file contemporaneamente, vengono iniettate due chiavi di intestazionehosts:, invalidando la sintassi del linguaggio di descrizione YAML. - Risoluzione Applicata: Intervento manuale: arrestare il container, ricostruire il file di configurazione con un'unica chiave
hosts:pulita e riavviare il servizio.
2. Manuale Operativo di Monitoraggio (Comandi per Analisti)
Sección titulada «2. Manual Operativo de Monitorización (Comandos de Analista)»Comandi consigliati per verificare la salute e le prestazioni del SIEM durante simulazioni di intrusione o attività quotidiane di amministrazione:
A. Stato dell'infrastruttura dei container
Sección titulada «A. Estado de la Infraestructura de Contenedores»# Comprobar estado de encendido de todos los serviciossudo docker compose ps
# Monitorizar el consumo de recursos de CPU y RAM de cada contenedorsudo docker statsB. Diagnostica dello stato del database (Indexer)
Sección titulada «B. Diagnóstico de Salud de la Base de Datos (Indexer)»Verifica che il database distribuito non presenti problemi di indicizzazione o shard non disponibili (deve restituire la chiave "status" : "green"):
sudo docker compose exec wazuh.indexer curl -X GET -k -u admin:zR9mK2vX5pW8qN3tY6cR4vB1 "https://localhost:9200/_cluster/health?pretty"C. Stato operativo dei sottoprocessi di analisi (Manager)
Sección titulada «C. Estado Operativo de los Subprocesos de Análisis (Manager)»Controlla lo stato interno del core di Wazuh e verifica che tutte le code di analisi e i motori di log riportino uno stato attivo (running):
sudo docker compose exec wazuh.manager /var/ossec/bin/wazuh-control statusD. Tracce forensi e Incident Response (Log in tempo reale)
Sección titulada «D. Trazas Forenses e Incident Response (Logs en Tiempo Real)»Comandi chiave per controllare gli errori di comunicazione o tracciare gli incidenti di sicurezza di rete a caldo:
# Monitorizar trazas de conexión del Portal Websudo docker compose logs -f wazuh.dashboard
# Monitorizar trazas de enlace y alertas del Indexer con el Managersudo docker compose logs -f wazuh.manager
# Inspeccionar logs internos de alertas caídas o bloqueos de agentessudo docker compose exec wazuh.manager tail -f /var/ossec/logs/ossec.log
# Visualización analítica de Alertas en Caliente (Ideal para Incident Response)sudo docker compose exec wazuh.manager tail -f /var/ossec/logs/alerts/alerts.json
