Skip to content

Real-time network monitor + outbound firewall — see & block every connection. Privacy-first, local-first, Rust fleet agent, SIEM exports, 8 languages. / Moniteur réseau temps réel + pare-feu sortant, agent de flotte Rust, exports SIEM. 100 % local.

38.3 KB
Raw Blame
"""
EN: Alert explainability — deterministic, rule-based explanations for every
    alert type the detector can emit. This is deliberately NOT a language
    model: each template is hand-written, bilingual, and bounded — the
    honest version of "explain this alert" that works offline, costs zero
    resources, and can never hallucinate. A local SLM stays on the research
    roadmap; this is what ships today.

    Served by GET /security/explain?type=<ALERT_TYPE> — the frontend uses
    it for the "Why am I seeing this?" affordance on alert cards.

FR: Explicabilité des alertes — explications déterministes par règles pour
    chaque type d'alerte du détecteur. Ce n'est volontairement PAS un modèle
    de langage : chaque gabarit est écrit à la main, bilingue et borné — la
    version honnête de « explique cette alerte » qui marche hors-ligne, ne
    coûte rien et ne peut pas halluciner. Un SLM local reste à la roadmap ;
    voici ce qui est livré aujourd'hui.
"""

from __future__ import annotations


def _e(title_en, title_fr, what_en, what_fr, why_en, why_fr,
       actions_en, actions_fr) -> dict:
    """EN: One explanation record — bilingual fields, parallel action lists.
    FR: Une explication — champs bilingues, listes d'actions parallèles."""
    return {
        "title_en": title_en, "title_fr": title_fr,
        "what_en": what_en, "what_fr": what_fr,
        "why_en": why_en, "why_fr": why_fr,
        "actions_en": actions_en, "actions_fr": actions_fr,
    }


EXPLANATIONS: dict[str, dict] = {

"NEW_HOST": _e(
    "First contact with a remote host",
    "Premier contact avec un hôte distant",
    "Snitch saw traffic to an IP it had never observed since the session started.",
    "Snitch a vu du trafic vers une IP jamais observée depuis le début de la session.",
    "Mostly informational — every new server you legitimately visit triggers it. "
    "It becomes meaningful when paired with other alerts or an unexpected process.",
    "Surtout informatif — tout nouveau serveur légitime la déclenche. Elle prend "
    "du sens combinée à d'autres alertes ou à un processus inattendu.",
    ["Check which process opened the connection",
     "Look at the geolocation and resolved domain",
     "If unexpected, check its reputation (Threat intel)"],
    ["Identifier le processus à l'origine de la connexion",
     "Regarder la géolocalisation et le domaine résolu",
     "Si inattendu, vérifier sa réputation (threat intel)"]),

"NEW_LAN_DEVICE": _e(
    "New device joined the LAN",
    "Nouvel appareil sur le LAN",
    "A MAC/IP pair appeared in the ARP table that Snitch had not seen.",
    "Un couple MAC/IP est apparu dans la table ARP, inconnu de Snitch.",
    "Phones, TVs and guests legitimately join networks — but on a network you "
    "control, an unknown device deserves one look.",
    "Téléphones, TV et invités rejoignent légitimement le réseau — mais sur un "
    "réseau que vous contrôlez, un appareil inconnu mérite un œil.",
    ["Compare with devices you own (hostname, MAC vendor)",
     "If unknown, check your router's client list"],
    ["Comparer avec vos appareils (nom d'hôte, fabricant MAC)",
     "Si inconnu, vérifier la liste des clients du routeur"]),

"DEVICE_OFFLINE": _e(
    "A LAN device went silent",
    "Un appareil LAN s'est tu",
    "A previously-seen LAN device disappeared from the ARP table.",
    "Un appareil LAN connu a disparu de la table ARP.",
    "Usually a phone sleeping or a laptop leaving. Relevant only for devices "
    "expected to stay (servers, NAS).",
    "Généralement un téléphone en veille ou un portable qui part. Pertinent "
    "seulement pour les appareils censés rester (serveurs, NAS).",
    ["None needed for mobile devices",
     "For infrastructure, check power/network state"],
    ["Rien à faire pour les mobiles",
     "Pour l'infrastructure, vérifier alimentation et réseau"]),

"PORT_SCAN": _e(
    "Port scan pattern",
    "Motif de scan de ports",
    "One host touched many distinct ports in a short window — the signature of "
    "reconnaissance (nmap-style).",
    "Un hôte a touché de nombreux ports distincts en peu de temps — signature "
    "de reconnaissance (style nmap).",
    "Scans precede attacks. Local scanners are sometimes legit (admin tools) — "
    "remote scanners are not.",
    "Les scans précèdent les attaques. Un scanner local peut être légitime "
    "(outils d'admin) — un scanner distant ne l'est pas.",
    ["Identify the scanning process / host",
     "Block the source IP with a firewall rule",
     "Kill the process if it is local and unknown"],
    ["Identifier le processus / l'hôte qui scanne",
     "Bloquer l'IP source avec une règle pare-feu",
     "Tuer le processus s'il est local et inconnu"]),

"BEACON": _e(
    "Regular-interval connections (beaconing)",
    "Connexions à intervalle régulier (balisage)",
    "Outbound connections to one host at near-constant intervals — the heartbeat "
    "pattern of malware calling its C2.",
    "Connexions sortantes vers un même hôte à intervalles quasi constants — le "
    "pouls typique d'un malware qui appelle son C2.",
    "Legit software also polls (sync, telemetry) — jitter and payload size help "
    "tell them apart: malware beacons are usually tiny and very regular.",
    "Les logiciels légitimes interrogent aussi (sync, télémétrie) — jitter et "
    "taille des paquets aident à distinguer : les beacons sont petits et très réguliers.",
    ["Check the process behind the connections",
     "Compare interval and byte counts with known sync services",
     "Run a threat-intel check on the destination",
     "Consider a firewall rule if unexplained"],
    ["Identifier le processus derrière les connexions",
     "Comparer intervalle et volume avec des services de sync connus",
     "Lancer une vérif threat-intel sur la destination",
     "Envisager une règle pare-feu si inexpliqué"]),

"VOLUME_SPIKE": _e(
    "Traffic volume spike",
    "Pic de volume de trafic",
    "Bytes-per-second to or from a host jumped far above its rolling baseline.",
    "Le débit vers/depuis un hôte a bondi bien au-dessus de sa moyenne mobile.",
    "Bulk transfers are legit (backup, video, updates) — an unexplained burst "
    "to an unknown host is not.",
    "Les gros transferts sont légitimes (backup, vidéo, mises à jour) — un pic "
    "inexpliqué vers un hôte inconnu ne l'est pas.",
    ["Check what the process was doing at that moment",
     "Export forensics for the process if unexplained"],
    ["Vérifier ce que faisait le processus à cet instant",
     "Exporter le forensique du processus si inexpliqué"]),

"MEDIA_EXFIL": _e(
    "Upload while camera/mic active",
    "Envoi de données pendant caméra/micro actifs",
    "Outbound traffic coincided with an active microphone or camera — the "
    "classic spyware pattern of streaming your sensors out.",
    "Du trafic sortant a coïncidé avec un micro ou une caméra actifs — le motif "
    "classique d'un spyware qui exfiltre vos capteurs.",
    "Video calls legitimately do this — the alert matters when the uploading "
    "process is NOT your call app.",
    "Les visioconférences font légitimement cela — l'alerte compte quand le "
    "processus émetteur n'est PAS votre app d'appel.",
    ["Verify which app holds the camera/mic",
     "Check that the uploader is the same application",
     "Kill + block if the process is unknown"],
    ["Vérifier quelle app détient caméra/micro",
     "Vérifier que l'émetteur est la même application",
     "Tuer + bloquer si le processus est inconnu"]),

"UPLOAD_SPIKE": _e(
    "Abnormal outbound volume for a process",
    "Volume sortant anormal pour un processus",
    "A process sent more data than its configured threshold allows — possible "
    "data exfiltration.",
    "Un processus a envoyé plus de données que le seuil configuré — "
    "exfiltration possible.",
    "Cloud sync and backups send a lot — the question is whether THIS process "
    "should be uploading at all.",
    "La sync cloud et les backups envoient beaucoup — la question est de savoir "
    "si CE processus devrait envoyer quoi que ce soit.",
    ["Look at the destination — cloud provider or unknown host?",
     "Adjust the threshold in Settings if this is expected",
     "Export the process bundle (SHA-256, parent tree)"],
    ["Regarder la destination — cloud connu ou hôte inconnu ?",
     "Ajuster le seuil dans Réglages si c'est attendu",
     "Exporter le paquet forensique (SHA-256, arbre parent)"]),

"WATCHLIST_HIT": _e(
    "Watched IP/domain contacted",
    "IP/domaine surveillé contacté",
    "Traffic matched an entry on your personal watchlist.",
    "Le trafic correspond à une entrée de votre liste de surveillance.",
    "You pinned this — either a host you don't trust or one you want visibility on.",
    "Vous l'avez épinglé — soit un hôte auquel vous ne faites pas confiance, "
    "soit un hôte que vous voulez suivre.",
    ["Review why it was watched",
     "Block it with a firewall rule if unwanted"],
    ["Revoir pourquoi il était surveillé",
     "Le bloquer via une règle pare-feu si indésirable"]),

"SUSPICIOUS_PROCESS": _e(
    "Unusual process networking",
    "Activité réseau inhabituelle d'un processus",
    "A process with no network business opened connections (e.g. a calculator, "
    "notepad-class tool).",
    "Un processus sans vocation réseau a ouvert des connexions (calculatrice, "
    "bloc-notes…).",
    "Offline tools going online is a top infection indicator — legit updates "
    "are the main false positive.",
    "Un outil hors-ligne qui se connecte est un indicateur majeur d'infection — "
    "les mises à jour légitimes sont le principal faux positif.",
    ["Check the executable path — is it the real tool?",
     "Run integrity check on the process",
     "Kill and block if unexplained"],
    ["Vérifier le chemin de l'exécutable — est-ce le vrai outil ?",
     "Lancer un contrôle d'intégrité sur le processus",
     "Tuer et bloquer si inexpliqué"]),

"SUSPICIOUS_PORT": _e(
    "Connection on an unusual port",
    "Connexion sur un port inhabituel",
    "A flow used a port that does not match its apparent purpose — e.g. "
    "non-HTTP traffic on 443, or a service port rarely seen outbound.",
    "Un flux utilise un port qui ne correspond pas à son usage apparent — ex. "
    "du non-HTTP sur 443, ou un port rarement vu en sortie.",
    "Attackers hide tunnels on common-looking ports; protocol/port mismatch is "
    "the cheapest way to spot them.",
    "Les attaquants cachent des tunnels sur des ports banals ; le mismatch "
    "protocole/port est le moyen le plus simple de les repérer.",
    ["Look at the actual payload classification",
     "Check if the process is expected to use that port",
     "Consider blocking the port for that process"],
    ["Regarder la classification réelle du trafic",
     "Vérifier que le processus utilise normalement ce port",
     "Envisager de bloquer le port pour ce processus"]),

"DNS_TUNNEL": _e(
    "Possible DNS tunnelling",
    "Tunnel DNS possible",
    "DNS queries with oversized names/labels or unusual frequency — the standard "
    "exfiltration channel that bypasses most firewalls.",
    "Requêtes DNS avec noms/labels surdimensionnés ou fréquence anormale — le "
    "canal d'exfiltration classique qui contourne la plupart des pare-feux.",
    "DNS is allowed almost everywhere, so malware encodes data in subdomains. "
    "Long random-looking labels are the tell.",
    "Le DNS est autorisé presque partout, donc les malwares encodent les données "
    "en sous-domaines. Les labels longs et aléatoires sont le signal.",
    ["Identify the querying process",
     "Inspect the queried domain",
     "Block the process or the resolver if confirmed"],
    ["Identifier le processus qui interroge",
     "Inspecter le domaine interrogé",
     "Bloquer le processus ou le résolveur si confirmé"]),

"CLEARTEXT": _e(
    "Unencrypted protocol in use",
    "Protocole non chiffré utilisé",
    "Outbound traffic on a legacy plaintext port (FTP, Telnet, HTTP, plain "
    "mail) — credentials or content readable on the wire.",
    "Trafic sortant sur un port en clair historique (FTP, Telnet, HTTP, mail "
    "non chiffré) — identifiants ou contenu lisibles sur le réseau.",
    "Anything readable on the wire can be stolen or tampered — on public Wi-Fi "
    "especially.",
    "Tout ce qui est lisible sur le réseau peut être volé ou altéré — sur Wi-Fi "
    "public surtout.",
    ["Check whether an encrypted alternative exists (HTTPS, SFTP, SSH)",
     "Avoid credentials over this connection",
     "Pin a note via the watchlist if it must stay"],
    ["Vérifier qu'une alternative chiffrée existe (HTTPS, SFTP, SSH)",
     "Éviter les identifiants sur cette connexion",
     "Épingler via la watchlist si elle doit rester"]),

"BASELINE_DEVIATION": _e(
    "Process changed its network habits",
    "Le processus a changé d'habitudes réseau",
    "A known process contacted a country or pattern outside its learned "
    "profile — Snitch's per-app baseline flags the drift.",
    "Un processus connu a contacté un pays ou un motif hors de son profil "
    "appris — la baseline par app de Snitch signale la dérive.",
    "Updates change destinations legitimately — but a chat app suddenly "
    "reaching an unusual country deserves a look.",
    "Les mises à jour changent légitimement de destination — mais une app de "
    "chat qui contacte soudain un pays inhabituel mérite un œil.",
    ["Check if the app recently updated",
     "Run integrity check on the executable",
     "Reset its baseline if the new behaviour is intended"],
    ["Vérifier si l'app a récemment été mise à jour",
     "Lancer un contrôle d'intégrité de l'exécutable",
     "Réinitialiser sa baseline si le comportement est voulu"]),

"THREAT_HIT": _e(
    "Threat-intel flagged destination",
    "Destination signalée par la threat intel",
    "The configured reputation provider (AbuseIPDB/OTX/VirusTotal — your own "
    "key, opt-in) reports this IP as suspicious or malicious.",
    "Le fournisseur de réputation configuré (AbuseIPDB/OTX/VirusTotal — votre "
    "clé, opt-in) rapporte cette IP comme suspecte ou malveillante.",
    "Reputation feeds are not perfect, but a flagged C2/proxy/botnet host "
    "merits immediate review.",
    "Les flux de réputation ne sont pas parfaits, mais un hôte signalé "
    "C2/proxy/botnet mérite une revue immédiate.",
    ["Read the provider detail in the alert",
     "Block the IP with a firewall rule",
     "Export forensics for the connecting process"],
    ["Lire le détail du fournisseur dans l'alerte",
     "Bloquer l'IP via une règle pare-feu",
     "Exporter le forensique du processus connecté"]),

"BLOCKED_ATTEMPT": _e(
    "Firewall rule matched a packet",
    "Une règle pare-feu a matché un paquet",
    "Traffic matching an active firewall rule (or lockdown) was observed — "
    "with privileges the OS also dropped it.",
    "Du trafic correspondant à une règle pare-feu active (ou au lockdown) a "
    "été observé — avec privilèges, l'OS l'a aussi droppé.",
    "Confirms the policy works; repeated attempts from a blocked process are "
    "the interesting signal.",
    "Confirme que la politique fonctionne ; les tentatives répétées d'un "
    "processus bloqué sont le signal intéressant.",
    ["Watch the attempt counter on the rule",
     "Investigate the blocked process if it insists",
     "Tune or delete the rule if it is wrong"],
    ["Surveiller le compteur de tentatives de la règle",
     "Investiguer le processus bloqué s'il insiste",
     "Ajuster ou supprimer la règle si elle est fausse"]),

"LOCKDOWN": _e(
    "Lockdown mode enabled",
    "Mode lockdown activé",
    "The panic switch is on — outbound traffic to public IPs is dropped; "
    "loopback and LAN stay alive.",
    "Le bouton panique est actif — le trafic sortant vers les IP publiques est "
    "coupé ; loopback et LAN restent vivants.",
    "Use during an active incident to freeze exfiltration while you investigate.",
    "À utiliser pendant un incident pour figer toute exfiltration le temps "
    "d'investiguer.",
    ["Investigate flagged processes while isolated",
     "Disable when the incident is resolved"],
    ["Investiguer les processus signalés pendant l'isolement",
     "Désactiver quand l'incident est résolu"]),

"BINARY_CHANGED": _e(
    "Executable modified on disk",
    "Exécutable modifié sur disque",
    "The SHA-256 of a running process's executable no longer matches the hash "
    "recorded for that path — the file was replaced or patched.",
    "Le SHA-256 de l'exécutable d'un processus actif ne correspond plus au hash "
    "enregistré pour ce chemin — le fichier a été remplacé ou patché.",
    "Legit updates replace binaries — but an unexplained change under a "
    "running PID is a tampering indicator.",
    "Les mises à jour remplacent légitimement les binaires — mais un changement "
    "inexpliqué sous un PID actif indique une altération.",
    ["Compare with the app's update timeline",
     "Export forensics (parent tree, hash) now",
     "Kill + block if the change is unexplained"],
    ["Comparer avec l'historique de mises à jour de l'app",
     "Exporter le forensique (arbre parent, hash) immédiatement",
     "Tuer + bloquer si le changement est inexpliqué"]),

"NAME_MISMATCH": _e(
    "Process name/executable mismatch",
    "Mismatch nom/exécutable du processus",
    "The process's reported name does not match its executable's basename — "
    "classic masquerading (malware named 'svchost' living outside System32).",
    "Le nom rapporté du processus ne correspond pas au basename de son "
    "exécutable — masquage classique (malware nommé « svchost » hors System32).",
    "Renamed copies and launchers cause rare false positives — location and "
    "parent process tell the truth.",
    "Les copies renommées et launchers causent de rares faux positifs — "
    "l'emplacement et le processus parent disent la vérité.",
    ["Check the executable's path",
     "Export the process bundle to see the parent chain",
     "Kill + block if the binary is unexpected"],
    ["Vérifier le chemin de l'exécutable",
     "Exporter le paquet pour voir la chaîne parente",
     "Tuer + bloquer si le binaire est inattendu"]),

"MEM_RWX": _e(
    "Executable-writable memory region",
    "Région mémoire exécutable-inscriptible",
    "The process maps memory that is simultaneously writable and executable "
    "(rwxp) — the signature of injected shellcode or reflective loading. "
    "Linux only (/proc/pid/maps).",
    "Le processus mappe de la mémoire à la fois inscriptible et exécutable "
    "(rwxp) — signature de shellcode injecté ou de chargement réflexif. "
    "Linux uniquement (/proc/pid/maps).",
    "JIT engines (browsers, node, java) legitimately use RWX pages — reported "
    "at info level for those. For any other process it is a strong anomaly.",
    "Les moteurs JIT (navigateurs, node, java) utilisent légitimement des pages "
    "RWX — signalés en info pour ceux-là. Pour tout autre processus, c'est une "
    "anomalie forte.",
    ["Check whether the process is a known JIT app (info-level alerts)",
     "Export forensics on the process",
     "Kill + block if the process is not a browser/runtimes"],
    ["Vérifier si le processus est une app JIT connue (alertes info)",
     "Exporter le forensique du processus",
     "Tuer + bloquer si ce n'est pas un navigateur/runtime"]),

"MODULE_SUSPECT": _e(
    "Module loaded from a staging path",
    "Module chargé depuis un chemin de staging",
    "A file-backed library inside the process lives in a location executable "
    "code should never use: temp dirs, /dev/shm, Downloads, browser caches — "
    "classic dropper/injection staging.",
    "Une bibliothèque chargée dans le processus vit dans un emplacement où du "
    "code exécutable ne devrait jamais être : temp, /dev/shm, Downloads, "
    "caches de navigateurs — staging classique de dropper/injection.",
    "Legitimate apps keep their DLLs/.so under Program Files, /usr/lib or "
    "their own bundle — almost nothing real loads code from %TEMP%.",
    "Les applications légitimes gardent leurs DLL/.so sous Program Files, "
    "/usr/lib ou leur propre bundle — presque rien de réel ne charge du code "
    "depuis %TEMP%.",
    ["List the flagged module paths in the finding",
     "Hash the modules and check them against VirusTotal yourself",
     "Kill + firewall the process if the module is unexpected"],
    ["Lister les chemins de modules signalés dans le constat",
     "Hasher les modules et les vérifier sur VirusTotal soi-même",
     "Tuer + bloquer le processus si le module est inattendu"]),

"MODULE_CHANGED": _e(
    "Mapped-module set changed",
    "Ensemble de modules modifié",
    "The Merkle root over this process's file-backed modules changed versus "
    "its recorded baseline — a DLL/.so was replaced on disk or a new module "
    "appeared since baseline.",
    "La racine Merkle des modules fichier-basés du processus a changé par "
    "rapport à la baseline — une DLL/.so a été remplacée sur disque ou un "
    "nouveau module est apparu.",
    "Updates legitimately swap modules — correlate with a recent software "
    "update. Absent one, an in-session module swap is a strong tamper signal.",
    "Les mises à jour remplacent légitimement des modules — corréler avec une "
    "update récente. Sans elle, un remplacement en session est un fort signal "
    "d'altération.",
    ["Check for a recent app/OS update covering these modules",
     "Compare expected vs actual roots in the finding",
     "Export forensics for the module list"],
    ["Vérifier une mise à jour récente couvrant ces modules",
     "Comparer les racines attendue/réelle dans le constat",
     "Exporter le forensique pour la liste des modules"]),

"MINING_STRATUM": _e(
    "Cleartext mining protocol observed",
    "Protocole de minage en clair observé",
    "The connection payload contains the JSON-RPC stratum dialect miners "
    "speak to pools (\"mining.subscribe\", \"mining.authorize\"…) — a "
    "near-conclusive cryptomining signature.",
    "Le payload de la connexion contient le dialecte JSON-RPC stratum que les "
    "mineurs parlent aux pools (« mining.subscribe », « mining.authorize »…) "
    "— signature quasi-concluante de cryptominage.",
    "Nothing legitimate speaks stratum on a workstation. Encrypted stratum "
    "(TLS) stays invisible to this check — cleartext is what miners still "
    "use on many pools.",
    "Rien de légitime ne parle stratum sur un poste. Le stratum chiffré (TLS) "
    "reste invisible à ce contrôle — le clair reste utilisé par beaucoup de "
    "pools.",
    ["Identify the process and kill it if unwanted",
     "Block the pool IP/port with a firewall rule",
     "Export forensics — miners usually reinstall via a dropper"],
    ["Identifier le processus et le tuer s'il est indésirable",
     "Bloquer l'IP/port du pool par une règle pare-feu",
     "Exporter le forensique — les mineurs se réinstallent via dropper"]),

"MINING_SUSPECT": _e(
    "Pool port + sustained CPU",
    "Port de pool + CPU soutenue",
    "A process keeps talking to a well-known mining-pool port while burning "
    "sustained CPU — the combination is suspect even though neither signal "
    "alone would be.",
    "Un processus parle à un port de pool de minage connu tout en brûlant de "
    "la CPU de façon soutenue — la combinaison est suspecte, même si aucun "
    "signal seul ne le serait.",
    "IRC/game traffic shares pool ports legitimately — sustained high CPU is "
    "the corroboration. A warning, not a verdict.",
    "Le trafic IRC/jeu partage ces ports légitimement — la CPU soutenue est "
    "la corroboration. Un avertissement, pas un verdict.",
    ["Check the process's CPU in the process list",
     "Run a perf sample (/security/perf) for hardware counters",
     "Block the destination if the usage is unexplained"],
    ["Vérifier la CPU du processus dans la liste",
     "Lancer un échantillon perf (/security/perf) pour les compteurs",
     "Bloquer la destination si l'usage est inexpliqué"]),

"SINKHOLE_HIT": _e(
    "Sinkholed connection observed",
    "Connexion sinkholée observée",
    "A process connected to a destination you sinkholed — the loopback "
    "responder captured its HTTP Host/path or TLS SNI, revealing what the "
    "blocked app was trying to reach.",
    "Un processus s'est connecté à une destination sinkholée — le répondeur "
    "loopback a capturé son Host/chemin HTTP ou SNI TLS, révélant ce que "
    "l'appli bloquée cherchait.",
    "This is the sinkhole doing its job: the attempt is contained AND "
    "observed. Repeated hits from one process deserve a process-level rule.",
    "C'est le sinkhole qui fait son travail : la tentative est contenue ET "
    "observée. Des hits répétés d'un même processus méritent une règle "
    "processus.",
    ["Read the captured host/path in the finding",
     "Create a process rule if the same app keeps retrying",
     "Deep-inspect the process if it adapts to the sinkhole"],
    ["Lire l'hôte/chemin capturé dans le constat",
     "Créer une règle processus si l'app retente sans cesse",
     "Inspecter le processus s'il s'adapte au sinkhole"]),

"INJECT_SUSPECT": _e(
    "Connection from a staged module",
    "Connexion depuis un module stagé",
    "During deep inspection, an outbound connection originated from a module "
    "loaded out of a temp/cache/download staging path — the signature of "
    "injected code phoning home through a legit-looking process.",
    "Pendant l'inspection profonde, une connexion sortante provenait d'un "
    "module chargé depuis un chemin de staging temp/cache/download — la "
    "signature de code injecté qui appelle sa base via un processus "
    "d'apparence légitime.",
    "This is Frida-level evidence, not a packet guess: the calling module "
    "itself was resolved. Almost no legitimate software connects from %TEMP%.",
    "C'est une preuve de niveau Frida, pas une estimation paquet : le module "
    "appelant lui-même a été résolu. Presque aucun logiciel légitime ne "
    "connecte depuis %TEMP%.",
    ["Review the flagged module paths",
     "Kill the host process and quarantine the module file",
     "Expect re-injection — check the parent process tree"],
    ["Examiner les chemins de modules signalés",
     "Tuer le processus hôte et mettre le module en quarantaine",
     "Anticiper la réinjection — vérifier l'arbre des processus parents"]),

"COMMUNITY_IOC": _e(
    "Community pack hint",
    "Indice du paquet communautaire",
    "A destination matched a shared IOC pack — Bloom + randomized response "
    "means membership is probabilistic, not proof.",
    "Une destination a correspondu à un paquet d'IOC partagé — Bloom + "
    "randomized response rendent l'appartenance probabiliste, pas certaine.",
    "Treat as a hint: false positives are expected by design. Corroborate "
    "with local signals before acting.",
    "À traiter comme un indice : les faux positifs sont attendus par "
    "conception. Corroborer avec des signaux locaux avant d'agir.",
    ["Run a local reputation check on the indicator",
     "Watch the destination before blocking"],
    ["Lancer une vérif de réputation locale sur l'indicateur",
     "Surveiller la destination avant de bloquer"]),

"CUSTOM_RULE": _e(
    "Your rule matched",
    "Votre règle a correspondu",
    "A packet matched a condition YOU defined in the alert-rules panel "
    "(field + operator + value). This is your own detection firing — "
    "not a built-in heuristic.",
    "Un paquet a correspondu à une condition que VOUS avez définie dans "
    "le panneau de règles (champ + opérateur + valeur). C'est votre propre "
    "détection qui se déclenche — pas une heuristique intégrée.",
    "Default rules only alert; rules with the block action additionally "
    "install a firewall rule on the remote host. Tune field/op/value if "
    "it fires too often, or disable it from the rules list.",
    "Par défaut la règle ne fait qu'alerter ; une règle avec l'action "
    "« block » installe de plus une règle pare-feu sur l'hôte distant. "
    "Ajustez champ/op/valeur si elle se déclenche trop, ou désactivez-la.",
    ["Check which process triggered it",
     "Tighten the matcher if noisy",
     "Review any firewall rule it auto-created"],
    ["Vérifier quel processus l'a déclenchée",
     "Resserrer le filtre si trop bavarde",
     "Revoir la règle pare-feu auto-créée le cas échéant"]),

"TLS_CERT": _e(
    "TLS certificate anomaly",
    "Anomalie du certificat TLS",
    "The server presented a leaf certificate that is self-signed or whose "
    "SANs do not cover the requested SNI — observed passively from the "
    "handshake, no interception involved.",
    "Le serveur a présenté un certificat feuille auto-signé ou dont les "
    "SANs ne couvrent pas le SNI demandé — observé passivement sur le "
    "handshake, sans interception.",
    "Self-signed certs are normal on internal tools and dev boxes; on a "
    "public service they can mean MitM or a C2 with a throwaway cert. A "
    "SAN/SNI mismatch means the endpoint answered with someone else's "
    "certificate — suspicious on real services.",
    "L'auto-signé est normal sur les outils internes et dev ; sur un "
    "service public cela peut indiquer un MitM ou un C2 à cert jetable. "
    "Un mismatch SAN/SNI signifie que l'endpoint a répondu avec le "
    "certificat d'un autre — suspect sur un vrai service.",
    ["Check the issuer shown in the alert",
     "Verify the site loads correctly in a browser",
     "Block the IP if the endpoint cannot be explained",
     "Note: TLS 1.3 encrypts this message — absence of alert is not proof"],
    ["Vérifier l'émetteur affiché dans l'alerte",
     "Vérifier que le site se charge normalement dans un navigateur",
     "Bloquer l'IP si l'endpoint est inexplicable",
     "NB : TLS 1.3 chiffre ce message — l'absence d'alerte n'est pas une preuve"]),

"HIGH_ENTROPY": _e(
    "Encrypted-looking data on a cleartext channel",
    "Données d'apparence chiffrée sur un canal en clair",
    "The first payload bytes on a non-TLS socket are statistically "
    "near-random — real plaintext protocols are structured and compress "
    "well, so this suggests covert encryption, packed data or stego.",
    "Les premiers octets du payload sur une socket non TLS sont "
    "statistiquement quasi aléatoires — un vrai protocole clair est "
    "structuré ; cela suggère du chiffrement couvert, des données packées "
    "ou de la stéganographie.",
    "Info-level by design: compressed uploads (zip, video, protobuf) "
    "trigger it legitimately. It matters when an unexpected process "
    "produces it.",
    "Niveau info par conception : les envois compressés (zip, vidéo, "
    "protobuf) la déclenchent légitimement. Elle compte quand un "
    "processus inattendu la produit.",
    ["Check which process is sending",
     "Correlate with destination and other alerts",
     "Ignore for known compression-heavy apps"],
    ["Vérifier quel processus envoie",
     "Corréler avec la destination et les autres alertes",
     "Ignorer pour les apps connues très compressées"]),

"ICMP_TUNNEL": _e(
    "Possible ICMP tunnelling",
    "Tunnel ICMP possible",
    "Repeated ICMP echo packets carrying unusually large payloads — real "
    "echo traffic is tiny; fat echoes are the classic signature of ICMP "
    "exfiltration tools (ptunnel, icmpsh).",
    "Paquets d'écho ICMP répétés avec des payloads anormalement gros — "
    "l'écho réel est minuscule ; de gros échos sont la signature "
    "classique des outils d'exfiltration ICMP (ptunnel, icmpsh).",
    "ICMP passes where TCP/UDP are filtered, making it a favourite "
    "covert channel. Requires several fat echoes to fire, so a single "
    "odd ping stays quiet.",
    "L'ICMP passe là où TCP/UDP sont filtrés — canal couvert favori. "
    "Plusieurs gros échos requis pour déclencher, un ping isolé reste muet.",
    ["Identify which host pair is talking",
     "Check whether diagnostic tooling runs ICMP here",
     "Block ICMP to that peer with a firewall rule if confirmed"],
    ["Identifier la paire d'hôtes qui communique",
     "Vérifier qu'un outil de diagnostic n'utilise pas ICMP ici",
     "Bloquer l'ICMP vers ce pair si confirmé"]),

"ML_ANOMALY": _e(
    "Flow unlike this machine's baseline",
    "Flux atypique vs la baseline de la machine",
    "A pure-Python isolation forest scored this outbound flow as an "
    "outlier against YOUR OWN recent traffic — unusual port, interval, "
    "size pattern or fan-out. Unsupervised: it learned what YOUR machine "
    "looks like, not what malware looks like.",
    "Une forêt d'isolation pur Python a scoré ce flux sortant comme "
    "outlier face à VOTRE propre trafic récent — port, intervalle, taille "
    "ou fan-out inhabituels. Non supervisé : elle a appris à quoi "
    "ressemble VOTRE machine, pas ce à quoi ressemble un malware.",
    "Complements the heuristics — it can catch patterns no rule was "
    "written for, but unusual-but-legit software (new apps, rare "
    "backups) will also stand out early on. It needs a few hundred flows "
    "before it scores anything.",
    "Complète les heuristiques — elle peut attraper des motifs pour "
    "lesquels aucune règle n'existe, mais le logiciel inhabituel-et-"
    "légitime ressort aussi au début. Quelques centaines de flux sont "
    "requis avant le premier score.",
    ["Compare with what changed on the machine recently",
     "Check the process against the integrity tools",
     "Expect noise in the first days — it sharpens with uptime"],
    ["Comparer avec ce qui a changé récemment sur la machine",
     "Vérifier le processus avec les outils d'intégrité",
     "Bruit attendu les premiers jours — se raffine avec le temps"]),

"ASK_VERDICT": _e(
    "New flow awaiting your verdict",
    "Nouveau flux en attente de verdict",
    "Ask-on-first-connect is enabled: the kernel handed this packet to "
    "Snitch instead of letting it through. It is genuinely suspended "
    "until you answer — this is real verdict power, not a notification.",
    "Le mode ask-on-first-connect est actif : le noyau a remis ce paquet "
    "à Snitch au lieu de le laisser passer. Il est réellement suspendu "
    "jusqu'à votre réponse — vrai pouvoir de verdict, pas une notif.",
    "Only the FIRST packet of each flow waits — decide once and the rest "
    "of the connection rides your decision for the session. Unanswered "
    "flows hit the timeout policy (drop by default).",
    "Seul le PREMIER paquet de chaque flux attend — décidez une fois et "
    "le reste de la connexion suit votre décision pour la session. Les "
    "flux sans réponse subissent la politique de timeout (drop par défaut).",
    ["Allow once or deny from the prompt",
     "Create a firewall rule for permanent decisions",
     "Linux/NFQUEUE only — see /security/ask for platform status"],
    ["Autoriser ou refuser depuis le prompt",
     "Créer une règle pare-feu pour les décisions permanentes",
     "Linux/NFQUEUE seulement — voir /security/ask pour le statut"]),

"DGA_SUSPECT": _e(
    "Domain looks algorithmically generated",
    "Domaine à aspect généré algorithmiquement",
    "The resolved name or TLS SNI fails lexical checks typical of domain-"
    "generation algorithms: high entropy, almost no vowels, stacked "
    "consonants, digit noise — how malware C2 hostnames usually look.",
    "Le nom résolu ou le SNI TLS échoue aux contrôles lexicaux typiques "
    "des algorithmes de génération de domaines : entropie élevée, quasi "
    "aucune voyelle, consonnes empilées, chiffres — le look classique "
    "des C2 de malware.",
    "Pure local heuristic — no WHOIS, no domain-age data. Legit-but-"
    "weird names (hashes, build artifacts) can trip it occasionally; the "
    "finding is info-level and cooled down per name.",
    "Heuristique purement locale — ni WHOIS ni âge du domaine. Des noms "
    "légitimes bizarres (hachés, artefacts de build) peuvent déclencher "
    "occasionnellement ; niveau info, cooldown par nom.",
    ["Check which process resolved it",
     "Look for follow-up connections to the resolved IP",
     "Ignore once for known dev/build tools"],
    ["Vérifier quel processus l'a résolu",
     "Surveiller les connexions vers l'IP résolue",
     "Ignorer une fois pour les outils de build connus"]),

"PROTO_MISMATCH": _e(
    "Payload does not match the port's protocol",
    "Payload non conforme au protocole du port",
    "The first bytes on this socket do not look like the protocol the "
    "port advertises — non-HTTP on :80, non-TLS on :443, non-DNS on :53, "
    "non-SSH on :22… Attackers hide tunnels on friendly ports to slip "
    "past firewall rules.",
    "Les premiers octets de cette socket ne ressemblent pas au protocole "
    "annoncé par le port — non-HTTP sur :80, non-TLS sur :443, non-DNS "
    "sur :53, non-SSH sur :22… Les attaquants planquent des tunnels sur "
    "des ports amicaux pour passer les pare-feux.",
    "Heuristic on the ≤64-byte head only — exotic legit protocols "
    "(WebSocket upgrades, custom daemons) may trip it once, then the "
    "cooldown keeps it quiet.",
    "Heuristique sur la tête ≤64 o seulement — des protocoles légitimes "
    "exotiques (upgrades WebSocket, démons custom) peuvent déclencher une "
    "fois puis le cooldown les tait.",
    ["Inspect the process — legit apps use their own ports",
     "Correlate with HIGH_ENTROPY/DNS_TUNNEL on the same host",
     "Block the flow if the process can't be explained"],
    ["Inspecter le processus — les apps légitimes utilisent leurs ports",
     "Corréler avec HIGH_ENTROPY/DNS_TUNNEL sur le même hôte",
     "Bloquer le flux si le processus est inexplicable"]),
}


def explain(alert_type: str) -> dict | None:
    """EN: Explanation record for one alert type — None when unknown.
    FR: Explication pour un type d'alerte — None si inconnu."""
    return EXPLANATIONS.get((alert_type or "").upper())


def all_types() -> list[str]:
    """EN: Alert types with an explanation — used by the audit endpoint.
    FR: Types d'alertes documentés — utilisé par l'endpoint d'audit."""
    return sorted(EXPLANATIONS)