Veto

Un client VirusTotal open source per Android

Gratuito e open source. Porta la tua chiave API VirusTotal per scansionare file, link e applicazioni installate con oltre 70 motori, realizzato con un'interfaccia Material 3. Nessun account, nessun tracciamento, nessuna pubblicità.

Cos'è Veto?

Veto è un client Android per VirusTotal. Invia un file, un link o un'applicazione installata per visualizzare i risultati dell'analisi in tempo reale. L'applicazione mostra un report chiaro che va da un singolo verdetto unificato all'insieme completo di campi restituiti dal servizio.

Il progetto è gratuito e open source, non contiene account utente, sistemi di tracciamento o pubblicità. Poiché gli utenti forniscono la propria chiave API VirusTotal, tutte le scansioni vengono eseguite direttamente sotto il loro account personale senza passare attraverso server intermedi di terze parti.

Screenshot

Set di funzionalità

• Capacità di scansione: scansiona app installate, file locali o URL target.
• Aggregazione multi-motore: combina diagnostica da oltre 70 motori antivirus.
• Modalità di report duplici: modalità Veloce per riepiloghi di verifica rapidi e modalità Dettagliata per ispezione approfondita.
• Spiegazioni contestuali: testo esplicativo disponibile per ogni sezione, con un'impostazione per nascondere le spiegazioni se desiderato.
• Report ad alta fedeltà: mostra hash di file, classificazioni delle minacce, cronologia, voti della comunità, comportamenti in sandbox, corrispondenze YARA, interni delle applicazioni Android e tutti i campi aggiuntivi del payload API.
• Esecuzione in background: tracciamento in tempo reale del progresso di upload e analisi che persiste all'interno di un servizio in background.
• Accesso offline: salva i report localmente per consentire la revisione in un secondo momento, anche senza connessione internet.
• Avvisi di limitazione di frequenza: mostra notifiche chiare quando la chiave API locale raggiunge il limite di frequenza.
• Tematizzazione: supporto completo Material 3 con colori dinamici di sistema, supporto per temi chiari e scuri.

Dettagli di implementazione dell'architettura principale

• Sincronizzazione dello stato: il ScanManager con ambito applicativo funge da fonte di verità centralizzata per tutti gli stati di scansione. Ciò garantisce che l'interfaccia utente rimanga sincronizzata sia che l'app sia attiva in primo piano, sospesa in background o distrutta dal sistema operativo.
• Polling resiliente: l'app esegue il polling dell'endpoint /analyses/{id} utilizzando un limite di tempo massimo di sei minuti. Se viene rilevata una risposta di limitazione della frequenza, il processo attende anziché fallire. Il report viene recuperato fino a quando i risultati non vengono popolati, restituendo uno stato di fallimento strutturato se viene raggiunto il limite di timeout.
• Ciclo di vita del processo: mentre ScanState risiede all'interno di ScanManager per sopravvivere alla distruzione dell'Activity, ScanService mantiene il ciclo di vita del processo durante le operazioni attive e gestisce le notifiche in corso e di completamento.
• Analisi a piena fedeltà: i campi comuni vengono acquisiti utilizzando modelli tipizzati, mentre l'intero JSON raw attributes viene conservato tramite un serializzatore personalizzato. Ciò consente alla vista del report dettagliato di visualizzare tutti i campi restituiti, inclusi eventuali nuovi campi aggiunti al payload API nel tempo.

Stack tecnologico

Struttura del progetto

└── app/src/main/java/com/quantum_prof/vtscansuite/
    ├── data/          # Models, remote API, and repository implementation
    ├── domain/        # Repository interface and business use cases
    ├── di/            # Hilt dependency injection modules
    ├── scan/          # ScanManager, ScanService, and system notifications
    └── ui/            # UI components and presentation layers
        ├── intro/     # Splash screen and API key configuration
        ├── dashboard/ # Navigation hub: link, file, and app scanning modules
        ├── results/   # Quick and Detailed report visualizers
        ├── components/# Reusable UI elements and layouts
        ├── theme/     # Color, shapes, typography, and motion configurations
        └── util/      # Haptic feedback, gestures, and deep linking utilities

Le risorse e i testi per la scheda dello store sono disponibili in fastlane/metadata/android/en-US/. I mockup SVG modificabili si trovano in docs/store/svg/. I mockup possono essere esportati in formato PNG utilizzando docs/store/export.html.

Per iniziare

Prerequisiti

• Android Studio (ultima versione stabile)
• JDK 17
• Una chiave API VirusTotal gratuita, che può essere ottenuta all'indirizzo: https://www.virustotal.com/gui/my-apikey

Compilazione ed esecuzione

Clona il repository e compila la build di debug utilizzando la riga di comando:

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

In alternativa, apri la directory principale in Android Studio e seleziona la configurazione di esecuzione.

Al primo avvio, inserisci la tua chiave API VirusTotal nella schermata di configurazione iniziale. La chiave viene memorizzata localmente sul tuo dispositivo. Le chiavi API gratuite sono generalmente soggette a un limite di quattro richieste al minuto.

Informativa sulla privacy

L'applicazione comunica esclusivamente con l'API VirusTotal utilizzando le credenziali fornite dall'utente. I file caricati, gli URL inviati e i risultati dinamici vengono inviati direttamente ai server VirusTotal. La chiave API è memorizzata localmente sul tuo dispositivo. Veto non raccoglie dati di analisi e non contiene SDK pubblicitari.

Licenza

Questo progetto è concesso in licenza secondo i termini della GNU General Public License v3.0.

Termini chiave della GPLv3:

• Uso commerciale: Consentito
• Modifica: Consentita
• Distribuzione: Consentita
• Divulgazione del codice sorgente: Richiesta in caso di distribuzione
• Stessa licenza: Il codice modificato deve utilizzare anch'esso GPLv3
• Responsabilità e garanzia: Nessuna fornita dagli autori

Per maggiori dettagli, consulta il file LICENSE in questo repository.