Veto

Клиент VirusTotal с открытым исходным кодом для Android

Бесплатно и с открытым исходным кодом. Используйте свой собственный API-ключ VirusTotal для сканирования файлов, ссылок и установленных приложений с помощью более 70 антивирусных движков. Интерфейс выполнен в стиле Material 3. Никаких аккаунтов, отслеживания или рекламы.

Что такое Veto?

Veto — это Android-клиент для VirusTotal. Отправьте файл, ссылку или установленное приложение, чтобы просмотреть результаты анализа в реальном времени. Приложение отображает чёткий отчёт: от единого сводного вердикта до полного набора полей, возвращаемых сервисом.

Проект бесплатен и имеет открытый исходный код, не содержит учётных записей пользователей, систем отслеживания или рекламы. Поскольку пользователи предоставляют свой собственный API-ключ VirusTotal, все сканирования выполняются непосредственно под их личной учётной записью, без маршрутизации через сторонние промежуточные серверы.

Скриншоты

Набор функций

• Возможность сканирования: Сканирование установленных приложений, локальных файлов или целевых URL.
• Агрегация нескольких движков: Объединение диагностических данных от более чем 70 антивирусных движков.
• Два режима отчётов: Быстрый режим для сводок быстрой проверки и подробный режим для глубокого анализа.
• Контекстные пояснения: Пояснительный текст доступен для каждого раздела, с возможностью скрыть пояснения при желании.
• Высокодетализированные отчёты: Отображение хешей файлов, классификаций угроз, истории, голосов сообщества, поведения в песочнице, совпадений YARA, внутренностей приложений Android и всех дополнительных полей полезной нагрузки API.
• Фоновое выполнение: Отслеживание прогресса загрузки и анализа в реальном времени, сохраняющееся в фоновом сервисе.
• Доступ офлайн: Локальное сохранение отчётов для последующего просмотра, даже без подключения к интернету.
• Предупреждения о лимитах скорости: Чёткие уведомления при достижении лимита запросов для локального API-ключа.
• Темы: Полная поддержка Material 3 с динамическими системными цветами, поддержка светлой и тёмной тем.

Детали реализации основной архитектуры

• Синхронизация состояний: ScanManager в области приложения служит централизованным источником истины для всех состояний сканирования. Это гарантирует, что пользовательский интерфейс остаётся синхронизированным, независимо от того, активно ли приложение на переднем плане, приостановлено в фоне или уничтожено операционной системой.
• Устойчивый опрос: Приложение опрашивает конечную точку /analyses/{id}, используя шестиминутный лимит по настенным часам. При получении ответа о превышении лимита скорости процесс ожидает, а не завершается с ошибкой. Отчёт повторно запрашивается до тех пор, пока результаты не будут заполнены; возвращается структурированное состояние ошибки, если лимит времени превышен.
• Жизненный цикл процесса: В то время как ScanState находится внутри ScanManager для переживания уничтожения Activity, ScanService поддерживает жизненный цикл процесса во время активных операций и управляет уведомлениями о текущих и завершённых операциях.
• Полный разбор с сохранением точности: Общие поля захватываются с помощью типизированных моделей, а полный необработанный JSON атрибутов сохраняется через кастомный сериализатор. Это позволяет представлению подробного отчёта отображать все возвращённые поля, включая любые новые поля, добавленные в полезную нагрузку API со временем.

Технологический стек

Структура проекта

└── app/src/main/java/com/quantum_prof/vtscansuite/
    ├── data/          # Модели, удалённый API и реализация репозитория
    ├── domain/        # Интерфейс репозитория и бизнес-сценарии использования
    ├── di/            # Модули внедрения зависимостей Hilt
    ├── scan/          # ScanManager, ScanService и системные уведомления
    └── ui/            # Компоненты UI и слои представления
        ├── intro/     # Экран приветствия и настройка API-ключа
        ├── dashboard/ # Навигационный центр: модули сканирования ссылок, файлов и приложений
        ├── results/   # Визуализаторы быстрых и подробных отчётов
        ├── components/# Переиспользуемые элементы UI и макеты
        ├── theme/     # Конфигурации цветов, форм, типографики и анимации
        └── util/      # Утилиты тактильной обратной связи, жестов и глубоких ссылок

• Ресурсы и текстовые ресурсы для магазина доступны в fastlane/metadata/android/en-US/.
• Редактируемые SVG-макеты находятся в docs/store/svg/.
• Макеты можно экспортировать в PNG с помощью docs/store/export.html.

Начало работы

Предварительные требования

• Android Studio (последняя стабильная версия)
• JDK 17
• Бесплатный API-ключ VirusTotal, который можно получить по адресу: https://www.virustotal.com/gui/my-apikey

Сборка и запуск

Клонируйте репозиторий и соберите отладочную сборку с помощью командной строки:

git clone https://github.com/ProfessorQuantumUniverse/VTScan.git
cd VTScan
./gradlew :app:assembleDebug

Или откройте корневую папку в Android Studio и выберите конфигурацию Run.

При первом запуске введите свой API-ключ VirusTotal на экране начальной настройки. Ключ хранится локально на вашем устройстве. Бесплатные API-ключи обычно ограничены четырьмя запросами в минуту.

Политика конфиденциальности

Приложение взаимодействует исключительно с API VirusTotal, используя предоставленные вами учётные данные. Загруженные файлы, отправленные URL и динамические результаты отправляются напрямую на серверы VirusTotal. API-ключ хранится локально на вашем устройстве. Veto не собирает аналитические данные и не содержит SDK для рекламы.

Лицензия

Этот проект лицензируется на условиях GNU General Public License v3.0.

Ключевые условия GPLv3:

• Коммерческое использование: Разрешено
• Модификация: Разрешена
• Распространение: Разрешено
• Раскрытие исходного кода: Требуется при распространении
• Та же лицензия: Модифицированный код также должен использовать GPLv3
• Ответственность и гарантия: Авторы не предоставляют никаких гарантий

Для получения дополнительной информации см. файл LICENSE в этом репозитории.