1. Téléchargez les fichiers sur votre ordinateur

2. Installez les dépendances :

3. Obtenez votre clé API VirusTotal :
   • Allez sur https://www.virustotal.com/gui/my-apikey
   • Inscrivez-vous ou connectez-vous (c'est gratuit)
   • Copiez votre clé API

Utilisation

Option 1 : Utilisation du fichier .env (Recommandé)

1. Copiez le fichier .env.example en .env :

   root@kitploit:~

   cp .env.example .env
   

2. Modifiez le fichier .env et ajoutez votre configuration :

   root@kitploit:~

   VIRUSTOTAL_API_KEY=your_actual_api_key_here
   SCAN_FOLDER=C:\Users\username\Desktop\my_files
   

3. Exécutez le script :

   root@kitploit:~

   python virustotal_scanner.py
   

Le script chargera automatiquement votre configuration depuis le fichier .env.

Option 2 : Mode interactif (sans .env)

Si vous préférez ne pas utiliser le fichier .env, le script demandera les informations :

Le script demandera :

1. Votre clé API VirusTotal
2. Le chemin du dossier que vous souhaitez analyser

Exemple d'utilisation :

Exemples de chemins valides sous Windows :

• C:\Users\username\Documents\my_files
• C:\Users\username\Desktop\folder
• . (point = dossier courant)
• Vous pouvez glisser-déposer le dossier dans le terminal

Fichiers générés

Après avoir exécuté le script, les fichiers suivants seront générés automatiquement :

virustotal_scan.log

Fichier journal avec tous les événements :

• Début et fin de l'analyse
• Chaque fichier traité
• Erreurs et avertissements
• Statistiques finales

virustotal_results.csv

Fichier CSV avec les résultats (séparé par des points-virgules) :

• Date et heure de l'analyse
• Nom du fichier
• Chemin complet
• Taille en octets
• Hachage SHA256
• Détections positives
• Total des moteurs antivirus
• Pourcentage de détection
• Statut (CLEAN/DETECTED)
• URL VirusTotal

Le CSV peut être ouvert avec Excel, Google Sheets ou tout programme de tableur.

Exemple de sortie

Limitations et considérations

Limites de l'API gratuite :

• 4 fichiers par minute (le script attend automatiquement)
• Taille maximale : 32 Mo par fichier
• Les fichiers plus volumineux seront ignorés automatiquement

Fichiers qui sont ignorés :

• Fichiers de plus de 32 Mo
• Fichiers vides (0 octet)
• Fichiers sans permission de lecture
• Fichiers verrouillés par le système

Notes de sécurité importantes

• Gardez votre clé API privée - Ne la partagez pas
• Les fichiers sont analysés publiquement - Ne téléchargez pas de fichiers confidentiels
• Les fichiers sont partagés avec la communauté de sécurité - Une fois téléchargés, ils sont publics
• VirusTotal est destiné à l'analyse de sécurité - Utilisez-le de manière responsable
• Ne téléchargez pas de données personnelles ou d'entreprise sensibles

Que fait le script ?

1. Trouve TOUS les fichiers dans le dossier et les sous-dossiers
2. Vérifie que chaque fichier est valide pour l'analyse
3. Vérifie si le hachage du fichier existe déjà dans VirusTotal (économise du temps et de la bande passante)
4. Télécharge chaque fichier vers VirusTotal s'il n'est pas trouvé (en respectant la limite de 4 par minute)
5. Attend les résultats de l'analyse
6. Affiche l'URL et les détections (ex. 0/70, 5/70)
7. Génère un résumé complet à la fin

Dépannage

Erreur : "Invalid API key"

• Vérifiez que vous avez copié votre clé API correctement
• Obtenez-en une nouvelle sur https://www.virustotal.com/gui/my-apikey

Erreur : "Access denied to file"

• Certains fichiers système sont protégés
• Exécutez en tant qu'administrateur si vous devez analyser des fichiers système

Le script est très lent

• C'est normal : l'API gratuite est limitée à 4 fichiers par minute
• Si vous avez 100 fichiers, cela prendra environ 25 minutes

Fichiers ignorés

• Vérifiez le résumé final pour voir pourquoi ils ont été ignorés
• Les fichiers >32 Mo ne peuvent pas être analysés avec l'API gratuite

Licence

Licence MIT - Copyright (c) 2025 neorai

Ce projet est gratuit et open source. Vous pouvez l'utiliser, le modifier et le distribuer librement. Consultez le fichier LICENSE pour plus de détails.