Skip to content
Mathilde-TeamPublic

About

No description, website, or topics provided.

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

1,483 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Netcross

CI

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.


Sommaire


Ce que fait l'outil

À 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 DF actif 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.


Solutions de capture prises en charge

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.

1. Port miroir / SPAN (switch)

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.

2. TAP réseau (matériel passif)

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.

3. Capture directe sur l'hĂŽte (client ou serveur)

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.

4. Capture distante via SSH

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

5. Environnements virtualisés (hyperviseur)

  • 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'interface tap correspondant Ă  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.

6. Miroir de trafic dans le cloud

  • 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.

7. CĂŽtĂ© contrĂŽleur WiFi (Aruba, Cisco) — trafic client via CAPWAP

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.

Bonnes pratiques communes à toutes ces méthodes

  • 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 / dumpcap sans 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).

Installation

Rapide (Debian/Ubuntu/Rocky/RHEL)

git clone <url-du-depot> netcross
cd netcross
./install.sh              # CLI + interface graphique GTK4
./install.sh --cli-only   # CLI et rapport PDF seulement, sans GTK4

Paquet systĂšme (.deb / .rpm)

Voir 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.

Manuelle (pip)

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)

Utilisation

CLI

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 (rotation tcpdump -C/tshark -b) comme un seul point continu, sans fusion prĂ©alable (mergecap ou autre) — Ă  lister dans l'ordre chronologique. Fonctionne aussi avec --parallel (un processus tshark par segment). MĂȘme syntaxe sur --baseline/--current du 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.pcapng devient alors un point distinct nommĂ© NOM:INTERFACE (option if_name du fichier, sinon ifN, ou sS-ifN s'il y a plusieurs sections). Un fichier Ă  une seule capture est lu tel quel. mergecap sans -I none fusionne 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'option if_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 de analyse(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-workers au-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-n regle 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-report et 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 (--quic nĂ©cessite cryptography ; pipeline de dĂ©codage indĂ©pendant de celui utilisĂ© pour le reste de l'analyse mais passant lui aussi par tshark, voir netcross_core/tls_diagnostics.py et quic_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-db dĂ©signe la base SQLite produite par scripts/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 capacites CAP_NET_RAW/CAP_NET_ADMIN sur dumpcap).
  • --replay INTERFACE : rejoue le fichier passĂ© Ă  --capture (un seul, exactement) sur INTERFACE via tcpreplay (paquet systĂšme distinct de tshark, Ă  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 sur INTERFACE. 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-speed rĂš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, ou topspeed pour rejouer aussi vite que l'interface/le noyau le permettent sans respecter les timestamps d'origine). --replay-loop N rejoue le fichier N fois (dĂ©faut 1). Incompatible avec --live/--merge/--split et 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-window secondes (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 : statistiques tshark -z de 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Ă© error et un message sur stderr, sans faire perdre les autres. RefusĂ© en --live seul.
  • --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 (voir docs/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/--quic sont 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 --triage ci-dessus) porte une clĂ© evidence (liste de {"point": ..., "text": ...}) — absente sinon, comme sample_size. Sur la catĂ©gorie PMTUD uniquement (pilote, voir "preuves" ci-dessous), chaque ligne de preuve porte aussi une clĂ© frame_number quand 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, voir docs/features-backlog.md section 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, avec cause/impact probables quand le moteur de corrĂ©lation causale reconnaĂźt un motif de symptĂŽmes co-occurrents sur un mĂȘme segment, null sinon), diagnoses (regroupement des expert_events par segment), compliance (statut CONFORME/ VIOLATION/INDETERMINE contre 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 dans expert_events ci-dessus (source vaut "tshark" ici contre "netcross" pour expert_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/Comment traduits vers anomalie/a_surveiller/info), avec repli sur une table interne pour les flags dĂ©jĂ  connus de ce projet sinon ; chaque ligne de evidence inclut le message natif tshark quand il est disponible, en plus des adresses et du libellĂ©. Chaque entrĂ©e wireshark_expert_events porte 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") et protocol ("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 de netcross_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/conversations ci-dessus) et packet_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 Ă  evidence ci-dessus, plafonnĂ©e Ă  5 exemples, packet_evidence n'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...) — null pour tout autre flag EK (y compris les flags de suivi de connexion TCP comme tcp.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 toujours null/[] sur expert_events/diagnoses (source "netcross") : un Finding Netcross 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 — voir netcross_core.expert_model.ExpertEvent.
  • --expert-section : affiche en console les objets enrichis dĂ©crits ci-dessus (expert_events avec cause/impact probables, diagnoses par 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 (voir netcross_report.session_objects). Les blocs flows/conversations et 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-report reç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, puis DEVIATION) y remontent en premier, comme dans le triage « par oĂč commencer ». Toujours indĂ©pendamment des options, --pdf-report reç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-report un 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|tout restreint la portĂ©e (issue #1153, voir netcross_core/redact.py). Combinable avec --tls/--quic/--client-group depuis 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-payload pour les conserver, horodatages conservĂ©s ou dĂ©calĂ©s uniformĂ©ment via --redact-pcap-decalage, issue #1157). --redact-map chemin.csv conserve la correspondance adresse rĂ©elle ↔ pseudonyme dans un fichier local, Ă  ne jamais transmettre avec le rapport ; il porte aussi la table des noms (types nom et domaine : host-N.domain-M.example.invalid, mĂȘme suffixe pour un mĂȘme domaine parent, module commun netcross_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 format SSLKEYLOGFILE (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 --redact tant 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 Ă©tiquette distingue 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-label si elle est fournie. --history-label/ --history-show nĂ©cessitent --history-db.

Comparer des clients entre eux (« ce poste fonctionne, pas l'autre »)

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.csv

Regroupe 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.

Comparer deux captures (avant/aprĂšs)

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.pdf

RĂ©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 sur cross_capture_analyzer_cli.py ci-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Ă©. --quic nĂ©cessite cryptography. 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 --triage ci-dessus) porte lui aussi une clĂ© evidence, toujours issue du rapport courant (jamais du baseline) — absente sinon, comme sample_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-duration fixe une durĂ©e max optionnelle (sinon Ctrl+C). Mutuellement exclusif avec --parallel/--tls/--quic (mĂȘmes limitations assumĂ©es que --live sur cross_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 sur cross_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/--quic depuis l'issue #1155 (mĂȘme table de pseudonymes ; pas de --client-group sur ce CLI).
  • --tls-keylog [NOM=]FICHIER : mĂȘme option que sur cross_capture_analyzer_cli.py, appliquĂ©e aux captures --baseline et --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 sur cross_capture_analyzer_cli.py (voir ci-dessus) — un mĂȘme fichier .db peut mĂ©langer des runs d'analyse et de comparaison (--history-show les affiche ensemble, plus rĂ©cent d'abord).

Consulter l'historique sans relancer d'analyse

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-label ci-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.

Documentation de l'API Lua Wireshark hors ligne

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 : 0 rĂ©sultat affichĂ©, 1 aucun rĂ©sultat, classe inconnue ou JSON introuvable, 2 erreur 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.db depuis data/lua_api.json (dĂ©pĂŽt) ou /usr/share/netcross/data/lua_api.json (paquet), puis reconstruite automatiquement quand ce JSON change. --source ou NETCROSS_LUA_API_JSON dĂ©signent un autre JSON, --db une 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.db

Interface graphique

cd src && python3 -m netcross_gtk4.app
# ou, si installe via .deb/.rpm :
netcross-gui

Trois 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).


Tests

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
#   pytest

Couverture 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.


Qualité de code

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 dans pyproject.toml) : line-length = 120, cible py39, imports absolus uniquement (from .module import ... est banni — prĂ©fĂ©rer from netcross_core.module import ...).
  • Architecture en couches (PYTHONPATH=src lint-imports, contrat [tool.importlinter]) : netcross_gtk4 peut dĂ©pendre de netcross_report, netcross_core, pcap_parser ; netcross_report de netcross_core, pcap_parser ; netcross_core de pcap_parser — jamais l'inverse, et pcap_parser ne 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).


Architecture du dépÎt

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).


Construire les paquets .deb / .rpm

Debian / Ubuntu

sudo apt-get install debhelper dpkg-dev
./build-deb/build.sh
sudo apt install ./build-deb/dist/netcross_*.deb

Rocky / RHEL 8 et 9

sudo dnf install rpm-build
./build-rpm/build.sh
sudo dnf install ./build-rpm/dist/netcross-*.rpm

Les 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.


Limites connues

  • 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 et docs/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, peuplent Pkt.service_banners Ă  l'analyse, sont consolidĂ©es en Report.service_fingerprints, puis corrĂ©lĂ©es aux CVE via netcross_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 rotation tcpdump/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 depuis en 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Ă©gories port et ip sont 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 sur cross_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 (tshark inclus — le seul pipeline Python descend Ă  ~636 o/paquet, voir docs/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.id est 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, comme icmp.ident/icmp.seq cĂŽ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 DF actif sur toutes les tentatives observĂ©es — un segment sans DF n'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 ek dans 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 pdml plutĂŽ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 sans SSLKEYLOGFILE : 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-Agent et Server SIP). 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, --redact est 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-keylog et 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-pcap produit 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-show n'affiche l'historique qu'aprĂšs un run normal, jamais Ă  sa place — pour une interrogation seule sans relancer d'analyse, voir netcross-history ci-dessous (Session 30). record_diff_run n'intĂšgre pas les diagnostics TLS/QUIC au score (mĂȘme limite assumĂ©e que --json-report/--pdf-report en mode comparaison, voir plus haut). Non cĂąblĂ© sur l'interface graphique GTK4 (aucun Ă©quivalent de --history-db/--history-show dans netcross_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-report sur les deux autres CLI couvre dĂ©jĂ  le besoin de sortie structurĂ©e pour un run donnĂ©. Wrapper packagĂ© et paquet .deb rĂ©ellement construit et vĂ©rifiĂ© cette session ; le .spec RPM correspondant a Ă©tĂ© mis Ă  jour par symĂ©trie mais n'a pas pu ĂȘtre rejouĂ© : rpmbuild est absent de l'environnement de dĂ©veloppement utilisĂ© pour cette session (voir aussi la note sur le .rpm en 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 que dhcp.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/--quic exĂ©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 (ou NETCROSS_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, JSON wifi_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 --parallel tourne avec un seul worker effectif ou en sur-souscription (--parallel-workers au-delĂ  du nombre de cƓurs dĂ©tectĂ©s). Le mĂ©canisme (un processus tshark indĂ©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_parser et netcross_report/synthesis.py/triage.py (voir section Tests ci-dessus), mais pas charts.py/pdf.py (rendu matplotlib/reportlab), ni la GUI GTK4 ; la suite pytest elle-mĂȘme reste construite sur des objets Pkt/RawPacket synthĂ©tiques (pas de dĂ©pendance ajoutĂ©e sur un tshark rĂ©el, dont la disponibilitĂ© n'est pas garantie d'un environnement de dĂ©veloppement Ă  l'autre pour ce projet). Un vrai tshark (4.2.2) a exceptionnellement Ă©tĂ© disponible le temps d'une session (voir docs/sessions/session-09.md) et a permis une validation ponctuelle hors suite pytest : dĂ©codage EK rĂ©el de paquets DF/MF via des pcaps synthĂ©tiques (scapy), invocation rĂ©elle du sous-processus tshark via parse_capture(), gĂ©nĂ©ration rĂ©elle de PDF relue avec pypdf, 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.


Suivi des issues

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.

Labels

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)

Workflow de développement

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.


Licence

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.

About

No description, website, or topics provided.

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages