WAF#

Защищает веб-приложения на уровне L7: анализирует HTTP-запросы, поступающие на балансировщик нагрузки, и блокирует веб-атаки из категорий OWASP Top 10 до того, как запрос будет передан проксируемому серверу. Запросы проверяются в поточном режиме: метод, URI и заголовки — сразу после получения заголовка запроса, а тело — по мере его поступления.

WAF использует встроенный набор правил, который выявляет распространенные классы атак: SQL-инъекции, межсайтовый скриптинг (XSS), удаленное выполнение кода (RCE), включение локальных файлов (LFI) и внедрение серверных шаблонов (SSTI). Правила применяются к пути и аргументам запроса, к cookie, а также к телу запроса в форматах JSON и XML. Набор правил входит в поставку Angie ADC; в текущей версии его нельзя изменить или дополнить.

По умолчанию запрос, в котором обнаружена атака, отклоняется с кодом ответа 403. В режиме мониторинга (директива waf_monitoring) WAF по-прежнему анализирует все запросы, но пропускает их к проксируемому серверу.

Порядок включения WAF в веб-интерфейсе описан в разделе Защита веб-приложений (WAF).

Пример конфигурации#

WAF блокирует атаки на приложение, работает в режиме мониторинга для API и записывает результаты проверки в отдельный журнал:

log_format waf '$remote_addr [$time_local] "$request" $status '
               'waf_found=$waf_found waf_blocked=$waf_blocked';

server {
    listen 80;
    server_name example.com;

    access_log /var/log/angie-lb/waf.log waf;

    waf_mode on;

    location / {
        proxy_pass http://app;
    }

    location /api/ {
        waf_monitoring on;
        proxy_pass http://api;
    }
}

Директивы#

waf_mode#

Синтаксис

waf_mode on | off;

По умолчанию

waf_mode off;

Контекст

http, server, location

Включает или отключает проверку запросов с помощью WAF. WAF проверяет запросы, обрабатываемые в блоке с этой директивой и во вложенных в него блоках, где директива не переопределена.

waf_monitoring#

Синтаксис

waf_monitoring on | off;

По умолчанию

waf_monitoring off;

Контекст

http, server, location

Включает режим мониторинга: запросы с обнаруженными атаками не блокируются, а только отмечаются в переменной $waf_found. Действует только там, где включена директива waf_mode.

waf_zone#

Синтаксис

waf_zone имя размер;

По умолчанию

—

Контекст

http

Задает имя и размер зоны разделяемой памяти, в которую загружаются правила WAF. Минимальный размер зоны — 8 страниц памяти.

Зона размером 64 Мбайт уже задана в конфигурации Angie ADC по умолчанию; этого достаточно для встроенного набора правил, поэтому директиву обычно не требуется изменять.

Встроенные переменные#

Переменные заполняются после проверки заголовка запроса и уточняются по мере проверки тела, поэтому их рекомендуется использовать в журнале запросов (директивы log_format и access_log). Если запрос не проверялся WAF, значения переменных пустые.

$waf_found#

1, если в запросе обнаружена атака, иначе 0. Заполняется как в режиме блокирования, так и в режиме мониторинга.

$waf_blocked#

1, если запрос был заблокирован WAF, иначе 0. В режиме мониторинга всегда имеет значение 0.