Управление ожиданием в синхронном режиме
В синхронном режиме сервер 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 не останавливает проверку. Её результаты позднее будут доступны в журнале. |
Эта страница была полезна?
Спасибо за отзыв!
Спасибо, мы учтём это для улучшения документации.