Критерии для пулов СЗИ

Критерии определяют, в какие пулы СЗИ цепочки направлять файл. Например, файл, соответствующий одному набору условий, можно направить в пул «А», а файл с другими характеристиками — в пул «В».

Выберите пул СЗИ по пиктограмме icon checkbox 22 и откройте настройку критериев по пиктограмме icon settings 22. Критерий добавляется по пиктограмме icon add 22 и удаляется по пиктограмме icon delete 22.

criteria 0001 22

Для каждого пула можно задать свой набор критериев. Критерии одного пула соединяются оператором И: файл направляется в пул, только если выполнены все заданные условия.

Атрибуты критерия

Каждый критерий содержит поля Тип, Условие и, в зависимости от их значений, Переменная (путь) и Значение.

ПолеКогда заполняетсяНазначение

Тип

Всегда

Определяет, какое свойство файла или spec-переменная сравнивается с условием.

Переменная (путь)

Если тип — Custom

Имя spec-переменной в формате $PARAM, которая читается из глобального регистра этапа анализа.

Условие (оператор сравнения)

Всегда

Определяет способ сравнения; операторы приведены в следующем разделе.

Значение

Кроме условий «Существует», «Не существует», «Пустой» и «Не пустой»

Вводится вручную. Для размера файла задаётся в байтах.

В поле Тип доступны:

  • Размер файла (fsize) — статический критерий, spec-переменная $FILE_SIZE.

  • Имя файла (fname) — статический критерий, spec-переменная $FILE_NAME.

  • MIME-тип файла (ftype) — статический критерий, spec-переменная $FILE_MIME_TYPE.

  • Вердикт (verdict) — вычисляемый критерий, spec-переменная $FILE_VERDICT с результатом последнего успешного сканирования в СЗИ при последовательной проверке. При параллельной проверке такого значения нет.

  • Custom (custom) — spec-переменная, указанная вручную в поле Переменная (путь); её значение читается из глобального регистра этапа анализа.

Описание spec-переменных приведено в разделе Создание СЗИ.

Локальный регистр хранит spec-переменные только во время прохождения файла через конкретное СЗИ. Глобальный регистр действует на протяжении этапа анализа — пока файл проходит все пулы СЗИ цепочки. Если в Custom-критерии указана встроенная spec-переменная, она содержит статическое значение; такой критерий допускается там, где вычисляемые критерии запрещены.

Операторы сравнения

УсловиеКодКак проверяется значение

Равно

eq

Строго равно введённому значению.

Не равно

neq

Не равно введённому значению.

Больше

gt

Строго больше введённого значения.

Меньше

lt

Строго меньше введённого значения.

Существует

exists

Соответствующая spec-переменная существует в глобальном регистре; её значение не проверяется.

Не существует

not_exists

Соответствующей spec-переменной нет в глобальном регистре.

Пустой

empty

Spec-переменная существует и хранит пустую строку.

Не пустой

not_empty

Spec-переменная существует и хранит непустую строку.

Содержит

in

Значение, представленное списком с разделителями , или ;, содержит элементы, указанные во введённом списке.

Регулярное выражение

regex

Значение соответствует введённому регулярному выражению.

Маска

mask

Значение соответствует введённой маске, например *.txt для файлов TXT.

Для типа Размер файла операторы «Равно», «Не равно», «Больше» и «Меньше» сравнивают числа; для остальных типов — строки.

Правила выбора пула при анализе

Параллельный анализ

Критерии пулов проверяются перед запуском анализа во всех пулах цепочки. Доступны только статические критерии: размер, имя и MIME-тип файла. Динамический критерий в параллельном режиме вызывает ошибку валидации, поскольку пулы запускаются одновременно и не могут зависеть от результата предыдущего пула.

Исключение — Custom-критерий со встроенной spec-переменной: её значение статично, поэтому ошибки не будет. Подробнее о встроенных переменных — в разделе Создание СЗИ.

Пример выбора пула. Для пула «А» задайте критерий «Имя файла — Маска — *.txt», а для пула «В» — «MIME-тип файла — Равно — application/pdf». Система проверит оба критерия до запуска пулов и выберет подходящие для файла.

Последовательный анализ

В начале анализа глобальный регистр содержит только встроенные spec-переменные. После каждого успешно пройденного пула он дополняется новыми переменными или обновляет существующие, если они пересекаются между СЗИ.

Для первого пула используйте только статические критерии — размер, имя или MIME-тип файла. Вычисляемые переменные на этом этапе ещё не существуют и приведут к ошибке. Исключение — Custom-критерий со встроенной spec-переменной, содержащей статическое значение.

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

Пример выбора пула. Для первого пула «А» задайте статический критерий «Размер файла — Меньше — 10485760» (значение в байтах). Для следующего пула «В» задайте критерий «Вердикт — Равно — Clean». Пул «В» начнёт проверку только после успешного прохождения предыдущего пула и при вердикте Clean.

Начиная с версии 2.2, блокирующие вердикты Malicious и Dangerous не прерывают последовательную обработку: это позволяет передать файл в CDR-пул для очистки. Чтобы избежать лишних запусков последующих СЗИ, для пулов, кроме CDR, рекомендуется ограничить запуск результатами Clean или Disinfected предыдущей проверки. Для CDR-пулов такое ограничение не рекомендуется: CDR может обработать потенциально опасный файл и сформировать очищенную версию.

Несколько критериев одного пула соединяются оператором И. Два условия «Вердикт — Равно» с разными значениями в одном пуле не реализуют выбор «Clean или Disinfected».

Порядок проверки и отсутствие подходящих пулов

  1. Scanner получает задачу из to-scan, загружает цепочку и scanner specifications, затем валидирует критерии пулов.

  2. Создаётся глобальный регистр с начальными данными файла. До работы лимитера выполняется статическая фильтрация: для пулов, не подходящих по критериям файла, лимит инстанса сканера не занимается.

  3. Если подходящих пулов не осталось, scanner возвращает ErrNoMatchingScannerPools. Consumer распознаёт её как terminal case, удаляет запись из active journal, добавляет в DLQ-ошибку метаинформацию о файле, отправляет исходное сообщение в DLQ и завершает обработку через terminal ACK.

  4. Если пулы остались, scanner получает лимиты только для них и выполняет последовательный или параллельный анализ. В последовательном режиме перед каждым пулом дополнительно проверяются динамические критерии.

  5. Если хотя бы один scanner отработал или найден cached result, файл считается сканированным.

Обработка ошибок

Если переключатель «Передавать файл и отчёт дальше в случае ошибок» включён:

  • при параллельном анализе статические критерии проверяются, после чего действует общая логика обработки ошибок анализа файлов;

  • при последовательном анализе ошибка в одном пуле не прерывает цепочку; вместо отчёта от СЗИ приходит заглушка с ошибкой. Если критерий следующего пула зависит от результата пула с ошибкой, в следующем пуле также может возникнуть ошибка.

Если переключатель выключен, при ошибке задача отправляется на повторное выполнение или в DEAD-letter в зависимости от типа ошибки. При последовательном анализе критерии последующих пулов уже не применяются; при параллельном анализе после проверки статических критериев задача при ошибке отправляется на повторное выполнение и запускается заново.