Ir al contenido

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.

0letture

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.manager in 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:
    1. Generare hash bcrypt in modo isolato nel contenitore.
    2. Modificare fisicamente il file originale direttamente dall'host.
    3. 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 -v distrugge 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.dashboard si 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.yml se non lo localizza durante la prima inizializzazione. Se l'amministratore modifica manualmente il file contemporaneamente, vengono iniettate due chiavi di intestazione hosts:, 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:

Ventana de terminal
# Comprobar estado de encendido de todos los servicios
sudo docker compose ps
# Monitorizar el consumo de recursos de CPU y RAM de cada contenedor
sudo docker stats

Verifica che il database distribuito non presenti problemi di indicizzazione o shard non disponibili (deve restituire la chiave "status" : "green"):

Ventana de terminal
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):

Ventana de terminal
sudo docker compose exec wazuh.manager /var/ossec/bin/wazuh-control status

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

Ventana de terminal
# Monitorizar trazas de conexión del Portal Web
sudo docker compose logs -f wazuh.dashboard
# Monitorizar trazas de enlace y alertas del Indexer con el Manager
sudo docker compose logs -f wazuh.manager
# Inspeccionar logs internos de alertas caídas o bloqueos de agentes
sudo 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