Présentation

NetDTL est une application web auto-hébergée pour la découverte réseau agentless et la gestion d'inventaire sur infrastructure Windows. Elle fonctionne sur un stack PHP/MySQL/Nmap (XAMPP ou LAMP) et fournit un scan en temps réel via Server-Sent Events, le profilage des machines, des diagnostics réseau et la gestion du panneau de brassage — le tout via une interface web sombre sans dépendance JavaScript externe.

L'application est structurée en un ensemble de pages PHP, chacune responsable d'un domaine fonctionnel, partageant une couche de base de données commune (db.php), une feuille de style CSS (style.php) et des partiels de mise en page (topbar.php, sidebar.php).

Prérequis

Installation

Déployer les fichiers de l'application dans la racine du serveur web (ex. htdocs/netdtl/ sous XAMPP, ou un virtual host dédié).

1. Créer la base de données

CREATE DATABASE netdtl CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'netdtl'@'localhost' IDENTIFIED BY 'yourpassword';
GRANT ALL PRIVILEGES ON netdtl.* TO 'netdtl'@'localhost';
FLUSH PRIVILEGES;

2. Configurer db.php

Modifier les constantes en haut de db.php pour correspondre à l'environnement. Le schéma de base de données est créé automatiquement au premier démarrage par initDB().

3. Premier démarrage

Ouvrir l'application dans un navigateur. initDB() créera toutes les tables requises si elles n'existent pas. Se connecter avec les identifiants définis dans AUTH_USER / AUTH_PASS.

Configuration

Toute la configuration se trouve dans db.php sous forme de constantes PHP. Il n'existe pas de fichier de configuration séparé.

Schéma de base de données

Les tables sont créées automatiquement par initDB() dans db.php via CREATE TABLE IF NOT EXISTS.

machines

Table d'inventaire centrale. Une ligne par adresse IP (clé unique sur ip).

scan_history

Une ligne par scan de découverte terminé.

diag_history

Journal de toutes les opérations de diagnostic (ping, traceroute, DNS, scan de ports, détection OS).

patch_panel

Ports du panneau de brassage physique, généralement alimentés par import (CSV ou SQL direct).

patch_machines

Jointure many-to-many entre les ports du panneau de brassage et les machines (un port peut desservir plusieurs IP).

Pages

Composants partagés

Sécurité

NetDTL utilise l'authentification HTTP Basic implémentée dans requireAuth(). Les identifiants sont stockés en clair dans db.php. Cela est acceptable pour un déploiement sur un réseau local de confiance, mais ne doit pas être exposé sur internet sans protection complémentaire (reverse proxy avec TLS, filtrage IP, etc.).

• Toutes les valeurs saisies par l'utilisateur rendues en HTML sont passées par htmlspecialchars().
• Toutes les requêtes de base de données utilisent des requêtes préparées PDO avec des paramètres liés.
• Les commandes shell utilisent escapeshellarg() sur toutes les cibles fournies par l'utilisateur, validées au préalable par isValidTarget().
• La plage CIDR dans scan_stream.php est validée par isValidTarget() avant d'être transmise à Nmap.

Limitations connues

• Commandes centrées Windows. Le ping utilise ping -n 4 et le traceroute utilise tracert. Sous Linux, runPing() bascule vers ping -c 4, mais tracert (menu.php) n'est pas adapté — utiliser traceroute manuellement sous Linux.
• Adresse MAC non disponible pour la machine qui scanne. Nmap ne peut pas lire sa propre MAC. La page d'inventaire détecte ce cas et remplace le champ MAC par l'étiquette ce PC.
• La détection OS nécessite des privilèges élevés. nmap -O et nmap -sS nécessitent que le processus du serveur web s'exécute en tant qu'Administrateur (Windows) ou root (Linux). Sans élévation, ces options ne retournent silencieusement aucune donnée OS.
• Les requêtes WMI nécessitent un accès réseau et une cible Windows. L'appel PowerShell WMI dans scan_stream.php ne fonctionne que contre des machines Windows autorisant le WMI distant, et uniquement lorsque le serveur qui scanne dispose d'identifiants appropriés sur la cible.
• L'identification NetBIOS nécessite UDP 137. Le script Nmap nbstat utilise le port UDP 137. Les pare-feux ou règles Windows Firewall bloquant ce port empêcheront la résolution des noms NetBIOS.
• Les données du panneau de brassage ne sont pas gérées par l'application. Les tables patch_panel et patch_machines doivent être alimentées en externe (ex. via le moteur de patch panel du NetDTL Installer ou un import SQL direct).
• Authentification mono-utilisateur. Il n'existe qu'un seul jeu d'identifiants. Il n'y a pas de gestion de rôles ni de journal d'audit par utilisateur.
• Limite de durée de scan. set_time_limit(600) limite les scans à 10 minutes. Les grands réseaux ou les réseaux lents peuvent dépasser cette limite.
• hosts_down est toujours 0. La colonne scan_history.hosts_down est insérée à 0 ; les hôtes qui ne répondent pas ne sont simplement pas ajoutés à l'inventaire lors d'un scan.