netcheck

Outil CLI de vulgarisation d'audit de sécurité réseau local.

Description

netcheck est un outil en ligne de commande conçu pour vulgariser l'audit de sécurité réseau. Il permet à n'importe quel utilisateur, même sans connaissances techniques avancées, d'obtenir des informations sur son réseau local et d'identifier d'éventuelles failles de sécurité.

Fonctionnalités

• Scan du réseau local : découverte des appareils connectés (IP, ports ouverts)
• Détection de services : identification des services réseau et récupération des bannières (SSH, HTTP, FTP, etc.)
• Vérification de vulnérabilités : comparaison avec la base CVE (NVD) pour détecter les systèmes potentiellement vulnérables
• Alertes de sécurité : détection de configurations dangereuses (Telnet, SMB, HTTP sans HTTPS, versions obsolètes, mots de passe par défaut...)
• Sécurité web : vérification des headers HTTP de sécurité et analyse des certificats SSL/TLS
• Capture de trames : analyse ciblée du trafic réseau avec Scapy (optionnel, nécessite les droits administrateur)
• Rapport console : affichage coloré et vulgarisé des résultats
• Export JSON : sauvegarde des résultats structurés pour analyse ultérieure
• Export HTML : rapport web moderne et coloré, prêt à partager ou imprimer
• Scan de ports personnalisés : choisissez vous-même les ports à scanner
• Mode silencieux : pour l'intégration dans des scripts ou des pipelines

Installation rapide (via pip)

pip install netcheck

Ou depuis les sources :

git clone https://github.com/etudiant/netcheck.git
cd netcheck
pip install -e .

Windows avec le launcher py : Si la commande netcheck n'est pas reconnue après l'installation, utilisez py -m netcheck à la place. Exemple : py -m netcheck --rapide

Prérequis pour la capture de trames (Scapy) :

• Windows : installer Npcap avec l'option "WinPcap API-compatible Mode"
• Linux : exécuter la capture avec sudo

Dépendances Python : rich, requests, scapy (installées automatiquement avec pip)

Utilisation

Scan basique

# Scan du réseau par défaut (192.168.1.0/24)
netcheck

# Spécifier un sous-réseau
netcheck --sous-reseau 192.168.1.0/24

# Scanner des ports personnalisés
netcheck --ports 22 80 443 8080

# Mode verbose (plus de détails)
netcheck --verbose

# Mode silencieux (pour les scripts)
netcheck --silencieux

# Mode rapide (scan réseau + alertes uniquement, très rapide)
netcheck --rapide

# Détection d'OS (nécessite les droits admin sur Windows)
netcheck --os-detect

Sécurité avancée

# Activer la vérification de sécurité web (headers HTTP + SSL/TLS)
netcheck --web-security

# Désactiver la vérification CVE (plus rapide)
netcheck --pas-cve

# Exporter un rapport JSON
netcheck --exporter rapport.json

# Exporter un rapport HTML
netcheck --html rapport.html

# Tout faire d'un coup !
netcheck --web-security --exporter rapport.json --html rapport.html

Capture de trames (nécessite les droits admin)

netcheck --capture --interface "Wi-Fi" --paquets 100

Guide des arguments expliqué simplement

Scénarios prêts à l'emploi

# 1. Premier scan rapide de votre box (1 minute)
netcheck --rapide

# 2. Scan complet avec rapport web
netcheck --web-security --html rapport_box.html

# 3. Scan des ports importants avec export JSON
netcheck --ports 21 22 23 80 443 445 3389 --exporter scan.json

# 4. Scan silencieux pour un script automatisé
netcheck --silencieux --rapide --exporter resultats.json

# 5. Tout vérifier (le plus poussé)
netcheck --verbose --web-security --os-detect --html complet.html --exporter complet.json

Avertissement

Cet outil est destiné à un usage éducatif et éthique. Ne scannez que des réseaux dont vous êtes propriétaire ou pour lesquels vous disposez d'une autorisation explicite.

Architecture

netcheck/
├── netcheck/
│   ├── __init__.py
│   ├── cli.py              # Interface en ligne de commande
│   ├── network_scanner.py  # Scan réseau et ports (multithreadé)
│   ├── service_detector.py # Détection des services et bannières
│   ├── cve_checker.py      # Recherche de CVE via l'API NVD
│   ├── vuln_checks.py      # Tests de sécurité basiques + versions vulnérables
│   ├── web_security.py     # Vérification headers HTTP + certificats SSL/TLS
│   ├── packet_sniffer.py   # Capture de trames Scapy
│   ├── security_utils.py   # Utilitaires de sécurité
│   └── reporter.py         # Affichage console + export JSON/HTML
├── tests/                  # Tests unitaires complets
├── pyproject.toml
└── README.md

Tests

# Exécuter tous les tests
python -m pytest tests/

# Ou avec unittest
python -m unittest discover tests/

Auteurs

Korgho Sosthene et Ouedraogo Chakira

Projet tutoré : Audit de sécurité d'un réseau local

Licence

MIT — Voir le fichier LICENSE pour plus de détails.