Перейти к содержанию

Настройка 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.