Пaраметр robot_mitigation (util_robot_mitigation)#

Группа параметров robot_mitigation предназначена для противодействия роботам, отправляющим HTTP запросы, а также сканированию портов. Принцип работы основан на отправке клиенту ответов на его запросы, которые должны быть интерпретированы клиентом требуемым образом, для того чтобы модуль мог определить допустимую активность.

Обязательные параметры:

• enabled

  Обязательный параметр. включает защиту от атак HTTP-роботов.

  Тип параметра:

  • true;

  • false.

  По умолчанию:

  enabled: false
  

Опциональные параметры:

• blacklist

  В значении параметра указывается число неудачных обращений к серверу, при превышении которого клиент будет внесен в blacklist.

  Тип параметра: целочисленное значение.

  По умолчанию:

  blacklist: 5
  

• blacklist

  В значении параметра указывается число неудачных обращений к серверу, при превышении которого клиент будет внесен в blacklist.

  Тип параметра: целочисленное значение.

  По умолчанию:

  blacklist: 5
  

• mode

  Если js выбрано, robot_mitigation вернет определенный пользователем javascript-код для клиента. Если в браузере клиента включен javascript, он инициирует новый запрос.

  Если выбрано swf, robot_mitigation вернет предопределенный флеш-файл клиенту. Если плагин Flash установлен в браузере клиента, он запустит этот файл флэш и инициирует новый запрос.

  Тип параметра:

  • js;

  • swf.

  По умолчанию:

  mode: js
  

• timeout

  В значении параметра устанавливается время для запуска следующей задачи в секундах.

  Тип параметра: целочисленное значение.

  По умолчанию:

  timeout: 60
  

• ajax

  Подключение возможности использования задач с использованием AJAX (на основе заголовка XMLRequest).

  Тип параметра:

  • true;

  • false.

  По умолчанию:

  ajax: false
  

• policy_type

  В значении параметра задается тип политики.

  Тип параметра:

  • allow - действие будет выполняться для ip в exclude_ip;

  • forbid - действие будет выполнено для всех ip, кроме ip в exclude_ip.

  По умолчанию:

  policy_type: forbid
  

• exclude_ip

  В значении параметра устанавливаются значения ip, исключаемые из whitelist.

  Пример:

  exclude_ip:
    - 2.x.x.x/2
    - 192.x.x.x
  

  Тип параметра: последовательность строковых значений.

  По умолчанию: не имеет значения по умолчанию.

• ua_whitelist

  В значении параметра определяется белый список User-Agent.

  Пример:

  ua_whitelist:
    - user_agent1
    - user_agent2
  

  Тип параметра: последовательность строковых значений.

  По умолчанию: не имеет значения по умолчанию.

Пример:

robot_mitigation:
  enabled: true
  blacklist: 5
  mode: js
  timeout: 60
  ajax: true
  exclude_ip:
  - 2.x.x.x/2
  - 192.x.x.x
  ua_whitelist:
  - user_agent1
  - user_agent2