> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/guide/utility/antivirus.md). # Антивирус Антивирус iEXExchanger проверяет файлы клиентов и файлы установленного обменника. Он помогает отклонять опасные загрузки до сохранения и находить угрозы среди ранее сохранённых файлов. В разделе можно установить антивирус, проверить его работу, включить защиту клиентских загрузок, проверить отдельный файл и запустить фоновую проверку. Для поиска угроз используется ClamAV. Защита новых загрузок и проверка сохранённых файлов настраиваются отдельно. Включение проверки клиентов действует на последующие загрузки. Для проверки файлов, которые уже находятся на сервере, запустите фоновое задание. ### Где находится раздел В административной панели откройте: **«Утилиты» — «Антивирус»**
Кнопка «Проверить состояние» обновляет сведения об установке антивируса и работе его служб. Во время установки состояние обновляется автоматически. ### Права доступа Доступ к антивирусу регулируют права из блока «Админпанель»: * «Просмотр служб обменника» разрешает открыть страницу, просматривать состояние, историю фоновых проверок и сведения об угрозах. * «Управление службами обменника» дополнительно разрешает установить антивирус, менять настройки, выполнять самопроверку, проверять отдельные файлы и управлять фоновыми заданиями и мониторингом. Для открытия страницы достаточно одного из этих прав. При наличии только права просмотра действия управления недоступны. В режиме только чтения управление также недоступно. Право «Управление службами обменника» разрешает работу и с другими управляемыми службами обменника. Выдавайте его сотруднику, который отвечает за обслуживание сервера. Для настройки доступа откройте: **«Пользователи» — «Список групп пользователей»** 1. Откройте редактирование группы сотрудника. 2. Выберите блок «Админпанель». 3. Включите «Просмотр служб обменника» или «Управление службами обменника» в зависимости от задач сотрудника. 4. Нажмите «Сохранить изменения». 5. Войдите под учётной записью сотрудника и откройте «Антивирус». Проверьте, что состояние и история доступны, а действия управления соответствуют выданному праву. {% content-ref url="/pages/3OPChZoOwE8CnKr6Icyq" %} [Группы прав пользователей](/guide/polzovateli/gruppy-prav-polzovatelei.md) {% endcontent-ref %} *** ## Установка и самопроверка Антивирус устанавливается отдельно из административной панели. После установки проверка клиентских загрузок остаётся выключенной, пока администратор не включит и не сохранит её. ### Проверка текущего состояния В карточке антивируса отображается одно из состояний:
СостояниеЗначение
«Не установлен»Компоненты антивируса ещё не установлены полностью.
«Установлен, но службы не готовы»Компоненты установлены, но служба проверки файлов или обновления баз не работает.
«Готов к проверке»Антивирус установлен, обе службы работают. Связь обменника со сканером нужно подтвердить самопроверкой.
Рядом отдельно указано, включена ли проверка клиентов. Состояние «Готов к проверке» само по себе не означает, что новые клиентские загрузки уже защищены. ### Установка антивируса Если на сервере выполняется обновление или другое обслуживание, дождитесь его завершения перед установкой антивируса. {% hint style="warning" %} Во время установки применяются настройки серверной части обменника и перезапускается служба, обслуживающая её запросы. Возможен кратковременный перерыв в работе сайта или административной панели. Выберите время с небольшой нагрузкой. {% endhint %} 1. Нажмите «Установить антивирус». 2. Дождитесь окончания установки. На странице отображаются текущий этап и его состояние. 3. Убедитесь, что карточка показывает «Готов к проверке». 4. Выполните самопроверку перед включением защиты клиентов. Система устанавливает сканер, настраивает его связь с обменником и запускает службы проверки файлов и обновления баз. Процент показывает прохождение этапов установки и не определяет оставшееся время. Установка выполняется на сервере. Если закрыть страницу или потерять соединение с браузером, это не отменит принятую операцию. Откройте раздел снова и проверьте её состояние. Если компоненты уже установлены, но службы не готовы, на странице доступна кнопка «Повторить настройку». Перед её использованием проверьте состояние служб по инструкции ниже. ### Самопроверка Самопроверка подтверждает, что обменник может обратиться к сканеру и правильно получить результат. 1. В блоке «Самопроверка» нажмите «Запустить самопроверку». 2. Дождитесь ответа. 3. Проверьте, что и для «Безопасный файл», и для «Тестовая угроза» указано «Успешно». Для теста используются безопасный файл и специальный образец EICAR, предназначенный для проверки обнаружения угроз. Образец не запускается, а временные тестовые файлы удаляются после проверки. Самостоятельно загружать вирусы для проверки работы антивируса не требуется. Если хотя бы один результат показывает «Ошибка», сначала устраните проблему. При сохранении включённой защиты клиентов система повторно проверяет работу обеих служб и выполняет самопроверку. Если проверка не пройдена, защита не включится. ## Проверка файлов клиентов При включённой защите оригинал файла проверяется до сохранения. Файл с обнаруженной угрозой отклоняется. Если сканер не смог выдать результат, загрузка также блокируется. ### Какие загрузки проверяются Защита подключена к следующим загрузкам: * чеки и подтверждения оплаты, прикрепляемые к заявке; * вложения в чате заявки; * фотографии для верификации банковской карты; * фотографии и документы для ручной верификации личности; * файлы в дополнительных полях клиентских форм; * клиентские файлы, загружаемые через публичный API iEXExchanger. Изображения из этих загрузок проверяются, если включён отдельный переключатель «Проверять фото и изображения». Разрешённые форматы и размеры зависят от конкретной формы загрузки. Включение антивируса не расширяет список допустимых файлов. ### Настройки защиты В блоке «Проверка файлов клиентов» находятся два переключателя. **«Проверять клиентские файлы»** включает антивирусную проверку новых клиентских загрузок. По умолчанию выключен. При включении заражённый файл или ошибка сканера блокируют загрузку. **«Проверять фото и изображения»** включает проверку изображений, включая фотографии для верификации. По умолчанию включён, но действует только вместе с «Проверять клиентские файлы». Если выключить проверку изображений, документы продолжат проверяться при включённой общей защите, а изображения будут пропускать эту антивирусную проверку. Настройки общие для всей установки обменника. Изменения одного администратора применяются и к загрузкам, с которыми работают другие сотрудники. ### Включение защиты 1. Убедитесь, что антивирус показывает «Готов к проверке» и самопроверка проходит успешно. 2. Включите «Проверять клиентские файлы». 3. Оставьте включённым «Проверять фото и изображения», если нужна защита фотографий и других разрешённых изображений. 4. Нажмите «Сохранить настройки» в блоке «Проверка файлов клиентов». 5. Дождитесь сообщения «Настройки антивируса сохранены.» и проверьте, что в карточке указано «Проверка клиентов включена». {% hint style="warning" %} После включения защиты недоступность сканера приводит к отказу в приёме проверяемых файлов. При проблемах с загрузкой проверьте работу антивируса: отсутствие результата не считается подтверждением безопасности файла. {% endhint %} Чтобы отключить эту защиту, выключите «Проверять клиентские файлы» и нажмите «Сохранить настройки». Ручные и фоновые проверки, а также настройка ежедневного мониторинга управляются отдельно. Другие ограничения и отдельно настроенные правила проверки файлов продолжают действовать. ### Что увидит клиент при отказе При обычной успешной проверке файл проходит дальнейшую обработку формы. Отдельного действия от клиента не требуется. При отказе система сообщает причину: * «Файл не принят: антивирус обнаружил угрозу.» — файл отклонён. Попросите клиента предоставить безопасный файл. * «Файл имеет небезопасную или повреждённую структуру.» — содержимое файла не прошло дополнительную проверку формата. Попросите повторно сформировать документ или изображение; простое изменение расширения не исправляет содержимое. * «Проверка файла временно недоступна. Повторите загрузку позже.» — результат сканирования не получен. Администратору нужно восстановить работу сканера, после чего клиент сможет повторить загрузку. Кроме поиска угроз, при включённой проверке контролируется структура поддерживаемых изображений и PDF. Поэтому загрузка может быть отклонена, даже если сканер не сообщил об угрозе. Зашифрованный PDF или файл, превышающий внутренние пределы анализа ClamAV, также может вызвать срабатывание. Уточните причину по результату проверки; для защищённого PDF запросите у клиента документ без пароля. ## Ручная проверка отдельного файла Ручная проверка подходит, когда нужно проверить один файл перед использованием. Она доступна после установки антивируса и работает независимо от переключателя проверки клиентских загрузок. 1. В блоке «Проверить файл вручную» выберите один файл размером до 20 МБ. 2. Нажмите «Проверить файл». 3. Дождитесь результата. Файл передаётся для проверки, но не сохраняется в хранилище приложения как клиентское вложение. Результат отображается в этом же блоке. | Результат | Что означает | | ------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | | «Угроз не обнаружено.» | Сканер проверил файл и не обнаружил угроз. | | «Антивирус обнаружил угрозу. Не используйте этот файл.» | Файл вызвал срабатывание. Если сканер вернул название угрозы, оно указано рядом с результатом. | | «Сканер недоступен. Результат проверки неизвестен.» | Подтверждённого результата нет. Восстановите работу сканера и повторите проверку. | | «Проверка не была выполнена.» | Файл не получил результат сканирования. Его безопасность не подтверждена. | После отправки выбранный файл сбрасывается. Для повторной проверки выберите его снова. Ручная проверка ищет угрозы через антивирус. Допустимость формата, размер и структура файла дополнительно проверяются в соответствующей клиентской форме. Успешный ручной результат не отменяет эти правила загрузки. ## Фоновая проверка сохранённых файлов Фоновая проверка используется для файлов, которые уже находятся на сервере. Задание выполняется системным агентом, а обменник продолжает обслуживать клиентов. Страницу можно закрыть и позднее вернуться к результату. ### Выбор области проверки В блоке «Фоновая проверка файлов» выберите значение в поле «Что проверить».
ОбластьКакие файлы входят
«Файлы верификации»Файлы в штатных каталогах верификации банковских карт и личности.
«Клиентские файлы»Файлы в общем штатном каталоге клиентских данных, включая верификацию, чеки, вложения чата и дополнительные поля.
«Файлы проекта»Файлы версии iEXExchanger, которая была активна при запуске проверки.
«Все файлы iEXExchanger»Файлы активной версии, локальное хранилище приложения, общие публичные файлы, установленные плагины и общие файлы Frontend.
По умолчанию выбраны «Файлы верификации». Эти области ограничены локальными каталогами установки iEXExchanger. Проверка не охватывает весь сервер, содержимое базы данных или объекты во внешнем облачном хранилище. Произвольный путь для сканирования на этой странице указать нельзя. Для первоначальной проверки сохранённых данных выберите «Клиентские файлы». Если требуется также проверить установленный продукт и плагины, выберите «Все файлы iEXExchanger». ### Запуск проверки 1. Убедитесь, что антивирус показывает «Готов к проверке». 2. Выберите нужную область в поле «Что проверить». 3. Нажмите «Начать проверку». 4. Дождитесь окончания задания и откройте его результат в «История проверок». Сначала отображается «Подсчёт файлов». После подсчёта появятся общее количество файлов, объём и процент обработки. Процент рассчитывается по количеству обработанных файлов. При состоянии «Ожидание свободных ресурсов сервера» агент временно откладывает следующий файл из-за нагрузки или нехватки доступной памяти. Когда ресурсы освободятся, проверка продолжится автоматически. Это состояние само по себе не означает ошибку. Скорость зависит от количества, размера и содержимого файлов, а также нагрузки сервера. По одному значению процента нельзя определить время завершения. Одновременно выполняется одно фоновое задание. Проверка на паузе также занимает это место: перед запуском другой области продолжите её до завершения или отмените. ### Пауза, продолжение и отмена Доступные действия зависят от состояния текущей проверки: * «Пауза» приостанавливает обработку. Проверка текущего файла может закончиться перед остановкой. * «Продолжить» возобновляет задание, которое находится на паузе. * «Отменить» прекращает задание. Частичный результат сохраняется в истории со статусом «Отменено». После отмены для проверки оставшихся файлов запустите новое задание. Кнопка «Продолжить» предназначена для проверки на паузе. Если системный агент перезапустился, незавершённое задание переводится в паузу с пояснением «Приостановлено после перезапуска агента». Проверьте работу служб и нажмите «Продолжить». При восстановлении задания агент использует сохранённые результаты для файлов, которые уже проверены и не изменились. ### Ограничения и непроверенные файлы Агент проверяет обычные файлы внутри выбранных каталогов и не переходит по символическим ссылкам. Символическая ссылка — это указатель на другой файл или каталог; её содержимое не включается в обход автоматически. Файлы размером больше 512 МБ пропускаются. Это предел фонового задания, а лимит ручной проверки составляет 20 МБ. Внутренние ограничения ClamAV также могут влиять на результат анализа. Одно задание ограничено 500 000 файлов. При превышении этого количества оно завершается ошибкой. Выберите более узкую область или передайте задачу серверному администратору. Файл, который изменился во время обработки или стал недоступен для чтения, может попасть в счётчик «Ошибки». Такой файл не считается успешно проверенным. Если обнаружены ошибки или пропуски, сначала установите причину, затем повторите проверку. Повторный запуск не снимает ограничение размера: крупные файлы требуют отдельной проверки серверным администратором. ### История и подробный результат Блок «История проверок» содержит результаты завершённых, отменённых и неуспешных фоновых заданий. Здесь доступны и проверки, запущенные вручную из блока фонового сканирования, и задания ежедневного мониторинга. Нажмите на нужную запись, чтобы открыть «Результат проверки». В панели показаны область, состояние, время начала и завершения, счётчики и «Журнал угроз». По умолчанию история показывает 10 записей на странице. Если записей больше, используйте переключение страниц. Доступны размеры страницы 10, 20 и 50 записей. Во время текущей проверки при обнаружении угроз появляется кнопка «Показать угрозы». Она позволяет открыть сведения до завершения задания. «Журнал угроз» содержит только файлы с обнаруженными угрозами. Для каждого указаны путь относительно области проверки, название угрозы, размер, время проверки и длительность обработки. Общие числа ошибок и пропусков показаны в счётчиках результата. При большом количестве угроз используйте «Показать ещё». Для текущего задания также доступна кнопка «Обновить журнал». Если сведения не загрузились, используйте «Повторить загрузку». История относится к фоновым заданиям. Результаты самопроверки и ручной проверки отдельного файла отображаются в своих блоках. ### Как читать счётчики
ПоказательЗначение
«Файлы»Количество обработанных файлов и общее количество в задании. Обработанные включают файлы с ошибками и пропусками.
«Объём»Объём обработанных файлов и общий объём задания.
«Время»Время с начала задания, включая паузы и ожидание ресурсов.
«Без угроз»Файлы, для которых сканер вернул результат без обнаруженных угроз.
«Угрозы»Файлы, вызвавшие срабатывание антивируса.
«Ошибки»Файлы, для которых не удалось получить достоверный результат.
«Пропущено»Файлы, которые не были переданы на проверку из-за ограничения.
Статус «Завершено» означает, что задание закончило обработку своей области. Он может отображаться и при обнаруженных угрозах, ошибках или пропусках. Проверку выбранной области можно считать завершённой без обнаруженных угроз, если: * отображается «Завершено»; * количество обработанных файлов совпадает с общим количеством; * «Угрозы», «Ошибки» и «Пропущено» равны нулю; * в области действительно были файлы для проверки. Сообщение «Файлов для проверки нет» означает отсутствие файлов в выбранной области. При статусах «Пауза», «Отменено», «Ошибка» или сообщении «Результат неполный» отсутствие найденных угроз относится только к уже проверенной части. ### Действия при обнаружении угроз {% hint style="warning" %} Фоновая проверка фиксирует найденные угрозы, но не удаляет, не лечит и не перемещает сохранённые файлы в карантин. Обнаруженный файл остаётся на своём месте до отдельного действия администратора. {% endhint %} 1. Откройте «Результат проверки» и «Журнал угроз». 2. Зафиксируйте область, путь, название угрозы и время обнаружения. 3. Не открывайте обнаруженный файл и не используйте его в работе. 4. Передайте сведения ответственному администратору. Для клиентского документа запросите безопасную замену. Для файла продукта или плагина требуется проверка происхождения и восстановление корректного файла. 5. После устранения причины повторно запустите проверку той же области и оцените весь результат, включая ошибки и пропуски. Название угрозы может относиться к обнаружению вредоносного содержимого или срабатыванию правила анализа. Проверяйте причину обнаружения перед изменением файлов продукта. Путь в журнале относительный: для поиска файла на сервере передайте его вместе с названием области. Перед заменой или удалением рабочих файлов продукта подготовьте [резервную копию](https://docs.iexexchanger.com/server-i-dannye/sozdanie-rezervnoi-kopii). ### Приглашение к проверке после обновления После обновления обменника в меню может появиться приглашение «Проверьте файлы обменника». Нажмите «Перейти к проверке», чтобы открыть раздел «Антивирус», затем выберите область и запустите фоновое задание. Кнопка закрытия «Больше не показывать» скрывает приглашение для всех администраторов этой установки. Она не изменяет защиту клиентских загрузок или ежедневный мониторинг. Раздел «Антивирус» остаётся доступным через меню. Приглашение предназначено для обновлённых установок. Его отсутствие после первоначальной установки не препятствует настройке антивируса. ## Постоянный мониторинг «Постоянный мониторинг» автоматически запускает фоновую проверку выбранной области раз в 24 часа. По умолчанию он выключен. Первоначальная область — «Файлы верификации». Мониторинг управляет сохранёнными файлами. Проверка новых загрузок по-прежнему зависит от настроек блока «Проверка файлов клиентов». ### Включение ежедневной проверки 1. Убедитесь, что антивирус показывает «Готов к проверке». 2. В блоке «Постоянный мониторинг» выберите «Область мониторинга». 3. Включите «Включить ежедневную проверку». 4. Нажмите «Сохранить настройки» именно в блоке «Постоянный мониторинг». 5. Дождитесь сообщения «Настройки мониторинга сохранены.». При первом включении задание может начаться уже в ближайшую минуту, если службы готовы и другая проверка не занимает место. Последующие плановые запуски выполняются с интервалом не менее 24 часов от предыдущего планового запуска. Выбор конкретного времени суток на странице не предусмотрен. Если текущее задание ещё выполняется или находится на паузе, новое не запускается. При временной неготовности служб агент повторяет попытку запуска после восстановления их работы. Область мониторинга сохраняется отдельно от области ручного фонового запуска. Изменение поля «Что проверить» не меняет ежедневное расписание. ### Отключение мониторинга Выключите «Включить ежедневную проверку» и нажмите «Сохранить настройки» в блоке «Постоянный мониторинг». Это останавливает будущие плановые запуски. Уже выполняющееся задание продолжит работу. Для его прекращения используйте «Отменить» в блоке «Фоновая проверка файлов». ### Проверка автоматической работы После планового запуска откройте «История проверок» и найдите результат выбранной области. Проверьте время начала, конечный статус и счётчики. Если для мониторинга выбраны «Файлы проекта» или «Все файлы iEXExchanger», новое задание использует версию продукта, активную на момент своего запуска. Уже начавшаяся проверка закреплена за версией, выбранной при её запуске. ### Проверка и восстановление служб На странице «Антивирус» нажмите значок информации рядом с заголовком «Антивирус на сервере». В нём показаны «Проверка файлов» и «Обновление баз» со состоянием «Работает» или «Остановлена». Для управления откройте: **«Утилиты» — «Службы»** 1. На вкладке «Состояние служб» найдите «Антивирус: проверка файлов» и «Антивирус: обновление баз». 2. Если служба остановлена, нажмите «Запустить». При необходимости перезапуска используйте «Перезапустить». 3. Подтвердите выбранное действие кнопкой «Подтвердить». 4. Дождитесь результата и проверьте состояние обеих служб. 5. Вернитесь в «Антивирус», нажмите «Проверить состояние» и выполните самопроверку. Службы антивируса появляются в списке после установки его компонентов. Для изменения их состояния требуется право «Управление службами обменника». {% hint style="warning" %} Остановка или перезапуск службы проверки файлов временно делает сканер недоступным. Если защита клиентов включена, проверяемые загрузки в этот период могут отклоняться. Остановка службы обновления баз прекращает их автоматическое обновление и переводит общую готовность антивируса в состояние «Установлен, но службы не готовы». {% endhint %} {% content-ref url="/pages/jzFqE18WKgZFxKJXQp1R" %} [Службы](/guide/utility/sluzhby.md) {% endcontent-ref %} ### Если установка или проверка не работает
Требуется обновить системный агент Установленный системный агент ещё не поддерживает антивирус. Передайте это сообщение серверному администратору или поддержке iEXExchanger для обновления системного компонента. После обновления откройте раздел повторно и нажмите «Проверить состояние». Сообщение об устаревшем агенте должно исчезнуть, а установка антивируса — стать доступной при наличии права управления.
Не удалось получить состояние Административная панель не получила сведения от системного агента. Нажмите «Проверить состояние». Если ошибка сохраняется, проверьте службу «Агент обновлений» в разделе «Службы» или передайте проблему серверному администратору. После восстановления связи страница должна показать фактическое состояние антивируса и его служб. Потеря связи с панелью сама по себе не подтверждает остановку уже принятой установки или фоновой проверки.
Установка завершилась ошибкой На странице сохраняется этап, на котором операция остановилась. Запишите его название и сообщение об ошибке. Серверному администратору нужно проверить причину на этом этапе: установку компонентов, подключение обменника к сканеру или запуск служб. После устранения причины повторите установку. В зависимости от состояния компонентов используйте «Установить антивирус» или «Повторить настройку», если эта кнопка доступна. Итог проверьте по состоянию «Готов к проверке» и обоим успешным результатам самопроверки.
Самопроверка показывает «Ошибка» Работающие службы ещё не подтверждают, что обменник может проверить файл. Проверьте обе службы и повторите «Запустить самопроверку». Если службы работают, но хотя бы один тест остаётся неуспешным, передайте серверному администратору оба результата. Нужно проверить доступ обменника к сканеру и работу самого антивируса. После исправления оба теста должны показывать «Успешно».
Фоновая проверка имеет статус «Ошибка» или неполный результат При недоступности сканера задание может завершиться ошибкой. Проверьте службы, выполните самопроверку и запустите новое фоновое задание после восстановления работы. Если задание завершилось, но есть ошибки или пропуски, проверьте доступность файлов и ограничения выбранной области. Файлы могли измениться во время работы или превысить допустимый размер. Для проверки на паузе используйте «Продолжить»; для завершённого или неуспешного задания создайте новый запуск. После повторной проверки оцените конечный статус и все счётчики. Пустой «Журнал угроз» при ошибках или пропусках не подтверждает проверку всей области.
### Диагностика через SSH для серверного администратора Если восстановить работу через административную панель не удалось, проверьте состояние системного агента и служб ClamAV на сервере: ```bash sudo systemctl --no-pager --full status iex-update-agent.service clamav-daemon.service clamav-freshclam.service ``` Просмотрите сообщения за последний час: ```bash sudo journalctl -u iex-update-agent.service -u clamav-daemon.service -u clamav-freshclam.service --since "-1 hour" --no-pager ``` Состояние «Работает» подтверждает запуск службы. При проблемах с обновлением баз проверьте сообщения службы обновления: само активное состояние не подтверждает успешное получение свежей базы. При обращении в поддержку передайте точное сообщение из панели, этап установки или область фоновой проверки, время ошибки и относящиеся к ней строки журнала. Удалите из передаваемых материалов пароли, токены и персональные данные клиентов. ### Как проверить настройку целиком Настройка защиты новых загрузок проверена, если антивирус показывает «Готов к проверке», оба результата самопроверки имеют значение «Успешно», а выбранные переключатели сохранены. При включённой защите карточка должна показывать «Проверка клиентов включена». Проверьте загрузку безопасного файла допустимого формата в используемой клиентской форме. Убедитесь, что файл принят и доступен сотруднику там, где должен отображаться по правилам этой формы. Для проверки фотографий переключатель «Проверять фото и изображения» должен быть включён. Отдельно запустите фоновую проверку нужной области и дождитесь конечного результата. Если ежедневный мониторинг включён, проверьте появление и завершение его планового задания в истории.