Устранение неполадок и мониторинг Wazuh
Исправление ошибок конфигурации в docker compose, исключения 5007 (небезопасный пароль), повреждение inode и команды аудита Blue Team.
Это техническое руководство содержит описание критических инцидентов, выявленных на этапах проектирования, развертывания и интеграции платформы безопасности 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 очищал метаданные для их перезаписи, теряя физическую ссылку.
- Примененное решение: Разработка надежного асинхронного процесса:
- Генерация хешей bcrypt изолированно внутри контейнера.
- Физическое изменение оригинального файла непосредственно с хоста.
- Принудительное чтение с использованием 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»# 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. Диагностика состояния базы данных (Indexer)
Sección titulada «B. Diagnóstico de Salud de la Base de Datos (Indexer)»Проверьте, что распределенная база данных не имеет проблем с индексацией или упавших шардов (должна вернуть ключ "status" : "green"):
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):
sudo docker compose exec wazuh.manager /var/ossec/bin/wazuh-control statusD. Форензика и реагирование на инциденты (логи в реальном времени)
Sección titulada «D. Trazas Forenses e Incident Response (Logs en Tiempo Real)»Ключевые команды для аудита ошибок связи или оперативного отслеживания инцидентов сетевой безопасности:
# 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
