Ir al contenido

Устранение неполадок и мониторинг Wazuh

Исправление ошибок конфигурации в docker compose, исключения 5007 (небезопасный пароль), повреждение inode и команды аудита Blue Team.

0просмотры

Это техническое руководство содержит описание критических инцидентов, выявленных на этапах проектирования, развертывания и интеграции платформы безопасности Wazuh 4.9 в Docker, а также соответствующие диагностические процессы и оперативные инструкции по аудиту для аналитиков Blue Team.


1. Журнал критических ошибок и архитектурных решений

Sección titulada «1. Bitácora de Errores Críticos y Resoluciones de Arquitectura»

Инцидент 1: Ошибка аутентификации из-за интерполяции переменных ($)

Sección titulada «Incidencia 1: Fallo en Autenticación por Interpolación de Variables ($)»
  • Симптом ошибки: Контейнеры отклоняли исходные сложные пароли и выдавали криптографические исключения в логах инициализации.
  • Диагностика системы: Движок Docker Compose нативно интерпретирует специальный символ $ в конфигурационных файлах YAML как директиву вызова или интерполяции локальных переменных хост-системы. Поскольку ключ администратора содержал специальный символ, вводился усеченный пароль.
  • Примененное решение: Полная замена словаря ключей на сложные буквенно-цифровые пароли с высокой энтропией, не содержащие символов, вызывающих конфликты при экранировании.

Инцидент 2: Бесконечный цикл перезагрузки в менеджере контейнеров (Ошибка 5007)

Sección titulada «Incidencia 2: Bucle de Reinicio Infinito en Contenedor Manager (Error 5007)»
  • Симптом ошибки: Запрос контейнера сообщал менеджеру wazuh.manager в непрерывном цикле перезагрузки. Аудит журналов выдавал исключение: wazuh.core.exception.WazuhError: Error 5007 - Insecure user password provided.
  • Диагностика системы: Прошивка Wazuh, начиная с версии 4.9, накладывает строгую политику ужесточения паролей (Password Hardening) для REST API. Она обязательно требует сочетания заглавных и строчных букв, цифр и как минимум одного специального пунктуационного символа.
  • Примененное решение: Изменение API-ключа (mP5nT8qB2vK9wR3xY6cS4dB9.) путем добавления точки . в конце для соответствия требованиям встроенного валидатора регулярных выражений.

Инцидент 3: Повреждение файла internal_users.yml из-за инодов

Sección titulada «Incidencia 3: Corrupción por Inodos del Archivo internal_users.yml»
  • Симптом ошибки: Движок OpenSearch отклонял команды синхронизации, утверждая, что идентификаторы отсутствуют в таблицах учетных данных. Файл внутри контейнера оказывался полностью пустым.
  • Диагностика систем: Конфликт инодов на уровне файловой системы при попытке смонтировать и изменить в реальном времени файл хоста в Docker-томе. OpenSearch очищал метаданные для их перезаписи, теряя физическую ссылку.
  • Примененное решение: Разработка надежного асинхронного процесса:
    1. Генерация хешей bcrypt изолированно внутри контейнера.
    2. Физическое изменение оригинального файла непосредственно с хоста.
    3. Принудительное чтение с использованием SSL-подписи скрипта securityadmin.sh.

Инцидент 4: Бесконечный завис при загрузке «Wazuh dashboard server is not ready yet»

Sección titulada «Incidencia 4: Cuelgue de Carga Perpetuo “Wazuh dashboard server is not ready yet”»
  • Симптом ошибки: После очистки системных томов веб-интерфейс оставался постоянно недоступным.
  • Диагностика систем: Команда down -v уничтожает локальные базы данных, смонтированные на хосте. При запуске кластера OpenSearch инициализируется со своими заводскими хешами по умолчанию, что разрывает связь с Dashboard, использующим сложные ключи.
  • Примененное решение: После каждой очистки томов кластера необходимо полностью повторно выполнить Шаг 1 (Синхронизация криптографических хешей) Модуля 2.

Инцидент 5: Crash-Loop Dashboard из-за дублирующихся ключей (Duplicated Mapping Key)

Sección titulada «Incidencia 5: Crash-Loop del Dashboard por Claves Duplicadas (Duplicated Mapping Key)»
  • Симптом ошибки: Веб-контейнер wazuh.dashboard останавливался, выбрасывая в своей трассировке ошибки: FATAL Error: Error getting configuration: duplicated mapping key at line 8 [...] hosts:.
  • Диагностика системы: Веб-интерфейс пытается автоматически внедрить структуру Manager в файл wazuh.yml, если не находит его при первой инициализации. Если администратор одновременно вручную редактирует файл, внедряются две заголовочные записи hosts:, что нарушает синтаксис языка описания YAML.
  • Примененное решение: Ручное вмешательство: остановить контейнер, пересобрать конфигурационный файл с одной чистой записью hosts: и перезапустить службу.

2. Оперативное руководство по мониторингу (команды аналитика)

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

Рекомендуемые команды для проверки работоспособности и производительности SIEM во время симуляций вторжений или повседневных административных задач:

A. Состояние контейнерной инфраструктуры

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. Диагностика состояния базы данных (Indexer)

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

Проверьте, что распределенная база данных не имеет проблем с индексацией или упавших шардов (должна вернуть ключ "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. Операционное состояние подпроцессов анализа (Manager)

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

Проверьте внутреннее состояние «мозга» Wazuh и убедитесь, что все очереди анализа и движки логов сообщают об активном состоянии (running):

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

D. Форензика и реагирование на инциденты (логи в реальном времени)

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

Ключевые команды для аудита ошибок связи или оперативного отслеживания инцидентов сетевой безопасности:

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