Veto

Um cliente VirusTotal de código aberto para Android

Gratuito e de código aberto. Traga sua própria chave de API do VirusTotal para escanear arquivos, links e aplicativos instalados em mais de 70 mecanismos, construído com interface Material 3. Sem contas, sem rastreamento, sem anúncios.

O que é o Veto?

O Veto é um cliente Android para VirusTotal. Envie um arquivo, um link ou um aplicativo instalado para visualizar resultados de análise em tempo real. O aplicativo exibe um relatório claro, desde um único veredito unificado até o conjunto completo de campos retornados pelo serviço.

O projeto é gratuito e de código aberto, sem contas de usuário, sistemas de rastreamento ou publicidade. Como os usuários fornecem sua própria chave de API do VirusTotal, todas as varreduras são executadas diretamente sob sua conta pessoal, sem serem roteadas por servidores intermediários de terceiros.

Capturas de Tela

Conjunto de Funcionalidades

• Capacidade de Varredura: Escaneie aplicativos instalados, arquivos locais ou URLs alvo.
• Agregação de Múltiplos Mecanismos: Combina diagnósticos de mais de 70 mecanismos antivírus.
• Modos de Relatório Duplo: Modo rápido para resumos de verificação rápida e Modo detalhado para inspeção aprofundada.
• Explicações Contextuais: Texto explicativo disponível para cada seção, com uma configuração para ocultar explicações, se desejado.
• Relatórios de Alta Fidelidade: Exibe hashes de arquivos, classificações de ameaças, histórico, votos da comunidade, comportamentos em sandbox, correspondências YARA, detalhes internos de aplicativos Android e todos os campos adicionais do payload da API.
• Execução em Segundo Plano: Acompanhamento em tempo real do progresso de upload e análise que persiste dentro de um serviço em segundo plano.
• Acesso Offline: Salva relatórios localmente para permitir revisão posterior, mesmo sem conexão com a internet.
• Avisos de Limite de Taxa: Exibe notificações claras quando a chave de API local atinge seu limite de taxa.
• Temas: Suporte completo ao Material 3 com cores dinâmicas do sistema, com suporte aos temas claro e escuro.

Detalhes de Implementação da Arquitetura Principal

• Sincronização de Estado: O ScanManager com escopo de aplicativo serve como a fonte centralizada de verdade para todos os estados de varredura. Isso garante que a interface do usuário permaneça sincronizada quer o aplicativo esteja ativo em primeiro plano, suspenso em segundo plano ou destruído pelo sistema operacional.
• Polling Resiliente: O aplicativo faz polling do endpoint /analyses/{id} usando um limite de seis minutos no relógio de parede. Se uma resposta de limite de taxa for encontrada, o processo aguarda em vez de falhar. O relatório é buscado novamente até que os resultados sejam preenchidos, retornando um estado de falha estruturado se o limite de tempo for atingido.
• Ciclo de Vida do Processo: Enquanto o ScanState reside dentro do ScanManager para sobreviver à destruição da Activity, o ScanService mantém o ciclo de vida do processo durante operações ativas e gerencia notificações em andamento e de conclusão.
• Análise de Alta Fidelidade: Campos comuns são capturados usando modelos tipados, enquanto o JSON attributes bruto completo é retido por meio de um serializador personalizado. Isso permite que a visualização do relatório Detalhado renderize todos os campos retornados, incluindo quaisquer novos campos adicionados ao payload da API ao longo do tempo.

Stack Tecnológica

Estrutura do Projeto

└── app/src/main/java/com/quantum_prof/vtscansuite/
    ├── data/          # Modelos, API remota e implementação do repositório
    ├── domain/        # Interface do repositório e casos de uso de negócio
    ├── di/            # Módulos de injeção de dependência Hilt
    ├── scan/          # ScanManager, ScanService e notificações do sistema
    └── ui/            # Componentes de UI e camadas de apresentação
        ├── intro/     # Tela de inicialização e configuração da chave de API
        ├── dashboard/ # Hub de navegação: módulos de varredura de link, arquivo e aplicativo
        ├── results/   # Visualizadores de relatórios Rápido e Detalhado
        ├── components/# Elementos e layouts de UI reutilizáveis
        ├── theme/     # Configurações de cor, formas, tipografia e movimento
        └── util/      # Utilitários de feedback tátil, gestos e deep linking

• Os recursos de listagem na loja e os recursos de texto estão disponíveis em fastlane/metadata/android/en-US/.
• Os SVGs de mockup editáveis estão localizados em docs/store/svg/.
• Os mockups podem ser exportados para o formato PNG usando docs/store/export.html.

Primeiros Passos

Pré-requisitos

• Android Studio (versão estável mais recente)
• JDK 17
• Uma chave de API gratuita do VirusTotal, que pode ser obtida em: https://www.virustotal.com/gui/my-apikey

Construir e Executar

Clone o repositório e compile a build de depuração usando a linha de comando:

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

Alternativamente, abra o diretório raiz no Android Studio e selecione a configuração Executar.

No primeiro lançamento, insira sua chave de API do VirusTotal na tela de configuração de introdução. A chave é armazenada localmente no seu dispositivo. Chaves de API gratuitas geralmente estão sujeitas a um limite de quatro consultas por minuto.

Política de Privacidade

O aplicativo se comunica exclusivamente com a API do VirusTotal usando as credenciais fornecidas por você. Arquivos enviados, URLs submetidos e resultados dinâmicos são enviados diretamente para os servidores do VirusTotal. A chave de API é armazenada localmente no seu dispositivo. O Veto não coleta dados de análise e não contém SDKs de publicidade.

Licença

Este projeto é licenciado sob os termos da GNU General Public License v3.0.

Termos Principais da GPLv3:

• Uso comercial: Permitido
• Modificação: Permitida
• Distribuição: Permitida
• Divulgação do código-fonte: Exigida na distribuição
• Mesma licença: O código modificado também deve usar GPLv3
• Responsabilidade e Garantia: Nenhuma fornecida pelos autores

Para mais detalhes, consulte o arquivo LICENSE neste repositório.