Управление ожиданием в синхронном режиме

В синхронном режиме сервер ICAP/API после успешной передачи файла в обработку ожидает вердикт. Максимальное время ожидания настраивается в общих параметрах пассивного сбора.

Время ожидания отсчитывается от завершения постановки задач на сканирование во все цепочки до получения результатов. Время загрузки файла в хранилище и постановки задач в этот интервал не входит.

Для одиночных файлов по 1 цепочке:

  • Если сервер дождался вердикта за обозначенное время - стандартная логика, в клиента отдается вердикт (логику и формат отдачи - см. по ссылкам с основной информацией).

  • Если сервер не дождался вердикта за обозначенное время - в клиента отдается настроенный вердикт (см. про параметр тут {mp-passive} ) и соответствующий ему status code - логику и формат отдачи вердиктов - см. в разделах

  • Если итоговый вердикт равен Disinfected и для источника включён возврат очищенного файла (return_disinfected_file = true), вместе с результатом проверки клиенту возвращается очищенный файл.

  • Если return_disinfected_file = false, вердикт Disinfected мутирует в Malicious, очищенный файл клиенту не возвращается.

Для одиночных файлов по N цепочкам:

Поведение зависит от настройки return_disinfected_file.

  • Если return_disinfected_file = false, сервер может завершить ожидание досрочно при получении терминального вердикта (Malicious, Danger). В остальных случаях сервер ожидает результаты всех цепочек либо истечения времени ожидания.

  • После получения всех вердиктов сервер возвращает итоговый вердикт согласно стандартной логике. (см. Вердикты) При этом Disinfected во внешнем ответе мутирует в Malicious, очищенный файл не возвращается.

  • Если return_disinfected_file = true, сервер ожидает результаты всех цепочек либо истечения времени ожидания. Досрочное завершение по первому «плохому» вердикту в этом режиме не выполняется.

  • Наличие Disinfected в одной цепочке не гарантирует итоговый Disinfected. Очищенный файл возвращается только в том случае, если итоговый вердикт равен Disinfected.

  • Если сервер не дождался вердикта за обозначенное время - в клиента отдается результат сложения (Вердикты) удачно полученных вердиктов по M файлов из N цепочек И настроенного вердикта (см. Пассивный сбор файлов. Общие параметры) и соответствующий полученному результату status code (логику и формат отдачи вердиктов - см. разделы:

Для архивов по N цепочкам:

  • Если сервер дождался вердикта за обозначенное время (дождался хоть одного "плохого" или все оказались "хорошими") - стандартная логика, в клиента отдается "самый плохой (первый плохой, если встретился)" (Вердикты) вердикт (логику и формат отдачи - см. по ссылкам с основной информацией).

  • Если сервер НЕ дождался вердикта за обозначенное время - в клиента отдается результат сложения (см. Вердикты) удачно полученных вердиктов по M файлов из N цепочек И настроенного вердикта (см. Пассивный сбор файлов. Общие параметры) и соответствующий полученному результату status code (логику и формат отдачи вердиктов - см. разделы:

Для всех случаев:

Истечение времени ожидания на сервере ICAP/API не останавливает проверку. Её результаты позднее будут доступны в журнале.