Корреляционные правила Wazuh для SSH: пишем детект вместо дефолтных алертов

По данным IBM X-Force Threat Intelligence Index 2025, атаки с использованием действительных учётных данных выросли на 71% за год. Часть этих credentials добывается через банальный брутфорс SSH — и дефолтные алерты Wazuh ловят только базовый сценарий. Правило 5763 сработает на серию неудачных логинов от одного IP, но пропустит password spraying, не заметит вход root в три ночи и не заблокирует источник автоматически. Я часто вижу одну и ту же картину: ставят Wazuh, радуются дашборду неделю, а потом забрасывают — потому что все алерты одинаковые и ни о чём не говорят.
Здесь разбираю, как написать корреляционные правила Wazuh для SSH, которые закрывают эти пробелы: от разбора дефолтного ruleset до кастомных XML-правил, тестирования через wazuh-logtest и автоблокировки через Active Response.
Все примеры проверены на Wazuh 4.x (стабильная ветка). Нужен sudo-доступ к Wazuh-серверу и хотя бы один подключённый агент на Linux-хосте с открытым SSH.
Дефолтные правила Wazuh SSH brute force: что ловят и где пасуют
Wazuh — open-source SIEM-платформа, то есть система, которая собирает логи с разных хостов и ищет в них подозрительные паттерны. При установке она уже содержит набор встроенных правил для SSH в файле /var/ossec/ruleset/rules/0095-sshd_rules.xml. Три ключевых:
| Rule ID | Level | Что ловит | Ограничение |
|---|---|---|---|
| 5710 | 5 | Попытка входа от несуществующего пользователя | Единичное событие, нет корреляции |
| 5760 | 5 | Неудачная аутентификация от известного пользователя | Единичное событие, нет корреляции |
| 5763 | 10 | Серия неудачных попыток SSH — брутфорс (ID может отличаться в зависимости от версии ruleset) | Только same_source_ip, не ловит spraying |
Правила 5710 и 5760 — одиночные: каждый Failed password порождает отдельный алерт с уровнем 5. Для ориентира: шкала Wazuh идёт от 0 до 15, где 5 — информационный уровень. На публичном сервере это сотни записей в час. SOC-аналитик первой линии (L1, первичная сортировка алертов) перестаёт их замечать за первую смену.
Правило 5763 — уже корреляционное: оно считает повторные срабатывания 5710/5760 с одного IP за определённый период. Но его границы жёсткие, и несколько реальных сценариев атак оно не покрывает.
Password spraying — атакующий берёт один распространённый пароль и пробует его по списку пользователей. Поле dstuser (целевой пользователь) каждый раз разное, поэтому корреляция по одному пользователю не набирает порог.
Атака в нерабочее время — успешный SSH-логин root в 03:00 для дефолтного набора правил выглядит как обычная легитимная аутентификация. Никакого алерта.
Успешный вход после серии неудач — правило 5763 зафиксировало брутфорс, но если атакующий подобрал пароль, дефолтные правила не свяжут два события в цепочку. А это самое интересное.
Для тех, кто только знакомится с классификацией атак: MITRE ATT&CK — открытая база тактик и техник, которую используют SOC-аналитики и пентестеры для единообразного описания действий атакующего. У каждой техники свой идентификатор (T-код). SSH-брутфорс — это T1110.001, Password Guessing (тактика Credential Access). Успешный SSH-вход после компрометации — T1021.004, SSH (тактика Lateral Movement — горизонтальное перемещение по сети, когда атакующий уже внутри).
Зачем атакующему вообще SSH? Мотивация прямолинейна: SSH даёт интерактивную shell-сессию с правами целевого пользователя. Это точка входа для установки backdoor, кражи данных или развёртывания криптомайнера. По CrowdStrike Global Threat Report 2025, 86% атак имеют финансовую мотивацию — SSH-доступ закономерно встраивается в эту картину.
Как Wazuh декодирует SSH-лог: декодеры и правила в действии
Прежде чем писать кастомные правила, нужно понимать, как Wazuh обрабатывает строку лога. Движок wazuh-analysisd пропускает каждое событие через три фазы. Это не абстракция — результат каждой фазы видно в утилите wazuh-logtest, и я рекомендую начинать именно с неё.
Представим: атакующий ввёл неверный пароль при SSH-подключении. В /var/log/auth.log на агенте появилась строка:
2026-09-23T16:06:03 ubuntu sshd[969673]: Failed password for emilio from 10.0.0.5 port 59278 ssh2
Запускаем утилиту отладки на Wazuh-сервере: sudo /var/ossec/bin/wazuh-logtest. Вставляем строку и получаем:
**Phase 1: Completed pre-decoding.
program_name: 'sshd'
**Phase 2: Completed decoding.
name: 'sshd'
dstuser: 'emilio'
srcip: '10.0.0.5'
**Phase 3: Completed filtering (rules).
id: '5760'
level: '5'
description: 'sshd: authentication failed.'
groups: ['syslog', 'sshd', 'authentication_failed']
Phase 1 (pre-decoding) — Wazuh распарсил сырую строку syslog-формата, извлёк timestamp и имя программы sshd. Для стандартных форматов это происходит автоматически.
Phase 2 (decoding) — Встроенный декодер sshd выделил структурированные поля: dstuser (кого пытались взломать — emilio), srcip (откуда пришла попытка — 10.0.0.5), srcport (59278). Декодер — XML-конструкция с регулярным выражением, которая превращает текстовую строку в именованные поля. Для SSH встроенный декодер покрывает все стандартные сообщения sshd, писать кастомный не нужно.
Phase 3 (rules) — Движок проверил все правила по цепочке наследования и нашёл совпадение: правило 5760, уровень 5. Обратите внимание на группу authentication_failed в выводе — она нам понадобится при написании кастомных правил.
Ключевой момент, на котором спотыкаются многие: правило может сработать, только если декодер успешно извлёк поля на Phase 2. Пишете правило, которое проверяет srcip, но декодер этого поля не выделил — правило никогда не сработает, и вы будете долго искать причину. Поэтому workflow всегда начинается с wazuh-logtest: сначала убеждаемся, что декодирование прошло правильно, потом пишем правило.
Написание корреляционных правил Wazuh XML для SSH
Файл для кастомных правил — /var/ossec/etc/rules/local_rules.xml. Встроенные правила в /var/ossec/ruleset/rules/ менять нельзя: при обновлении Wazuh они перезапишутся. ID кастомных правил берите из диапазона 100000–120000, чтобы избежать конфликтов.
Корреляция событий: frequency, timeframe, same_source_ip
Корреляция событий в SIEM — это связывание нескольких отдельных событий в единый инцидент по общим признакам. Без корреляции у вас тысяча одиночных алертов «неудачный логин». С корреляцией — один алерт «брутфорс с IP 10.0.0.5». В Wazuh корреляция реализуется через три атрибута: frequency (сколько раз должно сработать родительское правило), timeframe (за какой период в секундах) и тег <same_source_ip /> (группировать по IP-адресу источника).
Правило ниже детектирует SSH-брутфорс: 6 неудачных логинов с одного IP за 2 минуты.
<group name="local,sshd,">
<rule id="100100" level="10" frequency="6" timeframe="120">
<if_matched_group>authentication_failed</if_matched_group>
<same_source_ip />
<description>SSH brute force: 6+ failed logins in 2 min</description>
<mitre>
<id>T1110.001</id>
</mitre>
</rule>
</group>
Разберём каждый элемент:
id="100100"— уникальный ID в кастомном диапазоне. Если у вас уже есть правило с таким номером, выберите другой.level="10"— высокий приоритет. Алерт попадёт на дашборд и в/var/ossec/logs/alerts/alerts.json.frequency="6"— правило активируется после шестого совпадения. Не после шестого события вообще, а после шестого события из группыauthentication_failed. Разница принципиальна.timeframe="120"— окно наблюдения 120 секунд. Если между первым и шестым событием прошло больше двух минут, правило не сработает.<if_matched_group>authentication_failed</if_matched_group>— правило отслеживает ВСЕ события из этой группы. Сюда попадают и 5760 (известный пользователь), и 5710 (несуществующий). Можно было написать<if_matched_sid>5760</if_matched_sid>, но тогда правило привяжется к одному конкретному rule_id. Если атакующий перебирает случайные имена (admin, test, root), его события попадут в правило 5710, иif_matched_sidдля 5760 его не увидит. Группа покрывает оба случая — нюанс, который часто упускают.<same_source_ip />— считать только события с одногоsrcip. Без этого тега Wazuh посчитает все неудачные логины от всех IP, что гарантирует ложные срабатывания на любом публичном сервере.<mitre><id>T1110.001</id></mitre>— маппинг на Password Guessing. Позволяет фильтровать в дашборде поrule.mitre.idи упрощает threat hunting.
Чем это отличается от дефолтного 5763? Контроль. Вы можете менять frequency (5 попыток для критичных серверов, 20 для тестовых), timeframe (30 секунд для aggressive detection, 300 для мягкого) и привязывать Active Response к конкретному rule_id. Дефолтное правило таких настроек не даёт.
Нюанс, который сбивает с толку при первом знакомстве: когда правило 100100 сработает, в дашборде алерт появится с группой из вашего тега <group>, а не с authentication_failed. Группа authentication_failed — фильтр на входе. Группа правила — метка на выходе.
Детект password spraying: кастомные правила Wazuh вместо дефолтных
Password spraying — подбор одного пароля по списку пользователей. Это противоположность классического брутфорса. Атакующий берёт распространённый пароль (Summer2025!, P@ssw0rd) и пробует его на десятках аккаунтов. Такой подход обходит политики блокировки учётных записей (account lockout), потому что каждый аккаунт видит только одну неудачную попытку. Дефолтные правила с same_source_ip + привязкой к одному пользователю тоже молчат.
Для детекта нужен тег <different_user />: он считает совпадения, только если поле dstuser меняется от события к событию.
<group name="local,sshd,">
<rule id="100110" level="13" frequency="5" timeframe="180">
<if_matched_group>authentication_failed</if_matched_group>
<same_source_ip />
<different_user />
<description>Password spraying: 5+ different users from same IP</description>
<mitre>
<id>T1110</id>
</mitre>
</rule>
</group>
Отличия от правила брутфорса:
level="13"— критический уровень. Password spraying опаснее обычного подбора: атакующий целенаправленно ищет слабое звено среди пользователей, и если у кого-то пароль совпал — вы узнаете об этом последним.frequency="5"— пять разных пользователей за 180 секунд. Порог ниже, потому что spraying по определению затрагивает множество аккаунтов.<different_user />— ключевой тег. Требует, чтобыdstuserбыл РАЗНЫМ в каждом из подсчитанных событий. Без него правило не отличит spraying от обычного подбора пароля к одному аккаунту.- T1110 (Brute Force без подтехники .001) — spraying покрывается родительской техникой в MITRE ATT&CK.
Я проверил русскоязычные руководства по Wazuh на selectel.ru, skillfactory.ru и habr.com — ни одно не описывает different_user для SSH-контекста. Этот сценарий остаётся gap, который стоит закрыть.
Ещё один полезный паттерн для настройки Wazuh правил — тег <time>10:00 pm - 6:00 am</time> в правиле, наследующем от 5715 (успешный SSH-логин). Он поднимает уровень алерта для входов в нерабочее время. Работает как дополнительный фильтр, не требует отдельного threshold.
Настройка и тестирование правил Wazuh: logtest и Hydra
Правила написаны — теперь нужно убедиться, что они работают до деплоя в продакшен. Не «должны работать по логике», а реально сработали на тестовом событии.
Шаг 1: проверка синтаксиса XML. На Wazuh-сервере выполните sudo /var/ossec/bin/wazuh-analysisd -t. Если XML сломан (незакрытый тег, дублирующий rule_id), утилита покажет номер строки с ошибкой. При успехе ожидайте строку Configuration validation completed successfully. Самая частая ошибка — пропущенный </rule> или </group>. Если менеджер не стартует после редактирования: grep -iE "error|critical" /var/ossec/logs/ossec.log | tail.
Шаг 2: тест через wazuh-logtest. Запустите sudo /var/ossec/bin/wazuh-logtest и вставьте строку лога из auth.log. Вставьте ту же строку 6+ раз подряд. После шестой вставки вместо правила 5760 (level 5) должно сработать ваше правило 100100 (level 10). Если этого не произошло — проверьте: есть ли группа authentication_failed в Phase 3 для каждой строки, не дублируется ли rule_id с другим правилом, правильно ли указан if_matched_group. Частая ловушка: правило с frequency требует именно if_matched_sid или if_matched_group, а не if_sid. Это разные вещи, и путаница между ними — источник часа бесполезной отладки.
Шаг 3: перезапуск менеджера. sudo systemctl restart wazuh-manager. Правила вступают в силу немедленно для всех подключённых агентов.
Шаг 4: эмуляция атаки. На отдельной машине (Kali Linux или любой Linux) установите Hydra (sudo apt install -y hydra), создайте текстовый файл с 10 случайными паролями и запустите: sudo hydra -t 1 -l root -P /tmp/passwords.txt <IP_АГЕНТА> ssh. Опция -t 1 — один поток, что даёт предсказуемый порядок записей в логе. Учтите параметр MaxAuthTries в sshd_config целевого хоста (по умолчанию 6): OpenSSH разрывает соединение после этого числа попыток в рамках одной TCP-сессии, поэтому Hydra откроет несколько соединений, и реальное количество строк Failed password в auth.log может отличаться от числа паролей в файле. После атаки в дашборде Wazuh (Threat Hunting → Events) появятся алерты. Фильтруйте по rule.id: 100100.
Как понять, что правило сработало: в /var/ossec/logs/alerts/alerts.json появится запись с "rule": {"id": "100100", "level": 10} и полем srcip с IP атакующей машины. Для теста spraying замените -l root на -L /tmp/usernames.txt (файл со списком пользователей) — правило 100110 должно сработать.
Хорошая практика — хранить local_rules.xml в Git. При обновлении Wazuh кастомные правила не перезаписываются, но иметь историю изменений и возможность отката — разумная предосторожность. Я видел случаи, когда человек правил XML руками, ломал синтаксис и не мог вспомнить, что было до правки.
Wazuh Active Response SSH: автоблокировка IP при атаке
Детекция без реагирования — половина работы. Wazuh Active Response позволяет автоматически выполнять скрипт на агенте при срабатывании конкретного правила. Для SSH-атак есть готовый скрипт firewall-drop в /var/ossec/active-response/bin/: он добавляет IP атакующего в iptables.
Настройка в /var/ossec/etc/ossec.conf на сервере — два блока. Блок <command> определяет скрипт: <name>firewall-drop</name>, <executable>firewall-drop</executable>, <timeout_allowed>yes</timeout_allowed> (временная блокировка). Блок <active-response> связывает команду с правилом: <command>firewall-drop</command>, <location>local</location> (выполнить на агенте, где произошло событие), <rules_id>100100</rules_id> (привязка к нашему кастомному правилу, не к дефолтному 5763), <timeout>180</timeout> (разблокировать через 3 минуты).
После добавления конфигурации — sudo systemctl restart wazuh-manager.
Верификация: повторите атаку через Hydra, затем ping <IP_АГЕНТА> с атакующей машины. Ожидаемый результат — 100% packet loss в течение 180 секунд. По истечении таймаута связь восстановится. Лог блокировки пишется в /var/ossec/logs/active-responses.log на агенте. Правила группы active_response (диапазон 650–659, например 651 — active-response: start) автоматически создают алерт при срабатывании. Его видно в дашборде по фильтру rule.groups: active_response.
Часто спрашивают: зачем Active Response, если есть fail2ban? Fail2ban решает ту же задачу (блокировка IP после неудачных SSH-логинов), но работает локально на одном хосте. Wazuh собирает события со всех агентов централизованно — и позволяет детектировать распределённую атаку, когда один IP сканирует SSH на десяти серверах по очереди. Fail2ban на каждом сервере увидит по 2–3 попытки (ниже порога), а Wazuh — все 30. В контексте импортозамещения Wazuh удобен как open-source SIEM: лицензия GNU GPL v2, нет вендорской зависимости, правила в XML без проприетарных форматов.
В продакшене таймаут 180 секунд может быть слишком мягким. Для серверов с чувствительными данными имеет смысл увеличить до 3600 (1 час). Дополнительный слой — AbuseIPDB (публичная база злоупотреблений по IP-адресам, категория #22 SSH): если abuseConfidenceScore выше 75, это повод для перманентного бана через CDB-список Wazuh. Но предварительно исключите Tor exit nodes, CGNAT-диапазоны и известные cloud ASN — иначе заблокируете половину легитимных пользователей.
Дефолтные правила — стартовая точка, не финиш. На инфраструктурах в 50–200 эндпоинтов главная проблема не в отсутствии алертов, а в их бесполезности. Level 5 за каждый Failed password генерирует тысячи записей в день, и SOC-аналитик отключает уведомления за первую неделю. OWASP ставит Security Logging and Monitoring Failures на девятое место в Top 10 (A09:2021): формулировка «auditable events not logged, warnings not generated» — это не про отсутствие логов, а про отсутствие правильных логов. Три XML-блока в local_rules.xml — и поток бессмысленных алертов падает на порядок, а полезных растёт. SOC-аналитик, умеющий писать правила, стоит в два раза дороже того, кто просто смотрит в дашборд — и это не метафора, а реальная разница в офферах. Если хочешь пройти базу SOC и blue team системно — на IB Basics в Codeby показывают, как делать первые задачи без требования «знать Linux на уровне X».
Эту тему и смежные навыки разбирают на практике в курсе «Аналитик SOC» Codeby Academy.
