Analyse croisée de captures Wireshark multi-points pour le dépannage réseau.
CorrÚle plusieurs captures .pcap/.pcapng prises simultanément en différents
points d'un chemin rĂ©seau (2, 4, 9... points) pour localiser prĂ©cisĂ©ment oĂč un
problĂšme apparaĂźt â pertes, latence, changement de QoS, saturation, fragmentation,
tunnels, DHCP, SIP, DNS, HTTP, RTP â plutĂŽt que de deviner Ă partir d'une capture unique.
Auteur : Mathilde Deuscher
PremiÚre utilisation ? Le guide utilisateur explique l'installation, la préparation des captures, une premiÚre analyse sur des captures d'exemple fournies, l'interface graphique et la lecture du rapport. Ce README sert de référence complÚte.
- Ce que fait l'outil
- Solutions de capture prises en charge
- Installation
- Utilisation
- Tests
- Qualité de code
- Architecture du dépÎt
- Construire les paquets .deb / .rpm
- Limites connues
- Suivi des issues
- Licence
à partir de N captures prises à des points différents du réseau (avec ou sans
ordre connu Ă l'avance), netcross :
- dĂ©duit automatiquement l'ordre et la topologie du chemin rĂ©seau (delta de TTL + recouvrement de flux entre points), y compris les cas de branchement (ECMP, load-balancing) et de convergence â sans qu'il soit nĂ©cessaire de connaĂźtre le chemin physique Ă l'avance ;
- dĂ©tecte les pertes de paquets, en attribuant chaque perte au bon segment du rĂ©seau (et sait reconnaĂźtre un flux qui a lĂ©gitimement pris une autre branche plutĂŽt que de le compter comme perdu ; le trafic qui n'emprunte pas un segment â scan local au LAN, hĂŽtes qui n'Ă©changent jamais rien Ă ce point â est comptĂ© Ă part comme « hors chemin », et le sens retour ne fausse plus le nombre de sauts) ;
- mesure la latence et la gigue par segment, avec estimation du décalage d'horloge entre points (formule NTP via les handshakes TCP) quand les machines de capture ne sont pas synchronisées ;
- détecte les sauts de routeur et les changements de route (TTL instable, chemins ECMP) ;
- corrĂšle les changements de marquage QoS (DSCP/802.1p) avec le TTL pour distinguer un remarquage fait par un switch (L2) d'un remarquage fait par un routeur (L3) ;
- identifie la fragmentation IP apparue en cours de route et la relie à un éventuel tunnel qui réduit le MTU disponible ;
- détecte les noirs PMTUD (RFC 1191 IPv4 / RFC 8201 IPv6) : segment TCP
de taille significative retransmis plusieurs fois sur un segment sans
jamais atteindre le point suivant, et sans qu'aucun signal ICMP(v6) de
MTU insuffisant (Fragmentation Needed cÎté IPv4, avec bit
DFactif requis ; Packet Too Big cĂŽtĂ© IPv6, oĂč la fragmentation par un routeur intermĂ©diaire n'existe de toute façon pas) ne remonte jusqu'Ă l'Ă©metteur â signature d'un pare-feu qui filtre l'ICMP(v6) nĂ©cessaire Ă la dĂ©couverte du MTU, laissant la connexion stagner indĂ©finiment plutĂŽt que d'Ă©chouer proprement ; - dĂ©tecte les coupures NAT/pare-feu silencieuses : une connexion TCP dĂ©jĂ Ă©tablie des deux cĂŽtĂ©s d'un segment, dont le trafic s'interrompt plus longtemps qu'un silence applicatif normal (60s), puis reprend cĂŽtĂ© amont sans jamais atteindre l'aval â signature d'une table d'Ă©tat NAT/pare-feu purgĂ©e pendant l'inactivitĂ©, sans le moindre RST pour prĂ©venir client ou serveur ;
- dĂ©tecte les conflits d'adresse IP via le trafic ARP observĂ© : deux adresses MAC diffĂ©rentes qui revendiquent la mĂȘme adresse IP sur un mĂȘme point de capture â double affectation statique, ou bascule d'IP flottante VRRP/HA en cours de capture ;
- dĂ©tecte l'instabilitĂ© STP : tempĂȘtes de changements de topologie (notifications TCN ou bit de changement de topologie actif) et réélections rĂ©pĂ©tĂ©es du pont racine â signatures classiques d'une boucle de commutation ou d'un lien qui bascule de façon rĂ©pĂ©tĂ©e ;
- diagnostique le certificat TLS prĂ©sentĂ© lors d'un handshake : dĂ©tecte un certificat hors de sa fenĂȘtre de validitĂ© (dĂ©jĂ expirĂ©, ou pas encore valide) et une substitution de certificat entre deux points de capture pour une mĂȘme connexion â signature possible d'une interception/substitution TLS en cours de chemin ;
- analyse le débit par point et corrÚle les pertes avec la charge pour distinguer saturation progressive, limitation nette (policing) et pertes sans lien avec le débit (indice de bufferbloat inclus) ;
- surveille la fenĂȘtre TCP, les ACK dupliquĂ©s, les RST injectĂ©s localement (indice de filtrage actif par un pare-feu/IPS) et les handshakes SYN sans rĂ©ponse ;
- classe chaque retransmission TCP par cause probable (rapide/3 ACK dupliquĂ©s, timeout/RTO, ou inutile/dĂ©jĂ acquittĂ©e) en lisant directement la classification native de tshark â une rĂ©cupĂ©ration rapide est un signe de bon fonctionnement, un timeout ou un renvoi inutile mĂ©ritent un regard (minuteur mal calibrĂ©, chemin de retour ACK asymĂ©trique) ;
- vĂ©rifie que les options TCP nĂ©gociĂ©es au handshake (MSS, Window Scale, SACK Permitted) arrivent intactes d'un bout Ă l'autre du chemin â un MSS rĂ©duit en route est souvent une adaptation normale (tunnel/VPN), mais une option Window Scale ou SACK retirĂ©e par un Ă©quipement plafonne la fenĂȘtre TCP effective ou dĂ©grade la rĂ©cupĂ©ration de perte ;
- décapsule et analyse le trafic réel à travers des tunnels MPLS, GRE, VXLAN, GTP-U, ERSPAN et CAPWAP (WiFi Aruba/Cisco cÎté filaire) ;
- décompose une transaction en temps réseau vs temps de traitement serveur pour trancher entre ralentissement réseau et ralentissement applicatif ;
- suit les transactions DHCP (DISCOVER/OFFER/REQUEST/ACK/NAK) et les appels SIP (INVITEâ200âACK, Ă©checs, User-Agent/Server) ;
- suit les transactions DNS entre points de capture : requĂȘte/rĂ©ponse manquante sur un segment, requĂȘte sans aucune rĂ©ponse observĂ©e nulle part (timeout ou serveur/rĂ©solveur injoignable), rĂ©ponses NXDOMAIN et SERVFAIL (Ă©chec de rĂ©solution cĂŽtĂ© serveur â souvent pris Ă tort pour un problĂšme rĂ©seau), et durĂ©e moyenne de rĂ©solution ;
- suit les transactions HTTP/1.x entre points de capture (mĂȘme principe que DNS) : requĂȘte/rĂ©ponse manquante sur un segment, requĂȘte sans aucune rĂ©ponse observĂ©e nulle part, rĂ©ponses d'erreur 4xx (info, souvent lĂ©gitime cĂŽtĂ© client) et 5xx (anomalie, Ă©chec serveur/applicatif â souvent pris Ă tort pour un problĂšme rĂ©seau, avec quelques exemples concrets mĂ©thode+URI+code), et durĂ©e moyenne de rĂ©ponse (calculĂ©e nativement par tshark, pas recomposĂ©e Ă la main) ; HTTP/2 et HTTP/3 (QUIC) ne sont pas couverts par cette section ;
- calcule la qualité vocale (MOS/R-factor) sur les flux RTP détectés et
rattache chaque flux Ă son appel SIP par le SDP (lignes
c=/m=de l'offre et de la rĂ©ponse), avec repli sur la fenĂȘtre temporelle de l'appel ; la mĂ©thode retenue (sdp,time_window,mixed) est toujours affichĂ©e ; - diagnostique les handshakes TLS par segment (SNI, cipher nĂ©gociĂ©, alertes fatales) et localise oĂč un handshake qui aboutissait se met Ă Ă©chouer (indice d'inspection TLS/pare-feu sur SNI) ;
- extrait le SNI des paquets QUIC/HTTP3 Initial (v1, RFC 9001) en levant la protection d'en-tĂȘte et en dĂ©chiffrant l'AEAD avec les clĂ©s initiales (dĂ©rivation publique, pas un secret de session) â utile pour voir la visio moderne (Meet, Teams...) qui passe de plus en plus par QUIC plutĂŽt que par du RTP classique ;
- compare deux jeux de captures avant/aprÚs (correctif, changement de config, site A vs site B) et ne remonte que les régressions/améliorations significatives, avec code de sortie exploitable en CI ;
- compare des clients entre eux sur la mĂȘme capture (« ce poste
fonctionne, pas l'autre ») : regroupe les paquets par IP de poste
(
--client-group), relance l'analyse sĂ©parĂ©ment pour chaque client puis diffe chaque client contre un client de rĂ©fĂ©rence â troisiĂšme axe de comparaison, orthogonal au chemin rĂ©seau (point A vs point B) et au temps (avant vs aprĂšs) ; enrichi des signatures dĂ©jĂ partiellement captĂ©es (vendor DHCP, User-Agent SIP) pour distinguer un Ă©cart rĂ©seau d'une version logicielle diffĂ©rente ; - triage inter-catĂ©gories : un segment oĂč plusieurs types d'anomalies convergent (RST + QoS + fragmentation en mĂȘme temps, par exemple) remonte en tĂȘte plutĂŽt qu'un simple tri par nombre brut de constats ; condensĂ© en un score de santĂ© synthĂ©tique (0-100) pour une lecture en un coup d'Ćil (console, JSON, badge colorĂ© en tĂȘte du PDF) ;
- génÚre un rapport PDF (synthÚse à seuils, graphiques, diagramme de topologie) ou un export JSON structuré (constats, triage, score de santé, diagnostics TLS/QUIC) pour l'intégration externe (dashboard, ticketing), et propose une interface GTK4 en plus du CLI ;
- anonymise les adresses IP/MAC (
--redact) avant l'analyse, pour partager un rapport ou une capture sans exposer l'adressage réel (support vendeur, ticket externe) ; - conserve un historique inter-runs (
--history-db, base SQLite locale) : score de santĂ© et constats par sĂ©vĂ©ritĂ© de chaque run, pour suivre une tendance dans le temps (contrĂŽle pĂ©riodique du mĂȘme lien) plutĂŽt qu'un seul instantanĂ©.
Tout est fait pour ĂȘtre automatique : les protocoles applicatifs (RTP, DHCP, SIP, DNS, HTTP, tunnels) sont dĂ©tectĂ©s directement dans le contenu des paquets, sans configuration prĂ©alable.
netcross analyse des fichiers .pcap/.pcapng dĂ©jĂ enregistrĂ©s â il ne
capture rien lui-mĂȘme. La qualitĂ© du rĂ©sultat dĂ©pend entiĂšrement de la façon
dont ces captures ont été prises. Voici les méthodes courantes, leurs
avantages/inconvénients, et ce qu'il faut savoir pour bien les utiliser avec
cet outil.
La méthode la plus accessible : on configure un port du switch pour qu'il
reçoive une copie du trafic d'un ou plusieurs autres ports/VLAN, et on y
branche une machine qui capture avec tcpdump/dumpcap.
# sur la machine de capture branchee sur le port SPAN
sudo tcpdump -i eth0 -w capture_pointA.pcapng -s 0- Avantages : pas de matériel supplémentaire, disponible sur la plupart des switchs manageables.
- Limites Ă connaĂźtre : un port SPAN peut lui-mĂȘme saturer et dropper si le trafic agrĂ©gĂ© dĂ©passe sa capacitĂ© (donc perdre des paquets qui n'ont jamais Ă©tĂ© perdus sur le vrai lien) ; il ne restitue gĂ©nĂ©ralement pas les trames en erreur L1/L2. Ă interprĂ©ter avec prudence si l'outil signale des pertes uniquement au point SPAN et nulle part ailleurs.
Un boßtier physique inséré en coupure sur le lien, qui duplique le signal électrique/optique sans y participer activement. Plus fidÚle qu'un SPAN, notamment pour les erreurs physiques et en cas de lien déjà saturé.
- Avantages : capture exhaustive, aucun risque de saturation du miroir, restitue les trames que le SPAN peut avaler.
- Limites : nécessite d'insérer un boßtier physique (coupure de service au moment de l'installation), un TAP par lien à observer.
tcpdump/dumpcap lancé directement sur la machine cliente ou serveur
concernée.
sudo tcpdump -i any -w capture_serveur.pcapng -s 0 host 10.0.1.10- Avantages : simple, pas de matériel, donne le point de vue exact d'un des deux bouts de la communication (utile pour la décomposition temps réseau/temps serveur, section correspondante du rapport).
- Limites : la charge CPU de la capture elle-mĂȘme peut lĂ©gĂšrement influencer la machine observĂ©e sur des liens trĂšs chargĂ©s ; ne montre pas ce qui se passe avant d'arriver sur cette machine.
Utile quand on ne peut pas facilement récupérer un fichier depuis une machine distante (équipement sans accÚs direct, capture ponctuelle) :
ssh user@routeur "tcpdump -i eth0 -w - -s 0" > capture_routeur.pcapng- VMware (vSphere/ESXi) : port mirroring sur un vSwitch distribué (dvPort group en mode "promiscuous" ou politique de port mirroring dédiée).
- Proxmox / KVM/libvirt : mise en promiscuité de l'interface bridge
(
ip link set br0 promisc on) ou capture directe sur l'interfacetapcorrespondant Ă la VM, depuis l'hyperviseur. - Avantages : capture au plus prĂšs de la VM sans agent dedans ; utile pour voir le trafic est-ouest entre VM du mĂȘme hyperviseur, invisible depuis un SPAN physique.
- AWS : VPC Traffic Mirroring (copie vers une instance ou un load balancer Gateway Load Balancer).
- Azure : Virtual Network TAP (vTAP) ou Network Watcher.
- GCP : Packet Mirroring.
Ces solutions produisent en général du trafic encapsulé (VXLAN le plus
souvent cĂŽtĂ© AWS) â netcross dĂ©capsule VXLAN nativement, donc ces captures
sont directement exploitables une fois exportées en .pcap.
Pour analyser le trafic d'un client WiFi, capturer sur le lien filaire entre
le point d'accĂšs et le contrĂŽleur (CAPWAP, UDP/5247). Si le canal data n'est
pas chiffré par DTLS, netcross décapsule automatiquement et analyse le
trafic client réel (voir Limites connues pour la
couverture exacte de ce module). Pour de l'analyse RF pure (retries radio,
RSSI, roaming), ajouter une capture en mode moniteur avec radiotap comme point
de capture « segment radio » : voir Limites connues et
docs/detectors.md.
- Synchroniser les horloges (NTP, idĂ©alement PTP) sur toutes les machines de capture avant de commencer â sans ça, seule la latence corrigĂ©e (estimĂ©e via les handshakes TCP) reste exploitable, pas la latence brute.
- Ne pas tronquer les paquets :
tcpdump -s 0/dumpcapsans snaplen rĂ©duit â un payload tronquĂ© empĂȘche la dĂ©tection RTP/DHCP/SIP/DNS et la corrĂ©lation tolĂ©rante au NAT. - DĂ©sactiver les offloads NIC avant capture
(
ethtool -K eth0 gro off lro off tso off gso off) pour voir les vrais paquets tels qu'ils circulent sur le cĂąble, pas ceux reconstruits par le pilote. - Format pcapng avec horodatage nanoseconde plutĂŽt que pcap classique (microseconde), utile dĂšs que les points de capture sont proches et donc la latence entre eux trĂšs faible.
- Documenter l'emplacement physique de chaque capture au moment de la prise â l'outil dĂ©duit l'ordre logique automatiquement, mais ne peut pas deviner Ă quel Ă©quipement physique correspond chaque point.
- Si un NAT/PAT est traversé entre deux points de capture, utiliser
--nat-tolerant(corrélation par empreinte de payload plutÎt que par IP/port).
git clone <url-du-depot> netcross
cd netcross
./install.sh # CLI + interface graphique GTK4
./install.sh --cli-only # CLI et rapport PDF seulement, sans GTK4Voir Construire les paquets .deb / .rpm.
Installe les commandes netcross, netcross-diff, netcross-history,
netcross-batch, netcross-ai-models, netcross-lua-doc et
netcross-gui directement dans /usr/bin.
pip install -r requirements.txt
# l'interface GTK4 necessite en plus les paquets systeme python3-gi et
# gir1.2-gtk-4.0 (Debian/Ubuntu) ou python3-gobject et gtk4 (RHEL/Rocky)python3 src/cross_capture_analyzer_cli.py \
--capture LAN=capture_lan.pcapng \
--capture WAN=capture_wan.pcapng \
--capture DC=capture_datacenter.pcapng \
--pdf-report rapport.pdf--order est optionnel : sans lui, l'ordre et la topologie (y compris
les branchements/convergences) sont déduits automatiquement à partir du TTL
et du recouvrement de flux entre points. Le fournir permet de valider cet
ordre déduit (l'outil signale toute incohérence).
Options utiles :
--nat-tolerant: corrĂ©lation par empreinte de payload si un NAT est traversĂ© entre deux points.--capture NOM=chemin1,chemin2,...: plusieurs fichiers sĂ©parĂ©s par des virgules pour un mĂȘme point rejouent une capture segmentĂ©e (rotationtcpdump -C/tshark -b) comme un seul point continu, sans fusion prĂ©alable (mergecapou autre) â Ă lister dans l'ordre chronologique. Fonctionne aussi avec--parallel(un processustsharkpar segment). MĂȘme syntaxe sur--baseline/--currentdu CLI de comparaison ci-dessous.--split-interfaces: un fichier pcapng peut contenir plusieurs captures, une par interface (IDB) et par section (fichiers concatĂ©nĂ©s,mergecap -I none). Chaque capture d'un--capture NOM=fichier.pcapngdevient alors un point distinct nommĂ©NOM:INTERFACE(optionif_namedu fichier, sinonifN, ousS-ifNs'il y a plusieurs sections). Un fichier Ă une seule capture est lu tel quel.mergecapsans-I nonefusionne les interfaces dĂ©crites Ă l'identique : elles ne sont alors plus sĂ©parables (#474).--bucket-ms: largeur des fenĂȘtres temporelles pour le dĂ©bit et la corrĂ©lation pertes/saturation (dĂ©faut 1000ms, rĂ©duire pour des microbursts).--rtp-clock-rate: cadence d'horloge RTP (8000Hz voix par dĂ©faut, 90000 pour de la vidĂ©o).--link-speed POINT=VITESSE(rĂ©pĂ©table, ex.A=1G,B=2.5G) : vitesse du lien d'un point, utilisĂ©e seulement si le pcapng ne porte pas l'optionif_speed; la section « Vitesse des liens » du rapport indique la source retenue et la rĂ©solution d'horodatage (if_tsresol) de chaque point.--idle-timeout-seconds: seuil (en secondes) au-delĂ duquel un silence entre deux paquets consĂ©cutifs d'une connexion TCP dĂ©jĂ Ă©tablie est signalĂ© comme un timeout d'inactivitĂ© / coupure NAT-FW silencieuse (dĂ©faut : 60.0, valeur deanalyse(idle_timeout_seconds=None)). MĂȘme option disponible sur le CLI de comparaison ci-dessous.--parallel: lit les fichiers de capture en parallĂšle (un processus par fichier). Gain rĂ©el dĂ©pendant du nombre de cĆurs CPU disponibles â sur un hĂŽte Ă un seul cĆur, aucun gain et lĂ©ger surcoĂ»t plutĂŽt qu'une accĂ©lĂ©ration (mesurĂ©, voir Limites connues) ;--parallel-workersau-delĂ du nombre de cĆurs dĂ©tectĂ©s dĂ©grade encore la situation (sur-souscription). Les deux CLI avertissent explicitement dans ces deux cas.--detail-csv: export du dĂ©tail par flux.--triage: classement des segments par convergence de plusieurs catĂ©gories de constats ("par oĂč commencer ?"), aussi inclus automatiquement en tĂȘte du rapport--pdf-report.--triage-top-nregle le nombre de segments affiches (defaut 5). Affiche aussi un score de santĂ© synthĂ©tique (0-100) condensant la mĂȘme Ă©vidence en un seul chiffre (Ă©galement inclus dans--json-reportet en badge colorĂ© en tĂȘte du rapport--pdf-report). Sous chaque constat qui en porte une, affiche aussi les preuves brutes ayant menĂ© Ă ce constat (exemples dĂ©jĂ collectĂ©s pendant l'analyse â segment TCP, Ă©change DHCP/DNS/HTTP/SIP manquant, etc., voir "preuves" ci-dessous).--tls/--quic: diagnostics TLS et QUIC/HTTP3 sur les mĂȘmes fichiers passĂ©s Ă--capture(--quicnĂ©cessitecryptography; pipeline de dĂ©codage indĂ©pendant de celui utilisĂ© pour le reste de l'analyse mais passant lui aussi par tshark, voirnetcross_core/tls_diagnostics.pyetquic_diagnostics.py). CombinĂ©s Ă--pdf-report, ces diagnostics sont aussi integres au rapport PDF (section dediee + triage global).--security-report/--cve-db CHEMIN: rapport de sĂ©curitĂ© consolidĂ© (dĂ©tection passive de vulnĂ©rabilitĂ©s, issue #139) â services dĂ©tectĂ©s (versions lues dans les banniĂšres) classĂ©s par criticitĂ©, tentatives d'exploitation (signatures Log4Shell, Shellshock, Heartbleed, EternalBlue, traversĂ©es Apache 2.4.49/2.4.50, injections SQL et de commande, wrappers PHP, XSS⊠cherchĂ©es dans la charge utile brute des fichiers--capture, comme--tls), anomalies Expert Info corrĂ©lĂ©es (fuzzing/overflow/dos), CVE confirmĂ©es par corrĂ©lation version + CVE-ID + score CVSS, tableau de bord et score de risque global 0-100 (sĂ©vĂ©ritĂ©s critique/Ă©levĂ©e/moyenne/faible).--cve-dbdĂ©signe la base SQLite produite parscripts/import_nvd.py(fichier existant exigĂ©) ; sans elle, une base minimale embarquĂ©e (netcross_core/data/cve_seed.json, une trentaine de CVE critiques extraites du NVD : Apache 2.4.49/2.4.50, regreSSHion, Heartbleed, vsftpd 2.3.4âŠ) est utilisĂ©e et la CLI le signale (une version absente de cette sĂ©lection n'est pas pour autant « non vulnĂ©rable »). Aucune CVE n'est rattachĂ©e Ă un service sans correspondance exacte de nom et de version, et une signature d'exploit est une tentative observĂ©e, jamais une compromission confirmĂ©e. RefusĂ© avec--live,--redact(relecture des fichiers bruts, comme--tls) et les modes utilitaires--merge/--split/--replay. DĂ©tail, choix de sĂ©vĂ©ritĂ© et limites :docs/security-report.md.--live LABEL:INTERFACE[:FILTRE_BPF]: capture en direct sur une interface reseau plutot que sur des fichiers deja captures (repetable pour plusieurs points simultanes). S'arrete sur Ctrl+C ou--live-duration SECONDES. Mutuellement exclusif avec--capture/--parallel/--tls/--quic(mĂȘmes limitations que le mode live de la GUI). Necessite les memes droits que tshark en direct (root, ou capacitesCAP_NET_RAW/CAP_NET_ADMINsurdumpcap).--replay INTERFACE: rejoue le fichier passĂ© Ă--capture(un seul, exactement) surINTERFACEviatcpreplay(paquet systĂšme distinct detshark, Ă installer sĂ©parĂ©ment âapt install tcpreplay/dnf install tcpreplay), puis s'arrĂȘte SANS lancer d'analyse.â ïž Usage responsable : cette option Ă©met du trafic rĂ©seau RĂEL surINTERFACE. Ne jamais l'utiliser sur une interface connectĂ©e Ă un rĂ©seau de production sans autorisation explicite â le rejeu peut saturer un lien, dĂ©clencher des alarmes IDS/IPS, ou réémettre des paquets Ă adresse source usurpĂ©e. Ă rĂ©server Ă un banc de test isolĂ© (interface loopback/veth/bridge dĂ©diĂ©, labo), sauf besoin explicite et maĂźtrisĂ© d'un rejeu sur un segment rĂ©el (test de pare-feu, validation QoS).--replay-speedrĂšgle la vitesse par rapport Ă la vitesse d'origine du fichier (1.0= vitesse d'origine,0.5= deux fois plus lent,2.0= deux fois plus rapide, outopspeedpour rejouer aussi vite que l'interface/le noyau le permettent sans respecter les timestamps d'origine).--replay-loop Nrejoue le fichierNfois (dĂ©faut 1). Incompatible avec--live/--merge/--splitet avec les options d'analyse/de rapport (comme--merge, plusieurs fichiers segmentĂ©s doivent d'abord ĂȘtre fusionnĂ©s en un seul).--flow-timeline chronologie.json: chronologie de chaque conversation, point par point (les copies d'un mĂȘme paquet vues Ă plusieurs points ne sont pas mĂ©langĂ©es) et dans les deux sens : inter-arrivĂ©es (min, max, moyenne, mĂ©diane), dĂ©bit par fenĂȘtre de--flow-timeline-windowsecondes (dĂ©faut 1), phases (slow-start, rĂ©gime Ă©tabli, rafale, inactivitĂ©), RTT estimĂ© sur la poignĂ©e de main. Les conversations d'un seul paquet sont omises.--forensic-search resultats.json: recherche dans les paquets et les flux dĂ©codĂ©s. Les critĂšres sont combinĂ©s par ET :--search-text(texte libre, insensible Ă la casse),--search-address,--search-point,--search-protocol,--search-port, et--search-field(sni,uri,http_status,call_id,dns_name,method,content_type,message) avec--search-value. Le JSON rappelle la requĂȘte et le nombre de rĂ©sultats ; sans critĂšre, tout est listĂ©. Par exemple :--forensic-search r.json --search-field uri --search-value admin.--tshark-stats stats.json: statistiquestshark -zde chaque fichier--capture(conversations et endpoints TCP/UDP, hiĂ©rarchie de protocoles, io_stat). Une capture en Ă©chec, par exemple sans tshark, porte une clĂ©erroret un message sur stderr, sans faire perdre les autres. RefusĂ© en--liveseul.--netflow [EXPORTATEUR=]FICHIER(rĂ©pĂ©table) : rĂ©sumĂ© d'un export NetFlow v5 (datagrammes concatenĂ©s, par exemple la charge utile UDP collectĂ©e sur le port du collecteur) â volumes totaux et pĂ©riode, par exportateur, par protocole, principaux Ă©metteurs, conversations et ports de destination (--netflow-top N, dĂ©faut 10). Avec--json-report, le mĂȘme rĂ©sumĂ© est Ă©crit sous la clĂ©netflow. Mode autonome : incompatible avec--capture/--live, car un flux agrĂ©gĂ© vu par un seul routeur ne se corrĂšle pas entre points de capture (voirdocs/adr/netflow-sflow-architecture.md). NetFlow v9 et sFlow ne sont pas encore lus.--json-report chemin.json: export JSON structurĂ© (points, constats, triage, diagnostics TLS/QUIC si--tls/--quicsont fournis) pour l'intĂ©gration externe (dashboard, ticketing, script d'analyse). Aucune dĂ©pendance supplĂ©mentaire (contrairement Ă--pdf-report) â toujours disponible. Chaque constat qui a une preuve rattachĂ©e (voir--triageci-dessus) porte une clĂ©evidence(liste de{"point": ..., "text": ...}) â absente sinon, commesample_size. Sur la catĂ©gorie PMTUD uniquement (pilote, voir "preuves" ci-dessous), chaque ligne de preuve porte aussi une clĂ©frame_numberquand le numĂ©ro de trame tshark du paquet reprĂ©sentatif est connu. Expose aussi cinq clĂ©s supplĂ©mentaires (objets de contrat de la comparaison OmniPeek/Wireshark, voirdocs/features-backlog.mdsection 13.3 "Session 0") :flows(un flux par entrĂ©e, agrĂ©gation multi-points dĂ©jĂ calculĂ©e par la corrĂ©lation),conversations(regroupement par paire d'adresses),expert_events(vue gĂ©nĂ©rique des constats, aveccause/impactprobables quand le moteur de corrĂ©lation causale reconnaĂźt un motif de symptĂŽmes co-occurrents sur un mĂȘme segment,nullsinon),diagnoses(regroupement desexpert_eventspar segment),compliance(statutCONFORME/VIOLATION/INDETERMINEcontre 2 rĂ©fĂ©rentiels par dĂ©faut : absence de noir PMTUD, taux de perte †1%). Une sixiĂšme clĂ©,wireshark_expert_events(Session 1 de la mĂȘme section 13.3, "exploitation de l'expertise Wireshark/TShark"), porte les signaux d'expertise BRUTS dĂ©jĂ produits par tshark lui-mĂȘme (retransmissions, ACK dupliquĂ©s, fenĂȘtre nulle...), regroupĂ©s par point et par type de signal, sur toutes les couches du paquet (pas seulement TCP) â jamais fondus dansexpert_eventsci-dessus (sourcevaut"tshark"ici contre"netcross"pourexpert_events) : ce sont des preuves supplĂ©mentaires brutes, pas des diagnostics Netcross. La sĂ©vĂ©ritĂ© de chaque entrĂ©e reflĂšte la sĂ©vĂ©ritĂ© NATIVE tshark quand elle est disponible (Error/Warning/Note/Chat/Commenttraduits versanomalie/a_surveiller/info), avec repli sur une table interne pour les flags dĂ©jĂ connus de ce projet sinon ; chaque ligne deevidenceinclut le message natif tshark quand il est disponible, en plus des adresses et du libellĂ©. Chaque entrĂ©ewireshark_expert_eventsporte aussi trois clĂ©s supplĂ©mentaires (Session 2 de la section 13.3, "moteur d'Ă©vĂ©nements d'expertise", premier lot) :confidence(0.0 Ă 1.0 â 1.0 si la sĂ©vĂ©ritĂ© est native tshark, 0.7 si le flag est seulement connu de la table interne, 0.4 sinon),first_seen/last_seen(timestamps du premier et du dernier paquet ayant produit ce signal, calculĂ©s sur la totalitĂ© des occurrences). Deux clĂ©s de plus (deuxiĂšme lot de la mĂȘme Session 2) :layer(couche OSI â"liaison"/"reseau"/"transport") etprotocol("ARP"/"STP"/"IPv4"/"IPv6"/"ICMP"/"ICMPv6"/"TCP"/"UDP"), lus directement depuis le prĂ©fixe du nom de flag EK brut ayant produit le signal â pas une dĂ©duction. Trois clĂ©s de plus, ajoutĂ©es dans des lots successifs de la mĂȘme Session 2 :flow_keys(troisiĂšme lot â liste des flux concernĂ©s au sens exact denetcross_core.correlate.flow_key(), calculĂ©e sur la totalitĂ© des occurrences et dĂ©doublonnĂ©e, chaque Ă©lĂ©ment une liste[proto, src, sport, dst, dport, key_id]directement comparable Ă la clĂ©flows/conversationsci-dessus) etpacket_evidence(quatriĂšme lot â liste complĂšte des paquets porteurs du signal, chaque Ă©lĂ©ment{"point": ..., "frame_number": ...}, calculĂ©e elle aussi sur la totalitĂ© des occurrences : contrairement Ăevidenceci-dessus, plafonnĂ©e Ă 5 exemples,packet_evidencen'omet aucune occurrence â utile pour rouvrir le pcap source directement sur chaque paquet concernĂ©, pas seulement les cinq premiers). Une derniĂšre clĂ©,remediation(cinquiĂšme et dernier lot de la Session 2, action de vĂ©rification/remĂ©diation) : piste de vĂ©rification technique rĂ©digĂ©e (pas calculĂ©e), disponible uniquement pour les onze flags EK dĂ©jĂ rĂ©pertoriĂ©s par ce projet (retransmissions, ACK dupliquĂ©, fenĂȘtre nulle/pleine, keep-alive, hors sĂ©quence, ports rĂ©utilisĂ©s...) ânullpour tout autre flag EK (y compris les flags de suivi de connexion TCP commetcp.completeness) plutĂŽt qu'un conseil gĂ©nĂ©rique inventĂ© sans connaĂźtre la nature exacte du signal. Ces huit clĂ©s (confidence/first_seen/last_seen/layer/protocol/flow_keys/packet_evidence/remediation) valent toujoursnull/[]surexpert_events/diagnoses(source"netcross") : unFindingNetcross ne porte aujourd'hui aucune notion de confiance, de timestamp, de couche, de protocole, de flux, de liste complĂšte de paquets calculĂ©e ni de bibliothĂšque de remĂ©diation par catĂ©gorie â voirnetcross_core.expert_model.ExpertEvent.--expert-section: affiche en console les objets enrichis dĂ©crits ci-dessus (expert_eventsavec cause/impact probables,diagnosespar segment,compliance,flows/conversations, signaux tshark bruts), jusqu'ici lisibles uniquement en ouvrant le fichier--json-report. Aucun calcul supplĂ©mentaire : ce sont les mĂȘmes objets, construits une seule fois et partagĂ©s par la console, le PDF et le JSON (voirnetcross_report.session_objects). Les blocsflows/conversationset tshark n'apparaissent que si les donnĂ©es correspondantes ont Ă©tĂ© calculĂ©es par le run â un bloc absent signifie « non calculĂ© », pas « calculĂ© et vide ». IndĂ©pendamment de cette option,--pdf-reportreçoit dĂ©sormais une section « Expertise â objets enrichis » (Ă©vĂ©nements avec cause probable et impact, diagnostics par segment, conformitĂ© aux rĂ©fĂ©rentiels, flux corrĂ©lĂ©s, signaux tshark), placĂ©e juste avant le pied de rapport : les Ă©carts de conformitĂ© (VIOLATION, puisDEVIATION) y remontent en premier, comme dans le triage « par oĂč commencer ». Toujours indĂ©pendamment des options,--pdf-reportreçoit une section « Chemin observĂ© » (juste aprĂšs « Vue d'ensemble ») : une ligne par segment, de l'amont vers l'aval du chemin dĂ©duit, avec dĂ©lai moyen/P95/P99, gigue, taux de perte au point aval, dĂ©bit, remarquages DSCP, nouvelles fragmentations et nombre de sauts â plus un graphique dĂ©lai P95 / perte superposĂ©s. Elle rĂ©pond à « oĂč la qualitĂ© se dĂ©grade-t-elle ? » : le segment le plus dĂ©gradĂ© est signalĂ© en rouge (pertes d'abord, dĂ©lai P95 ensuite). Un tiret cadratin signale une mĂ©trique non mesurable sur ce segment, jamais une valeur nulle.--sequence-diagram [N]: ajoute au--pdf-reportun diagramme de sĂ©quence des Ă©changes pour les N flux les plus volumineux (N=1 si l'option est passĂ©e sans valeur). HĂŽtes en colonnes, temps qui descend, une flĂšche par paquet â la couleur identifie le point de capture, pas le protocole : deux flĂšches de couleurs diffĂ©rentes Ă quelques millisecondes d'Ă©cart sont le mĂȘme paquet vu Ă deux endroits, et cet Ă©cart est son temps de transit. Sous le dessin, une table donne pour chaque ligne le numĂ©ro de trame, la date relative, l'Ă©cart avec la ligne prĂ©cĂ©dente, le point et la taille â de quoi retrouver le paquet dans Wireshark. TronquĂ© Ă 30 lignes par flux (le dĂ©but de l'Ă©change est conservĂ© : handshake, nĂ©gociation, premiĂšre requĂȘte ; la troncature est annoncĂ©e dans le rapport). Sans effet sans--pdf-report.--topn-charts N: nombre de catĂ©gories affichĂ©es par graphique dans la section "Ăvolution temporelle (top-N)" du rapport--pdf-report(dĂ©faut 5, le reste des catĂ©gories est regroupĂ© sous "autres"). Quatre graphiques (protocole / port de destination / IP de destination / marquage DSCP), tracĂ©s pour un seul point de capture (le premier de--order/--capture) â superposer plusieurs points de capture sur la mĂȘme aire empilĂ©e compterait certains paquets en double, un mĂȘme paquet physique pouvant ĂȘtre vu Ă plusieurs points. Sans effet sans--pdf-report.--redact: anonymise les adresses IP (plages de documentation RFC 5737/3849) et MAC (OUI localement administrĂ©) avant l'analyse, avec un mapping cohĂ©rent sur tout le run â pour partager un rapport (ou une capture) sans exposer l'adressage rĂ©el (ticket support vendeur, rapport transmis Ă un tiers). Par dĂ©faut, les noms sont aussi anonymisĂ©s (noms DNS, cible HTTP, SAN/sujet/Ă©metteur des certificats TLS, Call-ID/ User-Agent/Server SIP) ;--redact-scope adresses|noms|toutrestreint la portĂ©e (issue #1153, voirnetcross_core/redact.py). Combinable avec--tls/--quic/--client-groupdepuis l'issue #1155 : les Ă©vĂšnements TLS/QUIC et les adresses des groupes passent par la mĂȘme table de pseudonymes (relecture de fichier ou argument direct). Le rapport (PDF, Markdown, JSON, API) ouvre par un encart « Anonymisation â pĂ©rimĂštre appliquĂ© » qui certifie ce qui a Ă©tĂ© masquĂ© : portĂ©e (--redact-scope), nombre d'adresses et de noms anonymisĂ©s, pcapng anonymisĂ©s produits et traitement de leurs charges utiles, table de correspondance (issue #1159).--redact-pcap DOSSIERĂ©crit en plus un pcapng anonymisĂ© par point de capture (mĂȘmes pseudonymes que le run, sommes de contrĂŽle recalculĂ©es, charges utiles zĂ©roĂ©es par dĂ©faut â--redact-pcap-keep-payloadpour les conserver, horodatages conservĂ©s ou dĂ©calĂ©s uniformĂ©ment via--redact-pcap-decalage, issue #1157).--redact-map chemin.csvconserve la correspondance adresse rĂ©elle â pseudonyme dans un fichier local, Ă ne jamais transmettre avec le rapport ; il porte aussi la table des noms (typesnometdomaine:host-N.domain-M.example.invalid, mĂȘme suffixe pour un mĂȘme domaine parent, module communnetcross_core/pseudonyms.py, issue #1151), remplie dĂšs que des noms sont pseudonymisĂ©s (#1153).--tls-keylog keys.txt(tous les points) ou--tls-keylog CLIENT=keys.txt(un point, prioritaire ; option rĂ©pĂ©table) : fichier de clĂ©s TLS au formatSSLKEYLOGFILE(navigateur,curl,openssl s_client -keylogfile) transmis Ă tshark (-o tls.keylog_file:...) pour dĂ©chiffrer les sessions TLS des captures : HTTP et objets transportĂ©s redeviennent visibles. Le fichier doit exister et ĂȘtre lisible ; nom de point inconnu refusĂ©. RefusĂ© avec--redacttant que l'interaction dĂ©chiffrement/anonymisation n'est pas dĂ©finie, et sans objet en direct (--live). Le contenu du fichier n'est jamais lu ni journalisĂ© par Netcross. Sans l'option, comportement inchangĂ© (issue #1040, chantier #997). Le guide des clĂ©s TLS explique la collecte cĂŽtĂ© navigateur, curl, Java et Python, l'injection DSB avec editcap et les prĂ©cautions de conservation et de partage.--history-db chemin.db: enregistre un rĂ©sumĂ© de ce run (score de santĂ©, nombre de constats par sĂ©vĂ©ritĂ©) dans une base SQLite locale, créée si absente â pour suivre une tendance dans le temps sur des runs successifs (ex : contrĂŽle hebdomadaire du mĂȘme lien). Ne remplace pas--json-report/--pdf-report/--detail-csv(dĂ©tail complet d'un run donnĂ©) : l'historique ne conserve qu'un rĂ©sumĂ© compact par run.--history-label Ă©tiquettedistingue plusieurs historiques qui partagent le mĂȘme fichier.db(plusieurs sites suivis dans la mĂȘme base).--history-show [N]affiche aprĂšs l'analyse les N derniers runs enregistrĂ©s (dĂ©faut 10), filtrĂ© automatiquement sur--history-labelsi elle est fournie.--history-label/--history-shownĂ©cessitent--history-db.
python3 src/cross_capture_analyzer_cli.py \
--capture LAN=capture_lan.pcapng \
--capture WAN=capture_wan.pcapng \
--client-group PosteA=10.0.0.5 \
--client-group PosteB=10.0.0.12,10.0.0.13 \
--client-reference PosteA \
--client-diff-csv client_diff.csvRegroupe les paquets de la mĂȘme capture par poste (IP source ou
destination) plutĂŽt que par point de capture, relance l'analyse pour
chaque client séparément, puis compare chaque client au client de
référence (--client-reference, par défaut le premier --client-group
fourni). Un client peut avoir plusieurs IP (IP1,IP2,..., cas
multi-IP/DHCP) ; --client-group est répétable et nécessite au moins 2
clients. Additif Ă l'analyse principale ci-dessus (n'affecte pas
--triage/--tls/--quic/--pdf-report/--json-report, qui restent
calculés sur l'ensemble des captures sans distinction de client).
--client-diff-csv exporte le détail des écarts par client.
python3 src/cross_capture_diff_cli.py \
--baseline LAN=avant_lan.pcapng --baseline WAN=avant_wan.pcapng \
--current LAN=apres_lan.pcapng --current WAN=apres_wan.pcapng \
--triage --tls --quic \
--pdf-report diff.pdfRĂ©utilise les mĂȘmes noms de point des deux cĂŽtĂ©s (LAN, WAN...) pour
permettre la comparaison point par point. Renvoie un code de sortie non nul
si au moins une rĂ©gression est dĂ©tectĂ©e â exploitable directement en CI.
--diff-csv exporte le détail des écarts, --pdf-report génÚre un rapport
PDF dédié (triage + synthÚse + table des écarts).
Options supplémentaires (parité avec cross_capture_analyzer_cli.py) :
--idle-timeout-seconds: mĂȘme seuil que surcross_capture_analyzer_cli.pyci-dessus, appliquĂ© aux deux scĂ©narios (baseline et courant).--triage/--triage-top-n: mĂȘme classement par convergence de catĂ©gories que sur l'analyzer, calculĂ© sur les Ă©carts (DiffFinding) â dĂ©jĂ inclus automatiquement en tĂȘte de--pdf-report, ce flag l'affiche aussi sur la sortie console. Affiche aussi le score de santĂ© synthĂ©tique (0-100) â ici, l'ampleur des rĂ©gressions dĂ©tectĂ©es entre baseline et courant, pas un Ă©tat absolu (100 = aucune rĂ©gression significative). Sous chaque Ă©cart qui en porte une, affiche aussi les preuves brutes (mĂȘmes catĂ©gories cĂąblĂ©es que sur l'analyzer â PMTUD, NAT/ Pare-feu, ARP, STP, TLS, MSS, DNS, HTTP â, toujours issues du rapport courant).--tls/--quic: diagnostics exĂ©cutĂ©s sĂ©parĂ©ment sur le baseline et sur le run courant (ces deux modules ne connaissent qu'un Ă©tat Ă un instant donnĂ©, pas de vraie diff sĂ©mantique possible entre les deux), affichĂ©s l'un aprĂšs l'autre en console et dans une section dĂ©diĂ©e du PDF â comparer les deux Ă l'Ćil plutĂŽt que d'y chercher un Ă©cart chiffrĂ©.--quicnĂ©cessitecryptography. Indisponibles avec--live-current(voir ci-dessous).--json-report chemin.json: export JSON structurĂ© de comparaison (points baseline/courant, Ă©carts, triage, diagnostics TLS/QUIC), mĂȘme principe que sur l'analyzer. Les diagnostics TLS/QUIC y sont exposĂ©s sĂ©parĂ©ment (tls_findings_baseline/tls_findings_current/...), pas fondus dans les Ă©carts principaux â mĂȘme raison que dans le PDF. Chaque Ă©cart qui a une preuve rattachĂ©e (voir--triageci-dessus) porte lui aussi une clĂ©evidence, toujours issue du rapport courant (jamais du baseline) â absente sinon, commesample_size.--live-current LABEL:INTERFACE[:FILTRE_BPF](rĂ©pĂ©table) : capture en direct le run courant au lieu de le lire depuis des fichiers â mutuellement exclusif avec--current(l'un des deux est requis). Le baseline reste toujours un ou plusieurs fichiers via--baseline: une rĂ©fĂ©rence de comparaison est par nature dĂ©jĂ enregistrĂ©e, la capturer en direct en parallĂšle n'aurait pas de sens et n'a pas de prĂ©cĂ©dent cĂŽtĂ© GUI (mode comparaison et capture live y sont mutuellement exclusifs).--live-durationfixe une durĂ©e max optionnelle (sinon Ctrl+C). Mutuellement exclusif avec--parallel/--tls/--quic(mĂȘmes limitations assumĂ©es que--livesurcross_capture_analyzer_cli.py). Exemple :python3 src/cross_capture_diff_cli.py \ --baseline LAN=avant_lan.pcapng \ --live-current LAN:eth0 \ --live-duration 60 \ --triage --diff-csv regressions.csv--redact/--redact-map: mĂȘme anonymisation que surcross_capture_analyzer_cli.py(voir ci-dessus), avec un seul mapping partagĂ© entre baseline et courant â une adresse rĂ©elle prĂ©sente des deux cĂŽtĂ©s garde le mĂȘme pseudonyme, sans quoi la comparaison perdrait son sens. Combinable avec--tls/--quicdepuis l'issue #1155 (mĂȘme table de pseudonymes ; pas de--client-groupsur ce CLI).--tls-keylog [NOM=]FICHIER: mĂȘme option que surcross_capture_analyzer_cli.py, appliquĂ©e aux captures--baselineet--current(mĂȘmes noms de points des deux cĂŽtĂ©s) ; refusĂ©e avec--redact.--history-db/--history-label/--history-show: mĂȘme mĂ©canisme que surcross_capture_analyzer_cli.py(voir ci-dessus) â un mĂȘme fichier.dbpeut mĂ©langer des runs d'analyse et de comparaison (--history-showles affiche ensemble, plus rĂ©cent d'abord).
netcross-history (cross_history_cli.py) interroge une base dĂ©jĂ
alimentĂ©e par --history-db, sans capture ni comparaison Ă fournir â
utile pour vérifier une tendance sans avoir de nouvelles captures sous
la main. Aucun prérequis tshark : ce script ne lit jamais de capture.
# tout l'historique d'un fichier
netcross-history --db suivi_site_a.db
# les 10 derniers runs d'un site donne, tous types confondus
netcross-history --db suivi_partage.db --label Site-A --limit 10
# seulement les comparaisons (--run-type diff) d'un fichier partage
netcross-history --db suivi_partage.db --run-type diff--db CHEMIN: seul argument obligatoire. Un chemin qui n'existe pas encore n'est pas une erreur : affiche simplement un historique vide.--label ĂTIQUETTE: ne montre que les runs portant cette Ă©tiquette exacte (voir--history-labelci-dessus).--run-type {analyse,diff}: ne montre que les runs de ce type. Combinable avec--label.--limit N: nombre maximum de runs affichĂ©s (dĂ©faut : tous), les plus rĂ©cents en premier.
netcross-lua-doc (netcross_lua_doc_cli.py, aussi accessible par
netcross lua-doc) consulte l'API Lua de Wireshark sans connexion :
classes, méthodes, fonctions globales et attributs, avec arguments,
valeurs de retour, erreurs, version d'apparition et exemples.
# recherche libre (plein texte) : signature + résumé de chaque résultat
netcross lua-doc tvb range
netcross-lua-doc "source port"
# fiche complÚte d'une classe (méthodes, arguments, retours, exemples, attributs)
netcross-lua-doc --class Tvb
# détail complet de chaque résultat, liste des classes
netcross-lua-doc --full ProtoField.uint32
netcross-lua-doc --classes
# sortie JSON pour les scripts
netcross-lua-doc --json --class Pinfo | jq -r '.classe.attributs[].nom_complet'- Codes de retour :
0résultat affiché,1aucun résultat, classe inconnue ou JSON introuvable,2erreur d'usage. --limit N(défaut 20),--full,--json,--class NOM(insensible à la casse),--classes.- La banque SQLite est construite au premier appel dans
~/.cache/netcross/lua_api.dbdepuisdata/lua_api.json(dépÎt) ou/usr/share/netcross/data/lua_api.json(paquet), puis reconstruite automatiquement quand ce JSON change.--sourceouNETCROSS_LUA_API_JSONdésignent un autre JSON,--dbune autre base.
Chaßne de régénération pour une nouvelle version de Wireshark :
# 1. JSON depuis la doc AsciiDoc officielle (tools/make-wsluarm.py de Wireshark)
python3 tools/extract_lua_api.py --tag v4.6.9 # ou --wireshark-src DIR
# 2. (facultatif) base SQLite explicite ; sinon construite à la volée
python3 scripts/build_lua_db.py --input data/lua_api.json --db data/lua_api.dbcd src && python3 -m netcross_gtk4.app
# ou, si installe via .deb/.rpm :
netcross-guiTrois pages navigables : Configuration (captures + options), Travail (journal d'avancement en temps réel), Résultats (rapport + export CSV/PDF).
La GUI propose désormais la lecture parallÚle, la déduction automatique de
topologie (case à cocher, équivalent à ne pas passer --order), le triage,
les diagnostics TLS/QUIC, l'export CSV du détail par flux, l'export JSON
structuré (bouton "Exporter en JSON", équivalent GUI de --json-report,
disponible en mode simple et en mode comparaison â en mode simple, il porte
dĂ©sormais les mĂȘmes clĂ©s que la CLI, objets enrichis compris
(flows/conversations/expert_events/diagnoses/compliance/
wireshark_expert_events), et l'export PDF de la GUI reçoit la mĂȘme section
« Expertise â objets enrichis » que --pdf-report), l'anonymisation des
adresses (case "Anonymiser les adresses IP/MAC (--redact)", combinable avec
les diagnostics TLS/QUIC des deux modes depuis l'issue #1155), et un mode
comparaison (case Ă cocher en haut de la page Configuration) qui bascule
sur deux listes de captures (Baseline/Courant) et reproduit
cross_capture_diff_cli.py â export PDF, CSV et JSON des Ă©carts inclus,
avec ses propres cases TLS/QUIC dédiées au mode comparaison.
Elle propose aussi un mode capture en direct (case "Capture en direct") :
un panneau nom/interface/filtre BPF par point plutÎt qu'un sélecteur de
fichiers, dĂ©marrage/arrĂȘt manuel (ou durĂ©e max optionnelle), compteur de
paquets par point mis Ă jour en direct dans le journal. Mode analyse simple
uniquement (pas de comparaison), TLS/QUIC indisponibles dans ce mode
(nécessitent un fichier à relire, qu'une capture live ne produit pas). Le
"top N" du triage est réglable directement dans la GUI (à cÎté de la case
"Triage"), équivalent à --triage-top-n cÎté CLI ; le nombre de catégories
affichées par graphique dans le rapport PDF (mode simple) l'est aussi
(spinbutton dédié, équivalent GUI de --topn-charts).
Cartographie des communications (section repliable de la page
Résultats, sans équivalent CLI) : un graphe orienté des échanges observés,
un nĆud par hĂŽte (taille â volume), une flĂšche par sens (Ă©paisseur â
volume). Rouge = au moins un signal d'expertise (retransmission,
expert_flags tshark) â sur le nĆud comme sur l'arĂȘte. Trois filtres
recalculent le dessin Ă la volĂ©e : protocole, Top-N d'arĂȘtes (15 par
défaut), « anomalies seulement ». Le graphe reste orienté : un échange
TCP produit donc deux flÚches, ce qui est précisément ce qui permet de voir
qu'un sens passe et que l'autre ne répond pas. Deux points de vue sur le
mĂȘme paquet ne gonflent pas les volumes : pour chaque flux, le comptage
retient le point de capture qui en a vu le plus, jamais la somme des points
(contrairement au diagramme de sĂ©quence, oĂč chaque observation est
volontairement une ligne). La légende sous le dessin annonce le filtrage
(« 15 arĂȘte(s) affichĂ©e(s) sur 132 ») pour qu'un graphe tronquĂ© ne passe
pas pour un graphe complet. Le calcul vit dans
netcross_report/comm_map.py â sans GTK ni matplotlib, donc testable sans
interface graphique (29 tests) ; le rendu est charts.chart_comm_map(). La
vue se désactive aprÚs une comparaison baseline/courant, qui ne conserve
pas les flux.
Annotations / signets (section repliable de la page Résultats) :
étiquette et commentaire libres posés sur un numéro de trame (celui
qu'affiche Wireshark ou un constat), pour un point de capture choisi dans
la liste. Chaque annotation est écrite immédiatement dans le sidecar
JSON de sa capture, <capture>.annotations.json, puis relue Ă l'analyse
suivante des mĂȘmes fichiers. Un clic droit sur une annotation propose
« Ajouter une étiquette sur cette trame » (formulaire prérempli) ou
« Supprimer cette étiquette » ; sur la liste vide, « Ajouter une
étiquette ». Une case par étiquette présente filtre la vue (aucune cochée
= tout afficher). Une saisie invalide (trame non numérique, étiquette vide)
affiche un message plutĂŽt que d'ĂȘtre ignorĂ©e. Un sidecar illisible passe
son point en lecture seule : il n'est jamais écrasé, les autres points
restent annotables. La section est vide aprĂšs une comparaison ou une
capture en direct, qui n'ont pas de fichier de capture Ă annoter. La
logique est dans netcross_gtk4/annotations_view.py (AnnotationStore,
testée sans GTK) et le widget dans netcross_gtk4/annotations_panel.py.
Sécurité (case « Rapport de securite », mode simple sur fichiers ;
section repliable de la page RĂ©sultats) : mĂȘme analyse que
--security-report. Elle relit les signatures d'exploits dans les fichiers,
corrÚle les CVE avec la base minimale embarquée (la GUI n'a pas d'équivalent
de --cve-db) et affiche le mĂȘme rendu texte que la CLI. Deux boutons
exportent ce rapport en HTML (équivalent --security-html) ou en JSON
(clé security_report de --json-report). Les exports JSON et PDF
généraux de la GUI portent aussi ce rapport. Comme en CLI, la case est
désactivée avec l'anonymisation des adresses, et la section l'est aprÚs
une comparaison.
Parité restante avec le CLI : la capture en direct est désormais
disponible sur les deux CLI â --live sur cross_capture_analyzer_cli.py
et --live-current sur cross_capture_diff_cli.py (voir ci-dessus, le
baseline y reste toujours un fichier). La GUI, de son cÎté, n'expose pas
la capture en direct en mode comparaison (mode comparaison et capture live
y restent mutuellement exclusifs).
Suite de tests automatisĂ©s (pytest) couvrant le cĆur analytique
(netcross_core), la couche de décodage (pcap_parser) et la synthÚse/
triage (netcross_report) â 720 tests, sans dĂ©pendance Ă tshark,
scapy ni GTK4 (paquets et couches EK construits synthétiquement).
uv sync --extra dev # gestionnaire de dependances canonique depuis la Session 55
uv run pytest
# repli sans uv (voir requirements.txt/requirements-dev.txt) :
# pip install -r requirements.txt -r requirements-dev.txt
# pytestCouverture partielle depuis les Jobs 4 et 16 : netcross_report/pdf.py et
charts.py ont des tests structurels (nombre de lignes des tables,
sections absentes quand il n'y a rien Ă dire, fichier PNG produit), pas de
comparaison de rendu â le rendu reste relu Ă l'Ćil sur un PDF de test.
Non couverts pour l'instant : le reste du rendu matplotlib/reportlab et
netcross_gtk4/ (interface graphique),
ainsi que l'invocation rĂ©elle du sous-processus tshark â voir
docs/sessions/session-06.md et docs/features-backlog.md section 4 pour le détail.
Lint, formatage et respect de l'architecture en couches sont vérifiés par
ruff (lint + format) et
import-linter (couches),
orchestrés par pre-commit :
uv sync --extra dev # gestionnaire de dependances canonique depuis la Session 55
uv run pre-commit install # une fois par clone : active les hooks sur `git commit`
uv run pre-commit run --all-files
# repli sans uv : pip install -r requirements.txt -r requirements-dev.txt- Lint + format (
ruff check/ruff format, config danspyproject.toml) :line-length = 120, ciblepy39, imports absolus uniquement (from .module import ...est banni â prĂ©fĂ©rerfrom netcross_core.module import ...). - Architecture en couches (
PYTHONPATH=src lint-imports, contrat[tool.importlinter]) :netcross_gtk4peut dĂ©pendre denetcross_report,netcross_core,pcap_parser;netcross_reportdenetcross_core,pcap_parser;netcross_coredepcap_parserâ jamais l'inverse, etpcap_parserne dĂ©pend d'aucun autre package du projet.
Ces mĂȘmes vĂ©rifications (ruff check, ruff format --check, lint-imports)
ainsi que la suite pytest (voir Tests ci-dessus) tournent
désormais aussi automatiquement dans un pipeline
GitHub Actions sur chaque push et chaque pull
request vers main/dev (badge en tĂȘte de ce document).
netcross/
âââ CLAUDE.md etat courant, prochaine feature, commandes qualite
âââ install.sh installation des dependances systeme
âââ requirements.txt installation alternative via pip (repli sans uv)
âââ requirements-dev.txt dependances de developpement, repli sans uv (pytest, ruff, import-linter, pre-commit)
âââ pyproject.toml dependances (uv) + config ruff (lint/format) + import-linter (couches) + mypy
âââ uv.lock verrou de dependances uv
âââ .pre-commit-config.yaml hooks pre-commit (ruff, ruff-format, import-linter, class-diagram)
âââ .github/workflows/ CI GitHub Actions (lint, format, import-linter, mypy, pytest, deb/rpm, mkdocs, garde)
âââ pytest.ini configuration pytest (pythonpath = src)
âââ docs/ documentation MkDocs
â âââ class-diagram.md diagramme de classes (GENERE depuis src/)
â âââ detectors.md comportement, limites et inventaire des detecteurs (#365, #1020)
â âââ features-backlog.md fonctionnalites, dette, comparaison OmniPeek
â âââ sessions/ historique detaille session par session
âââ scripts/
â âââ generate_class_diagram.py genere docs/class-diagram.md depuis src/
â âââ import_nvd.py import periodique du flux NVD dans la base CVE locale
â âââ build_cve_seed.py regenere la base CVE minimale embarquee (NVD)
âââ tests/ suite de tests automatisĂ©s (pytest)
âââ src/
â âââ cross_capture_analyzer_cli.py CLI principale (argparse)
â âââ cross_capture_batch_cli.py analyse par lots d'un repertoire de captures
â âââ cross_capture_diff_cli.py comparaison de deux rapports JSON
â âââ cross_history_cli.py historique des analyses
â âââ netcross_ai_models_cli.py gestion des modeles IA locaux
â âââ netcross_lua_doc_cli.py documentation de l'API Lua Wireshark
â âââ pcap_parser/ parsing tshark -T ek -> RawPacket/Pkt (DNS, HTTP, TLS, RTP, SIP...)
â âââ netcross_core/ moteur d'analyse (aucune dependance a une UI)
â â âââ security/ detecteurs (beaconing, exfiltration, DGA, fast flux, lateral movement, flow_stats, DNS tunnel, TLS audit, CVE)
â â âââ discovery/ inventaire d'actifs, detection d'OS
â â âââ fingerprint/ base d'empreintes connues (JA4/HASSH)
â â âââ extract/ extraction de fichiers (HTTP, email, SMB, FTP)
â â âââ netflow/ ingestion NetFlow v5 (CLI --netflow, #362)
â â âââ tshark_stats/ adaptateurs de statistiques tshark -z
â â âââ plugins/ detecteurs et sorties tierces (#284)
â â âââ notify/ notifications sortantes (webhook, Slack, courriel)
â â âââ support/ tickets de support anonymises (#269)
â â âââ application/ transactions applicatives HTTP/DNS (requete -> reponse)
â â âââ data/ signatures CVE (JSON), empreintes connues
â â âââ exploit_signatures.py signatures d'exploits (CVE)
â âââ netcross_report/ generation du rapport (PDF, JSON, HTML, SIEM, STIX)
â âââ netcross_ai/ module IA (modeles locaux)
â âââ netcross_api/ API REST (FastAPI)
â âââ netcross_gtk4/ interface graphique GTK4
âââ build-deb/ packaging Debian/Ubuntu (.deb)
âââ build-rpm/ packaging RHEL/Rocky (.rpm)
Le suivi de projet est volontairement scindé en trois niveaux de détail
croissant : CLAUDE.md (à lire à chaque démarrage), docs/features-backlog.md
(fonctionnalitĂ©s, dette, priorisation â importĂ© depuis CLAUDE.md via la
syntaxe @docs/features-backlog.md) et docs/sessions/ (raisonnement et
décisions de conception détaillés session par session, consultés à la
demande plutÎt que reparcourus systématiquement).
netcross_core ne dĂ©pend d'aucune interface : il peut ĂȘtre rĂ©utilisĂ© tel
quel dans un autre projet Python (from netcross_core import parse_capture, correlate, analyse, print_report).
sudo apt-get install debhelper dpkg-dev
./build-deb/build.sh
sudo apt install ./build-deb/dist/netcross_*.debsudo dnf install rpm-build
./build-rpm/build.sh
sudo dnf install ./build-rpm/dist/netcross-*.rpmLes deux scripts assemblent une arborescence de build temporaire Ă partir de
src/, appellent l'outil de packaging natif de la distribution, et déposent
le paquet rĂ©sultant dans dist/ (Ă supprimer manuellement aprĂšs usage â
pas de .gitignore dans ce dépÎt à ce jour).
Testé réellement : le .deb a été construit, installé et exécuté de
bout en bout (CLI, rapport PDF, interface GTK4) sur Ubuntu 24.04. Le .rpm
a Ă©tĂ© construit avec succĂšs via rpmbuild mais n'a pas pu ĂȘtre installĂ©
ni exécuté sur une vraie Rocky Linux (non disponible dans l'environnement
de dĂ©veloppement) â la structure du paquet est correcte et cohĂ©rente avec
le .deb, mais une validation sur un systÚme Rocky 8/9 réel reste à faire
avant un déploiement en production.
-
Détection passive de vulnérabilités (CVE,
--security-report) : les quatre dĂ©tecteurs (banniĂšres de version CVE-1, signatures d'exploits CVE-2, corrĂ©lation des alertes Expert Info CVE-3, corrĂ©lation version â CVE CVE-4) sont consolidĂ©s par--security-report(voir « Options utiles » ci-dessus etdocs/security-report.md). Les banniĂšres de version (CVE-1,netcross_core.application.banners) sont extraites passivement pour HTTP/SSH/DNS/SMB/SMTP/FTP/IMAP/POP3, peuplentPkt.service_bannersĂ l'analyse, sont consolidĂ©es enReport.service_fingerprints, puis corrĂ©lĂ©es aux CVE vianetcross_core.security.findings.apply_security_findings(). Le fingerprinting TLS (versions via Server Hello/certificats) n'est en revanche pas encore couvert par ce module. Limites assumĂ©es : la corrĂ©lation exige le nom et la version exacts d'un produit prĂ©sent dans la base locale (scripts/import_nvd.py) â une banniĂšre masquĂ©e ou falsifiĂ©e (ServerTokens Prod) n'est pas dĂ©tectĂ©e, et l'absence de service dĂ©tectĂ© n'est pas une information ; les signatures d'exploits ne voient ni un flux chiffrĂ© (TLS sans clĂ©s) ni une charge rĂ©partie sur plusieurs segments TCP (pas de rĂ©assemblage) ; une signature est une tentative observĂ©e, jamais une compromission confirmĂ©e ; rendu texte uniquement (pas de section dans--pdf-report/--json-report, pas d'Ă©quivalent dans l'interface graphique). -
Captures segmentées (
NOM=chemin1,chemin2,...) : les segments sont lus dans l'ordre oĂč ils sont listĂ©s et simplement concatĂ©nĂ©s, sans tri par timestamp â les lister dans l'ordre chronologique (ordre naturel d'une rotationtcpdump/tshark). Les quelques analyses sensibles Ă l'ordre au sein d'un mĂȘme point (instabilitĂ© STP, timeout d'inactivitĂ©) trient dĂ©jĂ explicitement en interne, donc un mauvais ordre n'affecte que la lisibilitĂ© des messages[LABEL] N paquets... chargĂ©s depuisen console, pas la justesse de ces deux dĂ©tecteurs prĂ©cis. -
DĂ©tection de pertes sur un segment de branchement : dĂ©sactivĂ©e volontairement (un flux absent sur une branche peut avoir lĂ©gitimement pris l'autre branche â impossible Ă distinguer d'une vraie perte sans information supplĂ©mentaire, donc l'outil ne se prononce pas plutĂŽt que de se tromper).
-
Graphiques temporels top-N (protocole/port/IP/DSCP) : un seul point de capture tracé par graphique (le premier de
--order/--capture), pas de vue combinĂ©e multi-points â un mĂȘme paquet physique pouvant ĂȘtre vu Ă plusieurs points, les additionner gonflerait artificiellement le volume affichĂ©. Les catĂ©goriesportetipsont ventilĂ©es par destination uniquement (pas source+destination), pour que la somme des catĂ©gories d'un point Ă©gale exactement son dĂ©bit total : cĂŽtĂ© retour serveurâclient, le port de destination observĂ© est un port Ă©phĂ©mĂšre qui se disperse dans la longue traĂźne plutĂŽt que de faire ressortir un service â comportement recherchĂ©, pas une approximation Ă corriger. Non disponible surcross_capture_diff_cli.py(pas de direction de conception Ă©vidente pour une comparaison avant/aprĂšs sur ce type de graphique) ni rĂ©glable depuis la GUI (nombre de catĂ©gories toujours Ă la valeur par dĂ©faut, 5, quand le PDF est gĂ©nĂ©rĂ© depuis l'interface). -
Gestion mĂ©moire des grosses captures : le pipeline tient entiĂšrement en RAM (pas de streaming multi-passes â la corrĂ©lation multi-points a besoin d'une vue d'ensemble). La campagne de mesure complĂšte (2 Ă 10 points, 10⎠à 10â¶ paquets par point, parallĂ©lisme 1 Ă 8, dĂ©bits et pics RSS) est documentĂ©e dans docs/performance.md : en synthĂšse, environ 2,4 Ă 3,1 Kio de RAM par paquet pour le pipeline complet (
tsharkinclus â le seul pipeline Python descend Ă ~636 o/paquet, voirdocs/sessions/session-19.md), soit ~5 Go pour 2 points Ă 10â¶ paquets. Une capture de plusieurs millions de paquets par point se compte donc encore en Go, pas en dizaines de Mo â dimensionner la machine d'analyse en consĂ©quence sur de trĂšs gros volumes. -
Fragmentation IPv6 : dĂ©tectĂ©e via l'en-tĂȘte d'extension Fragment (
ipv6.fragment, RFC 8200), cĂąblĂ©e dans le mĂȘme compteur gĂ©nĂ©rique que la fragmentation IPv4 (--capture/--parallel, comptage par point, aucun flag dĂ©diĂ©). Limite protocolaire assumĂ©e, diffĂ©rente d'IPv4: l'identifiant de datagramme (ipv6.fragment.id) n'existe QUE sur un datagramme dĂ©jĂ fragmentĂ© â un datagramme IPv6 jamais fragmentĂ© n'a simplement aucun identifiant Ă exposer, contrairement Ă IPv4 oĂčip.idest un champ ordinaire toujours prĂ©sent. ConsĂ©quence : la dĂ©tection d'une nouvelle fragmentation apparaissant entre deux points de capture (« non fragmentĂ© en amont, fragmentĂ© en aval », typiquement un tunnel qui rĂ©duit le MTU disponible) ne fonctionne que pour IPv4 ; cĂŽtĂ© IPv6, seule une fragmentation dĂ©jĂ prĂ©sente aux deux points (et partageant le mĂȘme identifiant 32 bits) est suivie â cohĂ©rent avec le fait que seule la source fragmente en IPv6, jamais un routeur intermĂ©diaire en cours de route. -
Décodage ICMPv6 (Session 22) : type/code décodés pour tout message (
icmpv6.type/icmpv6.code), identifiant/sĂ©quence pour Echo Request/Reply uniquement (absents des autres types, commeicmp.ident/icmp.seqcĂŽtĂ© ICMPv4). La valeur de MTU annoncĂ©e par un message Packet Too Big (icmpv6.mtu) n'est pour l'instant pas conservĂ©e â seul son occurrence (type 2) est comptĂ©e, au mĂȘme niveau de dĂ©tail que ICMP Fragmentation Needed cĂŽtĂ© IPv4. -
DĂ©tection de noir PMTUD : le rapprochement avec le signal ICMP(v6) correspondant (Fragmentation Needed cĂŽtĂ© IPv4, Packet Too Big cĂŽtĂ© IPv6, RFC 4443 §3.2) se fait sur l'ensemble de la capture au point amont, pas sur une fenĂȘtre temporelle prĂ©cise autour du segment concernĂ© (nĂ©cessiterait de dĂ©coder le paquet IP embarquĂ© dans la charge utile ICMP(v6) pour un appariement par flux exact) ; couvre IPv4 et IPv6 depuis la Session 22 (IPv4 exige un bit
DFactif sur toutes les tentatives observĂ©es â un segment sansDFn'autorise pas la fragmentation en route Ă ĂȘtre mise en cause ; IPv6 n'a pas de bit Ă©quivalent, la sĂ©mantique « ne pas fragmenter » y Ă©tant implicite pour tout paquet, voir la fragmentation IPv6 ci-dessus) ; seuil de taille de segment (512 octets) fixe, non configurable pour l'instant. -
DĂ©tection de coupure NAT/pare-feu silencieuse (Session 23) : scope volontairement limitĂ© Ă TCP (la notion de session avec Ă©tablissement/ silence/reprise n'a de sens direct que pour un protocole avec Ă©tat) ; seuil de silence fixe (60s), non configurable pour l'instant â choisi pour ĂȘtre largement au-dessus d'un keepalive TCP applicatif classique sans se caler sur le timeout exact d'un Ă©quipement prĂ©cis (non documentĂ© par les fabricants, impossible Ă dĂ©duire d'une seule capture). N'effectue pas de vĂ©rification explicite de l'absence de FIN/RST juste avant le silence : une connexion proprement close puis suivie bien plus tard d'un paquet rĂ©siduel partageant le mĂȘme 5-tuple (rĂ©utilisation rapide du mĂȘme port Ă©phĂ©mĂšre, rare) pourrait en thĂ©orie ĂȘtre confondue avec une coupure silencieuse.
-
DĂ©tection de conflit d'adresse IP (ARP) (Session 24) : aucune fenĂȘtre temporelle â deux MAC revendiquant la mĂȘme IP Ă n'importe quel moment de la capture (mĂȘme trĂšs espacĂ©es) sont considĂ©rĂ©es en conflit, sans distinction avec un remplacement matĂ©riel lĂ©gitime au cours d'une capture trĂšs longue. Ne distingue pas un vrai conflit persistant d'un basculement lĂ©gitime d'IP flottante (VRRP/keepalived, HA de pare-feu) : les deux se traduisent de la mĂȘme façon cĂŽtĂ© ARP (nouvelle MAC qui revendique une IP dĂ©jĂ vue avec une autre) ; distinguer les deux demanderait de connaĂźtre la configuration rĂ©seau (IP virtuelles dĂ©clarĂ©es), hors de portĂ©e d'une simple lecture de capture.
-
DĂ©tection d'instabilitĂ© STP (Session 25) : le "flapping de port" au sens strict (un port de commutateur qui bascule haut/bas de façon rĂ©pĂ©tĂ©e) n'est pas directement observable depuis une capture rĂ©seau â cette information vit dans la table d'Ă©tat interne du commutateur (SNMP/syslog), pas sur le fil. Le dĂ©tecteur observe la consĂ©quence visible sur le fil (tempĂȘte de changements de topologie, réélections de racine) plutĂŽt que la cause exacte (quel port, sur quel commutateur) â limite architecturale, pas un oubli. Ne distingue pas non plus une tempĂȘte causĂ©e par une vraie boucle physique d'une tempĂȘte causĂ©e par une autre instabilitĂ© de lien (auto-nĂ©gociation, cĂąble dĂ©fectueux, alimentation PoE instable) : le signal remonte "le rĂ©seau est instable", pas sa cause racine exacte.
-
Diagnostics de certificat TLS (Session 26) : n'extrait ni Subject ni Issuer (Distinguished Name complet) â tshark les aplatit en
-T ekdans des tableaux positionnels partagĂ©s entre toutes les RDN de tous les certificats de la chaĂźne, sans moyen fiable de dĂ©terminer par position laquelle correspond Ă quel attribut ; reconstruire cette information demanderait-T json/-T pdmlplutĂŽt que le flux EK aplati utilisĂ© partout ailleurs dans ce pipeline. Seul le certificat feuille (le premier de la chaĂźne, garanti par RFC 5246 §7.4.2) est analysĂ© â pas les certificats intermĂ©diaires/racine. Aucune vĂ©rification de la chaĂźne de confiance PKI (autoritĂ©, rĂ©vocation) : hors de portĂ©e d'une capture passive, qui n'a pas accĂšs au magasin de confiance du client. Invisible en TLS 1.3 sansSSLKEYLOGFILE: le message Certificate y est chiffrĂ© par construction (RFC 8446) â limite protocolaire, pas contournable par ce projet. -
Anonymisation (
--redact, Session 28, Ă©tendue par #1153) : les adresses IP (RFC 5737/3849) et MAC (OUI localement administrĂ©), et par dĂ©faut les noms (dns.qry.name, la cible HTTP, le SAN, le sujet et l'Ă©metteur des certificats TLS,Call-ID,User-AgentetServerSIP). Les autres champs texte (corps HTTP, en-tĂȘtes non listĂ©s, SNI lu par--tls) ne sont pas couverts ; avec--redact-scope adresses, les noms restent identifiants. Depuis l'issue #1155,--redactest combinable avec--tls/--quic/--client-group: Ă©vĂšnements et adresses passent par la mĂȘme table de pseudonymes (les combinaisons restent refusĂ©es pour--tls-keyloget le rapport de sĂ©curitĂ©). Depuis #1157/#1159, le rapport ouvre par un encart « Anonymisation â pĂ©rimĂštre appliquĂ© » (portĂ©e, compteurs, pcapng, table) et--redact-pcapproduit une capture pcapng anonymisĂ©e partageable â charges utiles zĂ©roĂ©es par dĂ©faut : les contenus applicatifs n'y passent pas, seuls protocoles, ports, longueurs et horodatages sont conservĂ©s. CĂąblĂ© sur l'interface graphique GTK4 depuis une passe ultĂ©rieure (case dĂ©diĂ©e, mĂȘme garde-fou mutuellement exclusif avec TLS/QUIC) â voir "Interface graphique" ci-dessus (la GUI reste toutefois non couverte par les tests automatisĂ©s, voir "Tests" ci-dessous). -
Historique inter-runs (
--history-db, Session 29) : ne conserve qu'un rĂ©sumĂ© par run (score de santĂ©, nombre de constats par sĂ©vĂ©ritĂ©, points, Ă©tiquette) â pas le dĂ©tail des constats eux-mĂȘmes, toujours disponible via--json-report/--pdf-report/--detail-csv.--history-shown'affiche l'historique qu'aprĂšs un run normal, jamais Ă sa place â pour une interrogation seule sans relancer d'analyse, voirnetcross-historyci-dessous (Session 30).record_diff_runn'intĂšgre pas les diagnostics TLS/QUIC au score (mĂȘme limite assumĂ©e que--json-report/--pdf-reporten mode comparaison, voir plus haut). Non cĂąblĂ© sur l'interface graphique GTK4 (aucun Ă©quivalent de--history-db/--history-showdansnetcross_gtk4.app). -
netcross-history/cross_history_cli.py(Session 30) : pas de sortie--json/structurĂ©e, uniquement le rendu texte console â le besoin n'a pas Ă©tĂ© exprimĂ© dans la piste d'origine,--json-reportsur les deux autres CLI couvre dĂ©jĂ le besoin de sortie structurĂ©e pour un run donnĂ©. Wrapper packagĂ© et paquet.debrĂ©ellement construit et vĂ©rifiĂ© cette session ; le.specRPM correspondant a Ă©tĂ© mis Ă jour par symĂ©trie mais n'a pas pu ĂȘtre rejouĂ© :rpmbuildest absent de l'environnement de dĂ©veloppement utilisĂ© pour cette session (voir aussi la note sur le.rpmen gĂ©nĂ©ral, ci-dessus/ci-dessous selon la section). -
Classification des retransmissions TCP : calculĂ©e par tshark indĂ©pendamment pour chaque fichier de capture (un point = un fichier = un processus tshark, sans vue d'ensemble multi-points). La condition "retransmission rapide" de tshark exige notamment d'avoir vu le dernier ACK il y a moins de 20 ms â un point de capture Ă©loignĂ© de l'Ă©metteur (RTT important jusqu'Ă ce point) peut donc classer diffĂ©remment une mĂȘme retransmission rĂ©elle sur le fil qu'un point plus proche de l'Ă©metteur. Comportement de tshark lui-mĂȘme, pas une approximation ajoutĂ©e par cet outil.
-
CAPWAP (WiFi Aruba/Cisco) : decodage delegue au dissecteur CAPWAP natif de tshark (RFC 5415), pas encore verifie contre une vraie capture Aruba/Cisco reelle en conditions terrain. Chiffrement DTLS du canal data : non dechiffrable (comportement attendu, signale explicitement dans le rapport comme
CAPWAP(chiffre DTLS)plutot que de planter). -
DNS : corrélation par identifiant de transaction (
dns.id, 16 bits) â sur une capture trĂšs longue et trĂšs chargĂ©e en requĂȘtes concurrentes vers le mĂȘme rĂ©solveur, une rĂ©utilisation d'id avant qu'une transaction prĂ©cĂ©dente ne soit terminĂ©e n'est pas gĂ©rĂ©e spĂ©cifiquement (les deux seraient alors vues comme une seule, Ă tort ; mĂȘme limite de principe quedhcp.xid, sur 32 bits et donc bien moins probable en pratique). Une rĂ©ponse NXDOMAIN est signalĂ©e pour information mais n'est pas en elle-mĂȘme une anomalie rĂ©seau. -
HTTP : HTTP/1.x uniquement (TCP) â HTTP/2 (dissecteur tshark distinct) et HTTP/3 (QUIC, voir ci-dessous â SNI uniquement, pas de code de statut) ne sont pas couverts par cette section. Faute d'identifiant de transaction applicatif comparable Ă
dns.id, une requĂȘte est suivie par connexion TCP + URI ; si la mĂȘme URI est rejouĂ©e plusieurs fois sur la mĂȘme connexion (ex : polling d'un endpoint de santĂ©) et qu'une occurrence prĂ©cise est perdue entiĂšrement sur un segment, un dĂ©calage entre occurrences restantes est possible (non gĂ©rĂ© spĂ©cifiquement â cas diffĂ©rent de deux requĂȘtes successives sur des URI diffĂ©rentes, qui reste correctement distinguĂ©). Une rĂ©ponse 4xx est signalĂ©e pour information mais n'est pas en elle-mĂȘme une anomalie rĂ©seau. -
QUIC/HTTP3 : les versions 1 (RFC 9001) et 2 (RFC 9369, version
0x6b3343cf) sont gĂ©rĂ©es ; la dĂ©rivation de clĂ©s a Ă©tĂ© validĂ©e octet pour octet contre les vecteurs de test officiels de la RFC 9001 Annexe A.2 et de la RFC 9369 Annexe A (paquet Client Initial v2 complet dĂ©chiffrĂ©, SNI compris). Les constats signalent les Initial v2 par point ; les brouillons et versions privĂ©es restent ignorĂ©s. Seul le paquet Initial (ClientHello, SNI) est accessible â les Ă©changes 0-RTT/1-RTT sont chiffrĂ©s avec des clĂ©s de session qui ne sont pas publiques, donc structurellement indĂ©chiffrables sans capture des clĂ©s cĂŽtĂ© client (keylog). -
TLS/QUIC sur
cross_capture_diff_cli.py:--tls/--quicexĂ©cutent le diagnostic sĂ©parĂ©ment sur le baseline et sur le run courant plutĂŽt que de produire une vraie comparaison chiffrĂ©e â ces deux modules ne connaissent qu'un Ă©tat Ă un instant donnĂ© (voir limites ci-dessus), pas de notion d'"avant/aprĂšs" comme pour le reste du diff. Les deux sections sont affichĂ©es cĂŽte Ă cĂŽte (console et PDF) pour comparaison visuelle. -
TLS : parseur maison (structures TLS lues Ă la main depuis la charge utile TCP fournie par tshark, pas de bibliothĂšque TLS tierce), limitĂ© Ă l'Ă©tat du handshake par segment (ClientHello/ServerHello/Alert) â pas de rĂ©assemblage TCP inter-segments, pas de TLS en tunnel, pas de chaĂźne de certificats.
-
Analyse RF WiFi (retries, RSSI, roaming 802.11, #1006). Une capture en mode moniteur avec radiotap (linktype 127) est acceptée comme point, et chaque trame porte RSSI, MCS, débit, retry et canal (
Pkt.radio, issue #1142) ; une capture 802.11 sans radiotap (linktype 105) est lue avec un avertissement explicite (retry seul). Les paquets IP sont dĂ©capsulĂ©s de l'air ; sur un rĂ©seau WPA/WPA2-PSK,--wifi-keys FICHIER(ouNETCROSS_WIFI_KEYS) les dĂ©chiffre si le 4-way handshake est capturĂ©, sinon mĂ©triques radio seules avec un avertissement (issue #1143, docs/dechiffrement-wifi.md). Les copies retry sont fusionnĂ©es avant l'appariement air â filaire (#1145). Le rapport (texte, PDF, JSONwifi_clients) donne par station : RSSI mĂ©dian, MCS et dĂ©bit PHY, taux de retransmission radio, itinĂ©rance et temps d'antenne approximatif. Il Ă©met aussi les constats « perte dans l'air », « perte aprĂšs le point d'accĂšs », « dĂ©bit PHY bas » et « itinĂ©rance pendant le flux » (#1146). Limites :- un canal par interface de capture ;
- 802.11ax MU partiel (MCS du premier utilisateur seul) ;
- pas de déchiffrement WPA3-SAE ni 802.1X/EAP ;
- perte « indéterminée » quand la sonde n'a pas vu la trame montante d'origine ;
- temps d'antenne approché.
Détail dans docs/detectors.md.
-
Protocoles propriétaires non standard (ex : signalisation Alcatel NOE historique, non-SIP) : non couverts, faute de spécification publique fiable.
-
Parallélisation (
--parallel) : mesurĂ© empiriquement en Session 31 sur un environnement Ă un seul cĆur CPU (os.cpu_count()==1) â aucun gain, lĂ©ger surcoĂ»t mesurable (+4% avec le nombre de workers par dĂ©faut, jusqu'Ă +10% en sur-souscription explicite) par rapport au mode sĂ©quentiel, contrairement Ă ce qu'affirmait une version antĂ©rieure de cette note ("rĂ©sultats identiques"). Les deux CLI affichent dĂ©sormais un avertissement explicite quand--paralleltourne avec un seul worker effectif ou en sur-souscription (--parallel-workersau-delĂ du nombre de cĆurs dĂ©tectĂ©s). Le mĂ©canisme (un processustsharkindĂ©pendant par fichier) reste architecturalement sain et devrait apporter un gain rĂ©el sur une machine multi-cĆurs, mais cette hypothĂšse n'a toujours pas pu ĂȘtre mesurĂ©e en dĂ©veloppement, faute d'un tel hĂŽte disponible â Ă vĂ©rifier sur votre matĂ©riel. -
Package RPM : voir ci-dessus, construit mais pas installé sur une vraie Rocky Linux.
-
Tests automatisés : couvrent
netcross_core,pcap_parseretnetcross_report/synthesis.py/triage.py(voir section Tests ci-dessus), mais pascharts.py/pdf.py(rendu matplotlib/reportlab), ni la GUI GTK4 ; la suitepytestelle-mĂȘme reste construite sur des objetsPkt/RawPacketsynthĂ©tiques (pas de dĂ©pendance ajoutĂ©e sur untsharkrĂ©el, dont la disponibilitĂ© n'est pas garantie d'un environnement de dĂ©veloppement Ă l'autre pour ce projet). Un vraitshark(4.2.2) a exceptionnellement Ă©tĂ© disponible le temps d'une session (voirdocs/sessions/session-09.md) et a permis une validation ponctuelle hors suitepytest: dĂ©codage EK rĂ©el de paquets DF/MF via des pcaps synthĂ©tiques (scapy), invocation rĂ©elle du sous-processustsharkviaparse_capture(), gĂ©nĂ©ration rĂ©elle de PDF relue avecpypdf, et rejeu des deux CLIs de bout en bout â sans garantie que ce soit Ă nouveau le cas la prochaine fois. -
Les verdicts de saturation/policing/bufferbloat/injection RST sont des indices heuristiques basĂ©s sur des corrĂ©lations statistiques, pas des certitudes absolues â Ă confirmer avec les journaux des Ă©quipements suspectĂ©s.
Le projet utilise les issues GitHub pour suivre les travaux restants (33 issues ouvertes) et l'historique des sessions (69 issues fermées).
Le tableau de bord dĂ©taillĂ© se trouve dans ISSUES.md â prioritĂ©s, difficultĂ©s, dĂ©pendances et correspondance sessions â issues.
| Label | Signification |
|---|---|
P0-fondations |
PrioritĂ© 0 â fondations du moteur d'expertise |
P1-différenciation |
PrioritĂ© 1 â diffĂ©renciation Netcross |
P2-exploitation |
PrioritĂ© 2 â exploitation et interface |
P3-applicatif |
PrioritĂ© 3 â expertise applicative |
P4-admin |
PrioritĂ© 4 â validation et administratif |
diff-1-faible Ă diff-5-expert |
Niveau de difficulté (1 à 5) |
rule-engine |
Moteur d'exécution de rÚgles |
architecture |
Décision ou chantier d'architecture |
dette |
Dette technique |
session-archive |
Issue documentant une session historique (fermée) |
Chaque job est développé sur une branche job<N> et livré via une pull request
vers la branche dev. La branche main reste stable.
GPL-3.0-or-later â voir LICENSE (texte officiel de la GNU General Public License, version 3 ou ultĂ©rieure).
Historique de licence : le projet Ă©tait prĂ©cĂ©demment distribuĂ© sous licence MIT â « Copyright (c) 2026 Mathilde Deuscher » â ; les versions publiĂ©es avant ce changement de licence restent couvertes par cette licence MIT.
Dépendances (licences vérifiées dans les métadonnées des versions
distribuées) : cryptography 50.0.1 (Apache-2.0 OR BSD-3-Clause),
loguru (MIT), reportlab (BSD-3-Clause), matplotlib (licence Matplotlib,
compatible BSD), networkx (BSD-3-Clause) â toutes compatibles avec la
GPL-3.0-or-later ; scikit-learn (BSD-3-Clause) et fastapi (MIT) sont
optionnelles et compatibles également. tshark (projet Wireshark,
GPL-2.0-or-later) est appelé comme programme externe, sans liaison de
code.