Ir al contenido

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.

0lecturas

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.

Incidencia 2: Bucle de Reinicio Infinito en Contenedor Manager (Error 5007)

Sección titulada «Incidencia 2: Bucle de Reinicio Infinito en Contenedor Manager (Error 5007)»
  • Síntoma de Error: La consulta de contenedores reportaba al gestor wazuh.manager en un bucle continuo de reinicio. La auditoría de logs arrojaba la excepción: wazuh.core.exception.WazuhError: Error 5007 - Insecure user password provided.
  • Diagnóstico de Sistemas: El firmware de Wazuh a partir de su versión 4.9 impone una directiva de dureza de contraseña (Password Hardening) estricta para la API REST. Requiere obligatoriamente la presencia combinada de mayúsculas, minúsculas, dígitos y al menos un símbolo especial de puntuación.
  • Resolución Aplicada: Modificación de la clave de la API (mP5nT8qB2vK9wR3xY6cS4dB9.) introduciendo un punto . al final de la misma para cumplir los requisitos del validador de expresiones regulares nativo.

Incidencia 3: Corrupción por Inodos del Archivo internal_users.yml

Sección titulada «Incidencia 3: Corrupción por Inodos del Archivo internal_users.yml»
  • Síntoma de Error: El motor OpenSearch rechazaba los comandos de sincronización alegando que las identidades no existían en las tablas de credenciales. El archivo aparecía completamente vacío en el interior del contenedor.
  • Diagnóstico de Sistemas: Colisión de inodos a nivel de sistema de archivos al intentar montar y modificar en vivo un archivo de host hacia un volumen de Docker. OpenSearch vaciaba los metadatos para reescribirlos, perdiendo la referencia física.
  • Resolución Aplicada: Diseño de un proceso asíncrono robusto:
    1. Generar hashes bcrypt de forma aislada en el contenedor.
    2. Modificar físicamente el archivo original directamente desde el host.
    3. Forzar la lectura utilizando la firma SSL del script securityadmin.sh.

Incidencia 4: Cuelgue de Carga Perpetuo “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 de Error: Tras la purga de volumenes del sistema, el frontend web permanecía inaccesible de forma perpetua.
  • Diagnóstico de Sistemas: La instrucción down -v destruye las bases de datos locales montadas en el host. Al levantar el clúster, OpenSearch se inicializa con sus hashes predeterminados de fábrica, rompiendo la comunicación con el Dashboard que utiliza las claves complejas.
  • Resolución Aplicada: Es mandatorio re-ejecutar por completo el Paso 1 (Sincronización de Hashes Criptográficos) del Módulo 2 tras cada purga de volumen del clúster.

Incidencia 5: Crash-Loop del Dashboard por Claves Duplicadas (Duplicated Mapping Key)

Sección titulada «Incidencia 5: Crash-Loop del Dashboard por Claves Duplicadas (Duplicated Mapping Key)»
  • Síntoma de Error: El contenedor web wazuh.dashboard se detenía arrojando en su traza de error: FATAL Error: Error getting configuration: duplicated mapping key at line 8 [...] hosts:.
  • Diagnóstico de Sistemas: La interfaz web intenta auto-inyectar la estructura del Manager en el archivo wazuh.yml si no lo localiza en su primera inicialización. Si el administrador edita manualmente el archivo a la vez, se inyectan dos llaves de cabecera hosts:, invalidando la sintaxis del lenguaje de descripción YAML.
  • Resolución Aplicada: Intervención manual: Detener el contenedor, reconstruir el archivo de configuración con una única llave hosts: limpia, y volver a arrancar el servicio.

2. Manual Operativo de Monitorización (Comandos de Analista)

Sección titulada «2. Manual Operativo de Monitorización (Comandos de Analista)»

Comandos recomendados para verificar la salud y el rendimiento del SIEM durante simulaciones de intrusión o tareas cotidianas de administración:

A. Estado de la Infraestructura de Contenedores

Sección titulada «A. Estado de la Infraestructura de Contenedores»
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

B. Diagnóstico de Salud de la Base de Datos (Indexer)

Sección titulada «B. Diagnóstico de Salud de la Base de Datos (Indexer)»

Verifica que la base de datos distribuida no tiene problemas de indexación o shards caídos (debe devolver la clave "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. Estado Operativo de los Subprocesos de Análisis (Manager)

Sección titulada «C. Estado Operativo de los Subprocesos de Análisis (Manager)»

Comprueba el estado interno del cerebro de Wazuh y verifica que todas las colas de análisis y motores de logs reportan estado activo (running):

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

D. Trazas Forenses e Incident Response (Logs en Tiempo Real)

Sección titulada «D. Trazas Forenses e Incident Response (Logs en Tiempo Real)»

Comandos clave para auditar errores de comunicación o realizar un seguimiento de incidentes de seguridad de red en caliente:

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