Настройка HTTP-кода ответа при блокировке (NGINX)¶
При блокировке запроса фильтрующей нодой ПроAPI Защита 2.0 можно настроить HTTP-код, который будет возвращён в ответе.
Для настройки используется директива NGINX wmx\_api\_block\_status\_code.
Настройка кода ответа¶
В качестве значения директивы можно указать HTTP-код из диапазона от 400 до 599 (все коды ошибок HTTP).
Синтаксис:
wmx\_api\_block\_status\_code \<HTTP\_CODE\>;
Например, чтобы при блокировке запроса возвращать код 451:
wmx\_api\_block\_status\_code 451;
После изменения конфигурации проверьте ее корректность и перезагрузите NGINX.
Поддерживаемые варианты поставки¶
Директива wmx\_api\_block\_status\_code поддерживается в следующих вариантах поставки фильтрующей ноды:
| Вариант поставки | Поддержка |
|---|---|
| Установка из RPM-пакета | Да |
| Запуск ноды в Docker-контейнере | Да |
Особенности для Docker¶
При использовании Docker-поставки директиву необходимо прописать в файле конфигурации NGINX, который находится внутри контейнера:
-
Подготовьте свой собственный конфигурационный файл NGINX с добавленной директивой.
-
Передайте файл в контейнер при запуске.
-
После изменения конфигурации перезагрузите NGINX или перезапустите контейнер в соответствии с принятой схемой развертывания.
Обратите внимание
Переменная окружения, соответствующая директиве wmx\_api\_block\_status\_code, отсутствует. Поэтому настроить HTTP-код с помощью параметров запуска контейнера нельзя – только через конфигурационный файл NGINX.