Troubleshooting y Monitorización de Wazuh
Resolución de errores de configuración en docker compose, excepciones 5007 de contraseña insegura, corrupción de inodos y comandos de auditoría Blue Team.
Esta guía técnica recopila las incidencias críticas detectadas durante las fases de arquitectura, despliegue e integración de la plataforma de seguridad Wazuh 4.9 bajo Docker, junto con sus respectivos flujos de diagnóstico e instrucciones operativas de auditoría para analistas del Blue Team.
1. Bitácora de Errores Críticos y Resoluciones de Arquitectura
Sección titulada «1. Bitácora de Errores Críticos y Resoluciones de Arquitectura»Incidencia 1: Fallo en Autenticación por Interpolación de Variables ($)
Sección titulada «Incidencia 1: Fallo en Autenticación por Interpolación de Variables ($)»- Síntoma de Error: Los contenedores rechazaban las contraseñas complejas iniciales y arrojaban excepciones criptográficas en los logs de inicialización.
- Diagnóstico de Sistemas: El motor de Docker Compose interpreta nativamente el carácter especial $
en los archivos de configuración YAML como una directiva de llamada o interpolación de variables locales del sistema anfitrión. Al contener la clave del admin un carácter especial, se inyectaba una contraseña truncada. - Resolución Aplicada: Reemplazo integral del diccionario de claves por contraseñas complejas alfanuméricas de alta entropía sin símbolos de escape en conflictos.
Incidència 2: Bucle de Reinici de Contingut (Error 5007)
Sección titulada «Incidencia 2: Bucle de Reinicio Infinito en Contenedor Manager (Error 5007)»- Síntoma d'error: La consulta de contenidors informava al gestor
wazuh.manageren un bucle continu de reinici. L'auditoria de logs mostrava l'excepció:wazuh.core.exception.WazuhError: Error 5007 - Insecure user password provided. - Diagnòstic de Sistemes: El firmware de Wazuh a partir de la seva versió 4.9 impone una directiva de duresa de contrassenya (Password Hardening) estricta per a la API REST. Requereix obligatoriament la presencia combinada de majuscula, minúscula, dígits i almenys un símbol especial de puntuació.
- Resolució Aplicada: Modificació de la clau de la API (mP5nT8qB2vK9wR3xY6cS4dB9.
) introduint un punt .al final de la mateixa per complir els requisits del validador d'expressions regulares nativa.
Incidència 3: Corrupció per Inodos del Arxiu internal_users.yml
Sección titulada «Incidencia 3: Corrupción por Inodos del Archivo internal_users.yml»- Síntoma d'Error: El motor OpenSearch rechazava els comandos de sincronització alegant que les identitats no existien en les taules de credenciales. L'arxiu apareixia completament buit en l'interior del contenedor.
- Diagnòstic de Sistemes: Col·lisió d'inodos a nivell de sistema de fitxers al intentar montar i modificar en viu un arxiu de host cap a un volum de Docker. OpenSearch vaciava els metadats per reescriurels, perdia la referència física.
- Resolución Aplicada: Diseño de un proceso asíncrono robusto:
- Generar hashes bcrypt de forma aislada en el contenedor.
- Modificar físicament l'arxiu original directament des del host.
- Forzar la lectura utilizando la firma SSL del script securityadmin.sh
.
Incidència 4: Cuelgue de Carga Perpetu “Wazuh dashboard server is not ready yet”
Sección titulada «Incidencia 4: Cuelgue de Carga Perpetuo “Wazuh dashboard server is not ready yet”»- Síntoma d'Error: Tras la purga de volumens del sistema, el frontend web permanecia inaccesible de forma perpetua.
- Diagnòstic de Sistemes: La instrucció down -v
destrueix les bases de dades locals montades en el host. Al levantar el clúster, OpenSearch es inicialitza amb les seves hashes predeterminades de fàbrica, rompint la comunicació amb el Dashboard que utilitza les claus complexes. - Resolució Aplicada: Es mandatori re-ejecutar per complet el Paso 1 (Sincronització de Hashes Criptogràfics) del Mòdul 2 tras cada purga de volum de clúster.
Incidència 5: Crash-Loop del Dashboard per Claus Duplicades (Duplicated Mapping Key)
Sección titulada «Incidencia 5: Crash-Loop del Dashboard por Claves Duplicadas (Duplicated Mapping Key)»- Síntoma d'error: El contènidor web
wazuh.dashboards'aturava emetint a la seva traça d'error:FATAL Error: Error getting configuration: duplicated mapping key at line 8 [...] hosts:. - Diagnòstic de Sistemes: La interfície web intenta auto-injectar la estructura del Manager en l'arxiu wazuh.yml
si no el localitza en la primera inicialització. Si l'administrador edita manualment l'arxiu a la vegada, es injecten dues claus de capçalera hosts:, invalidant la sintaxi del llenguatge de descripció YAML. - Resolució Aplicada: Intervenció manual: Detenir el contenedor, reconstruir l'arxiu de configuració amb una única clau hosts:
limpia, i tornar a arrancar el servei.
2. Manual Operatiu de Monitorització (Comandos de Analista)
Sección titulada «2. Manual Operativo de Monitorización (Comandos de Analista)»Comandos recomanats per verificar la salut i el rendiment del SIEM durant simulacions d'intrusió o tàctiques cotidianes de administració:
A. Estat de la Infraestructura de Contenedors
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. Diagnòstic de Salut de la Base de Dades (Indexer)
Sección titulada «B. Diagnóstico de Salud de la Base de Datos (Indexer)»Verifica que la base de dades distribuïda no té problemes d'indexació o shards caïts (deu devolver la clau "status" : "verd"):
sudo docker compose exec wazuh.indexer curl -X GET -k -u admin:zR9mK2vX5pW8qN3tY6cR4vB1 "https://localhost:9200/_cluster/health?pretty"C. Estat Operatiu dels Subprocessos d'Anàlisi (Manager)
Sección titulada «C. Estado Operativo de los Subprocesos de Análisis (Manager)»Verifica el estado interno del cerebro de Wazuh y verifica que todas las colas de análisis y motores de logs reportan estado activo (running):
sudo docker compose exec wazuh.manager /var/ossec/bin/wazuh-control statusD. Trazas Forenses e Incident Response (Logs en Tiempo Real)
Sección titulada «D. Trazas Forenses e Incident Response (Logs en Tiempo Real)»Comands clau per auditar errors de comunicació o realitzar un seguiment d'incidents de seguretat de xarxa en calent:
# 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
