LogLevel

{уровень подробности}

Уровень подробности ведения журнала компонента.

Если значение параметра не указано, используется значение параметра DefaultLogLevel из секции [Root].

Значение по умолчанию: Notice

Log

{тип журнала}

Метод ведения журнала компонента.

Значение по умолчанию: Auto

ExePath

{путь к файлу}

Путь к исполняемому файлу компонента.

Значение по умолчанию: <opt_dir>/bin/drweb-icapd.

•Для GNU/Linux: /opt/drweb.com/bin/drweb-icapd.

•Для FreeBSD: /usr/local/libexec/drweb.com/bin/drweb-icapd

RunAsUser

{UID | имя пользователя}

Пользователь. Можно указать как числовой UID пользователя, так и его имя (логин). Если имя пользователя состоит из цифр (т. е. похоже на числовой UID), то оно указывается с префиксом «name:», например: RunAsUser = name:123456.

Если имя пользователя не указано, работа компонента завершается ошибкой сразу после попытки запуска.

Значение по умолчанию: drweb

Start

{логический}

Компонент должен быть запущен демоном управления конфигурацией Dr.Web ConfigD.

Установка данного параметра в Yes предписывает демону управления конфигурацией немедленно попытаться запустить компонент, а установка его в значение No — немедленно завершить работу компонента.

Значение по умолчанию: No

DebugDumpIcap

{логический}

Сохранять в журнал содержимое сообщений, передаваемых по протоколу ICAP, если уровень подробности ведения журнала — отладочный (при LogLevel = DEBUG).

Значение по умолчанию: No

ListenAddress

{сетевой сокет}

Определяет сетевой сокет (IP-адрес и порт), прослушиваемый Dr.Web ICAPD в ожидании подключений от прокси-серверов HTTP.

Значение по умолчанию: 127.0.0.1:1344

UsePreview

{логический}

Включить или отключить режим ICAP preview для Dr.Web ICAPD.

Не изменяйте значение этого параметра без необходимости.

Значение по умолчанию: Yes

Use204

{логический}

Возвращать код ответа 204 не только в режиме ICAP preview.

Не изменяйте значение этого параметра без необходимости.

Значение по умолчанию: Yes

AllowEarlyResponse

{логический}

Определяет, может ли Dr.Web ICAPD использовать режим «раннего» ответа ICAP, т. е. начинать отправлять ответ клиенту, не прочитав до конца запрос от прокси-сервера HTTP.

Не изменяйте значение этого параметра без необходимости.

Значение по умолчанию: Yes

TemplatesDir

{путь к каталогу}

Путь к каталогу c файлами шаблонов HTML-страниц уведомлений о блокировке веб-ресурсов.

Значение по умолчанию: <var_dir>/templates/icapd.

•Для GNU/Linux: /var/opt/drweb.com/templates/icapd.

•Для FreeBSD: /var/drweb.com/templates/icapd

Whitelist

{список доменов}

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

Значения в списке указываются через запятую (каждое значение в кавычках). Допускается повторение параметра в секции (в этом случае все значения объединяются в единый список).

Пример: Добавить в список домены example.com и example.net.

1.Добавление значений в файл конфигурации.

•Два значения в одной строке:

•Две строки (по одному значению в строке):

2.Добавление значений через команду drweb-ctl cfset:

Значение по умолчанию: (не задано)

Blacklist

{список доменов}

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

Значения в списке указываются через запятую (каждое значение в кавычках). Допускается повторение параметра в секции (в этом случае все значения объединяются в единый список).

Пример: Добавить в список домены example.com и example.net.

1.Добавление значений в файл конфигурации.

•Два значения в одной строке:

•Две строки (по одному значению в строке):

2.Добавление значений через команду drweb-ctl cfset:

Значение по умолчанию: (не задано)

Adlist

{список строк}

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

Значения в списке указываются через запятую (каждое значение в кавычках). Допускается повторение параметра в секции (в этом случае все значения объединяются в единый список).

Пример: Добавить в список выражения '.*ads.+' и '.*/ad/.*\.gif$'.

1.Добавление значений в файл конфигурации.

•Два значения в одной строке:

•Две строки (по одному значению в строке):

2.Добавление значений через команду drweb-ctl cfset:

Регулярные выражения записываются с использованием синтаксиса POSIX (BRE, ERE) или Perl (PCRE, PCRE2).

Значение по умолчанию: (не задано)

BlockInfectionSource

{логический}

Блокировать попытки подключения к веб-сайтам, содержащим вредоносное ПО (входящим в категорию InfectionSource).

Для реальной блокировки необходимо, чтобы в настройках присутствовало правило вида (см. ниже):

Значение по умолчанию: Yes

BlockNotRecommended

{логический}

Блокировать попытки подключения к нерекомендуемым веб-сайтам (входящим в категорию NotRecommended).

Для реальной блокировки необходимо, чтобы в настройках присутствовало правило вида (см. ниже):

Значение по умолчанию: Yes

BlockAdultContent

{логический}

Блокировать попытки подключения к веб-сайтам, содержащим материалы для взрослых (входящим в категорию AdultContent).

Для реальной блокировки необходимо, чтобы в настройках присутствовало правило вида (см. ниже):

Значение по умолчанию: No

BlockViolence

{логический}

Блокировать попытки подключения к веб-сайтам, содержащим сцены насилия (входящим в категорию Violence).

Для реальной блокировки необходимо, чтобы в настройках присутствовало правило вида (см. ниже):

Значение по умолчанию: No

BlockWeapons

{логический}

Блокировать попытки подключения к веб-сайтам, посвященным оружию (входящим в категорию Weapons).

Для реальной блокировки необходимо, чтобы в настройках присутствовало правило вида (см. ниже):

Значение по умолчанию: No

BlockGambling

{логический}

Блокировать попытки подключения к веб-сайтам, посвященным азартным играм и играм на деньги (входящим в категорию Gambling).

Для реальной блокировки необходимо, чтобы в настройках присутствовало правило вида (см. ниже):

Значение по умолчанию: No

BlockDrugs

{логический}

Блокировать попытки подключения к веб-сайтам, посвященным наркотикам (входящим в категорию Drugs).

Для реальной блокировки необходимо, чтобы в настройках присутствовало правило вида (см. ниже):

Значение по умолчанию: No

BlockObsceneLanguage

{логический}

Блокировать попытки подключения к веб-сайтам, содержащим нецензурную лексику (входящим в категорию ObsceneLanguage).

Для реальной блокировки необходимо, чтобы в настройках присутствовало правило вида (см. ниже):

Значение по умолчанию: No

BlockChats

{логический}

Блокировать попытки подключения к веб-сайтам чатов (входящим в категорию Chats).

Для реальной блокировки необходимо, чтобы в настройках присутствовало правило вида (см. ниже):

Значение по умолчанию: No

BlockTerrorism

{логический}

Блокировать попытки подключения к веб-сайтам, посвященным терроризму (входящим в категорию Terrorism).

Для реальной блокировки необходимо, чтобы в настройках присутствовало правило вида (см. ниже):

Значение по умолчанию: No

BlockFreeEmail

{логический}

Блокировать попытки подключения к веб-сайтам бесплатных почтовых служб (входящим в категорию FreeEmail).

Для реальной блокировки необходимо, чтобы в настройках присутствовало правило вида (см. ниже):

Значение по умолчанию: No

BlockSocialNetworks

{логический}

Блокировать попытки подключения к веб-сайтам социальных сетей (входящим в категорию SocialNetworks).

Для реальной блокировки необходимо, чтобы в настройках присутствовало правило вида (см. ниже):

Значение по умолчанию: No

BlockDueToCopyrightNotice

{логический}

Блокировать попытки подключения к веб-сайтам, ссылки на которые были добавлены по обращению правообладателей (входящим в категорию DueToCopyrightNotice).

Для реальной блокировки необходимо, чтобы в настройках присутствовало правило вида (см. ниже):

Значение по умолчанию: Yes

BlockOnlineGames

{логический}

Блокировать попытки подключения к веб-сайтам онлайн-игр (входящим в категорию OnlineGames).

Для реальной блокировки необходимо, чтобы в настройках присутствовало правило вида (см. ниже):

Значение по умолчанию: Yes

BlockAnonymizers

{логический}

Блокировать попытки подключения к веб-сайтам анонимайзеров (входящим в категорию Anonymizers).

Для реальной блокировки необходимо, чтобы в настройках присутствовало правило вида (см. ниже):

Значение по умолчанию: Yes

BlockCryptocurrencyMiningPools

{логический}

Блокировать попытки подключения к веб-сайтам, объединяющим пользователей с целью добычи (майнинга) криптовалют (входящим в категорию CryptocurrencyMiningPool).

Для реальной блокировки необходимо, чтобы в настройках присутствовало правило вида (см. ниже):

Значение по умолчанию: Yes

BlockJobs

{логический}

Блокировать попытки подключения к веб-сайтам для поиска работы.

Для реальной блокировки необходимо, чтобы в настройках присутствовало правило вида (см. ниже):

Значение по умолчанию: No

ScanTimeout

{интервал времени}

Тайм-аут на проверку одного файла по запросу Dr.Web ICAPD.

Допустимые значения: от 1 секунды (1s) до 1 часа (1h) включительно.

Значение по умолчанию: 30s

HeuristicAnalysis

{On | Off}

Использовать или не использовать эвристический анализ для поиска неизвестных угроз. Эвристический анализ повышает надежность проверки, но увеличивает ее длительность.

Реакция на срабатывание эвристического анализа задается в параметре BlockSuspicious.

Допустимые значения:

•On — использовать эвристический анализ при проверке;

•Off — не использовать эвристический анализ.

Значение по умолчанию: On

PackerMaxLevel

{целое число}

Максимальный уровень вложенности для запакованных объектов. Под запакованным объектом понимается исполняемый код, сжатый при помощи специализированных инструментов (UPX, PELock, PECompact, Petite, ASPack, Morphine и других). Такие объекты могут включать другие запакованные объекты, в состав которых тоже могут входить другие запакованные объекты, и т. п. Значение этого параметра устанавливает предельный уровень иерархии вложенности, после которого объекты внутри объектов не будут проверяться.

Ограничений уровня вложенности нет. Значение 0 указывает, что вложенные объекты не проверяются.

Значение по умолчанию: 8

ArchiveMaxLevel

{целое число}

Максимальный уровень вложенности для проверке архивов (.zip, .rar и т. п.), в которые вложены другие архивы, в которые, в свою очередь, могут быть вложены еще архивы, и т. п. Значение этого параметра устанавливает предельный уровень иерархии вложенности, после которого архивы внутри архивов не будут проверяться.

Ограничений уровня вложенности нет. Значение 0 указывает, что вложенные объекты не проверяются.

Значение по умолчанию: 0

MailMaxLevel

{целое число}

Максимальный уровень вложенности для файлов почтовых программ (.pst, .tbb и т. п.), в которые могут быть вложены объекты, в которые также могут вложены объекты, и т. п. Значение этого параметра устанавливает предельный уровень иерархии вложенности, после которого объекты внутри объектов не будут проверяться.

Ограничений уровня вложенности нет. Значение 0 указывает, что вложенные объекты не проверяются.

Значение по умолчанию: 0

ContainerMaxLevel

{целое число}

Максимальный уровень вложенности для других типов объектов c вложениями (например, страницы HTML, файлы .jar и т. п.). Значение этого параметра устанавливает предельный уровень иерархии вложенности, после которого объекты внутри объектов не будут проверяться.

Ограничений уровня вложенности нет. Значение 0 указывает, что вложенные объекты не проверяются.

Значение по умолчанию: 8

MaxCompressionRatio

{целое число}

Максимальная допустимую степень сжатия запакованных объектов (отношение сжатого объема к несжатому). Если степень сжатия объекта превысит указанную величину, он будет пропущен при проверке данных, инициированной по запросу Dr.Web ICAPD.

Величина степени сжатия должна быть не менее 2.

Значение по умолчанию: 500

BlockKnownVirus

{логический}

Блокировать получение и передачу данных, если они содержат известную угрозу.

Для реальной блокировки необходимо, чтобы в настройках присутствовало правило вида (см. ниже):

Значение по умолчанию: Yes

BlockSuspicious

{логический}

Блокировать получение и передачу данных, если они содержат неизвестную угрозу (обнаруженную эвристическим анализатором).

Для реальной блокировки необходимо, чтобы в настройках присутствовало правило вида (см. ниже):

Значение по умолчанию: Yes

BlockAdware

{логический}

Блокировать получение и передачу данных, если они содержат рекламную программу.

Для реальной блокировки необходимо, чтобы в настройках присутствовало правило вида (см. ниже):

Значение по умолчанию: Yes

BlockDialers

{логический}

Блокировать получение и передачу данных, если они содержат программу дозвона.

Для реальной блокировки необходимо, чтобы в настройках присутствовало правило вида (см. ниже):

Значение по умолчанию: Yes

BlockJokes

{логический}

Блокировать получение и передачу данных, если они содержат программу-шутку.

Для реальной блокировки необходимо, чтобы в настройках присутствовало правило вида (см. ниже):

Значение по умолчанию: No

BlockRiskware

{логический}

Блокировать получение и передачу данных, если они содержат потенциально опасную программу.

Для реальной блокировки необходимо, чтобы в настройках присутствовало правило вида (см. ниже):

Значение по умолчанию: No

BlockHacktools

{логический}

Блокировать получение и передачу данных, если они содержат программу взлома.

Для реальной блокировки необходимо, чтобы в настройках присутствовало правило вида (см. ниже):

Значение по умолчанию: No

BlockUnchecked

{логический}

Блокировать получение и передачу данных, если они не могут быть проверены.

Значение по умолчанию: No

MessageHook

{путь к файлу | функция Lua}

Скрипт обработки HTTP-сообщений на языке либо путь к файлу скрипта (см. раздел Обработка HTTP-сообщений на Lua).

Если функция Lua или путь к файлу не указаны, то сообщения будут обрабатываться в соответствии с правилами. Если указанный файл недоступен, то при загрузке компонента будет выдана ошибка.

Значение по умолчанию: Генерируется автоматически. Для настроек по умолчанию скрип выглядит так:

local dw = require "drweb"
local cfg = require "drweb.config"
local dwl = require "drweb.lookup"
local rx = require "drweb.regex"

function message_hook(ctx)
  if ctx.direction == "request" then
    local url = ctx.request.url
    if url.in_list(cfg.blacklist) then
      return "block"
    end
    if not url.in_list(cfg.whitelist) then
      if rx.search(cfg.adlist, url) or rx.search(cfg.adlist, url.raw) then
          return "block"
      end
      if url.in_categories(cfg.block_url_categories) then
          return "block"
      end
    end
  end
  if ctx.body.has_threat{category = cfg.block_threats} then
    return "block"
  end
  if cfg.block_unchecked and ctx.body.scan_error then
    return "block"
  end
  return "pass"
end