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.
Python cybersecurityd3jsebpfedrelectronfastapifirewallfleet-managementlinuxlittle-snitch-alternativemacosnetwork-monitornetwork-securitypacket-captureprivacyreactrustself-hostedsiemwindows
Sync project surfaces to v1.6.3 + fix winget gate
MoneyLisa3128b64f41bd
diff --git a/.github/workflows/release.yml b/.github/workflows/release.ymlindex 6c10be9..8f10679 100644--- a/.github/workflows/release.yml+++ b/.github/workflows/release.yml@@ -14,6 +14,11 @@ name: releaseon:push:tags: ["v*"]+ # EN: manual re-run against an existing tag — pick the tag as the ref+ # so ${GITHUB_REF_NAME} resolves and jobs re-publish idempotently.+ # FR: relance manuelle sur un tag existant — choisir le tag comme ref+ # pour que ${GITHUB_REF_NAME} se résolve et republie idempotemment.+ workflow_dispatch:permissions:contents: write@@ -96,7 +101,7 @@ jobs:N=$(curl -s "https://api.github.com/repos/${{ github.repository }}/releases/tags/${GITHUB_REF_NAME}" \| { grep -oE '"name"[ ]*:[ ]*"Snitch-Setup[^"]*"' || true; } | wc -l | tr -d ' ')echo "count=$N" >> "$GITHUB_OUTPUT"- [ "$N" = "0" ] && echo "::notice::no Snitch-Setup-*.exe release asset — skipping winget submission"+ if [ "$N" = "0" ]; then echo "::notice::no Snitch-Setup-*.exe release asset — skipping winget submission"; fi- name: Submit winget manifest / Soumettre le manifeste wingetif: env.WINGET_TOKEN != '' && steps.assets.outputs.count != '0'uses: vedantmgoyal9/winget-releaser@v2diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 435be3c..f136a57 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -6,6 +6,26 @@ All notable changes to Snitch. / Toutes les modifications notables de Snitch.The format follows [Keep a Changelog](https://keepachangelog.com/) — EN/FR.+## [Unreleased] — docs & pipeline sync / synchro docs & pipeline++### Changed / Modifié++- EN: **All project surfaces synced to v1.6.3** — README (Rust agent,+ enrollment, `ti_feeds`, `.rpm`, `snitchd` formula), ROADMAP (v1.5.x/+ v1.6.x shipped rows, fleet scale-out items), wiki (API catalog → 76+ endpoints, new *Fleet & Agent* page, Installation/Roadmap/FAQ/Usage+ refreshed), GitHub Pages (monitor+firewall positioning, fleet/SIEM+ cards, brew/deb/rpm install lines), topics (+rust/ebpf/edr/siem/+ fleet-management), milestone `v1.7.0` + tracking issues #53–#57.+ FR: **Toutes les surfaces du projet synchronisées en v1.6.3** —+ README, ROADMAP, wiki (catalogue API complet, nouvelle page *Flotte+ & agent*), GitHub Pages, topics, milestone `v1.7.0` + tickets #53–#57.+- EN: release workflow — `workflow_dispatch` enabled for manual+ re-publish; winget asset gate no longer fails red when the count is+ non-zero (`if` instead of `&&`, bash forced on Windows runner).+ FR: workflow release — `workflow_dispatch` pour republication+ manuelle ; le garde winget n'échoue plus quand le compte est non nul.+## [1.6.3] — 2026-10-22 — hygiene & hardening / hygiène & durcissement### Fixed / Corrigédiff --git a/README.md b/README.mdindex dd60e03..6b04932 100644--- a/README.md+++ b/README.md@@ -89,7 +89,8 @@ The entire interface is available in **English, Français, Español, Deutsch, Р| Platform | Package ||---|---|| **macOS (Apple Silicon)** | `brew install --cask aixisstudio/tap/snitch` — or **Snitch.app** zip/dmg from [latest release](https://github.com/aixisstudio/Snitch/releases/latest) |-| **Linux** | **Snitch AppImage / .deb / .snap** from [latest release](https://github.com/aixisstudio/Snitch/releases/latest) — or `sudo docker compose up --build`, see [Docker (Linux)](#docker-linux) |+| **Linux** | **Snitch AppImage / .deb / .rpm / .snap** from [latest release](https://github.com/aixisstudio/Snitch/releases/latest) — or `sudo docker compose up --build`, see [Docker (Linux)](#docker-linux) |+| **Headless (any OS)** | `brew install aixisstudio/tap/snitch` → `snitchd` daemon binary (servers/VMs, no GUI) || **Windows** | **Snitch Setup** `.exe` — one-click NSIS installer (native app, UAC prompt at launch, Npcap check built in) from [latest release](https://github.com/aixisstudio/Snitch/releases/latest). Lite alternative: `Snitch-Lite-Setup` (backend + browser UI). Requires [Npcap](https://npcap.com/) || **All (1-click)** | [Pinokio](https://pinokio.co/apps/github-com-aixisstudio-snitch) — installs deps, runs the backend, opens the UI / installe tout, lance le backend, ouvre l'UI |@@ -259,11 +260,17 @@ everything is file-driven and free:- **Fleet view** — `GET /remote/fleet` merges every configured peer'shardening audit into one dashboard; a Helm chart(`deploy/helm/snitch`) runs the collector in-cluster.+- **Rust agent** — a zero-dependency daemon (`agent/`) streams socket+ events to `POST /ingest/events` with Linux `/proc`→PID attribution;+ `POST /ingest/enroll` issues one-shot `sagt_…` tokens (hashed at+ rest, revocable via `/ingest/revoke`) so a compromised agent can+ never impersonate a peer.- **Headless** — hardened systemd unit (`deploy/systemd/`), nfpm`.deb`/`.rpm` packaging (`packaging/`), Docker image — no GUI needed.- **Free threat feeds** — `POST /firewall/blocklist` imports domain(StevenBlack) and IP (Blocklist.de, URLhaus/Feodo) lists, locally or- via explicit opt-in fetch.+ via explicit opt-in fetch; the `ti_feeds` setting schedules automatic+ refreshes with a hot firewall reload.Step-by-step recipes live in [docs/INTEGRATIONS.md](docs/INTEGRATIONS.md).@@ -348,7 +355,8 @@ Toute l'interface est disponible en **English, Français, Español, Deutsch, Р| Plateforme | Paquet ||---|---|| **macOS (Apple Silicon)** | `brew install --cask aixisstudio/tap/snitch` — ou **Snitch.app** zip/dmg depuis la [dernière release](https://github.com/aixisstudio/Snitch/releases/latest) |-| **Linux** | **Snitch AppImage / .deb / .snap** depuis la [dernière release](https://github.com/aixisstudio/Snitch/releases/latest) — ou `sudo docker compose up --build`, voir [Docker (Linux)](#docker-linux-1) |+| **Linux** | **Snitch AppImage / .deb / .rpm / .snap** depuis la [dernière release](https://github.com/aixisstudio/Snitch/releases/latest) — ou `sudo docker compose up --build`, voir [Docker (Linux)](#docker-linux-1) |+| **Headless (tout OS)** | `brew install aixisstudio/tap/snitch` → binaire daemon `snitchd` (serveurs/VM, sans GUI) || **Windows** | **Snitch Setup** `.exe` — installeur NSIS en un clic (app native, prompt UAC au lancement, détection Npcap intégrée) depuis la [dernière release](https://github.com/aixisstudio/Snitch/releases/latest). Alternative lite : `Snitch-Lite-Setup` (backend + UI navigateur). Nécessite [Npcap](https://npcap.com/) |Ou récupérez la dernière release : **[github.com/aixisstudio/Snitch/releases](https://github.com/aixisstudio/Snitch/releases)**@@ -457,11 +465,18 @@ est piloté par fichiers et gratuit :- **Vue de flotte** — `GET /remote/fleet` fusionne l'audit de durcissementde chaque pair ; un chart Helm (`deploy/helm/snitch`) fait tourner lecollecteur en cluster.+- **Agent Rust** — un daemon zéro-dépendance (`agent/`) envoie les+ sockets à `POST /ingest/events` avec attribution `/proc`→PID sous+ Linux ; `POST /ingest/enroll` émet des jetons `sagt_…` à usage unique+ (hashés, révocables via `/ingest/revoke`) — un agent compromis ne+ peut pas usurper ses pairs.- **Headless** — unité systemd durcie (`deploy/systemd/`), packaging`.deb`/`.rpm` via nfpm (`packaging/`), image Docker — sans GUI.- **Flux TI gratuits** — `POST /firewall/blocklist` importe les listesde domaines (StevenBlack) et d'IP (Blocklist.de, URLhaus/Feodo),- localement ou via fetch opt-in explicite.+ localement ou via fetch opt-in explicite ; le réglage `ti_feeds`+ planifie les rafraîchissements automatiques avec rechargement pare-feu+ à chaud.Recettes pas-à-pas dans [docs/INTEGRATIONS.md](docs/INTEGRATIONS.md).diff --git a/ROADMAP.md b/ROADMAP.mdindex 3eb8748..a2ad4b7 100644--- a/ROADMAP.md+++ b/ROADMAP.md@@ -16,13 +16,19 @@Also live / également en place : Docker image on GHCR, Homebrew tap (`brew install --cask aixisstudio/tap/snitch`), winget package [submitted](https://github.com/microsoft/winget-pkgs/pull/455520), zh-CN README, GitHub Discussions.| **v1.2 (main, untagged)** | **Security & threat-hunting suite** — OS-firewall orchestration (rules IP/CIDR/domain/process/port via `netsh`/`iptables`/`pf`, best-effort privileges), lockdown panic switch, kill/suspend process actions, opt-in threat intel (AbuseIPDB/OTX), opt-in webhooks (Discord/Slack/Telegram/generic), DNS-tunnel & cleartext & country-baseline detection, security audit report, forensics export (process tree + SHA-256), 8-language UI (`locales/` files) / **suite sécurité & chasse aux menaces** — orchestration pare-feu OS, bouton lockdown, actions kill/suspend, threat intel opt-in, webhooks opt-in, détection tunnel DNS / trafic clair / déviation pays, audit de sécurité, export forensique, UI en 8 langues |+| **v1.5.x** | **Enterprise / SOC layer** — declarative `snitch.toml` (`$SNITCH_CONFIG`), CEF + RFC 3164 syslog + `format=ecs` NDJSON export, Sigma rule import + YARA-L export, `/remote/fleet` collector view + Helm chart (`deploy/helm/snitch`), Ansible / Puppet / Salt / GPO deploys (`deploy/`), hardened systemd unit + nfpm `.deb`/`.rpm`, free threat-intel feeds (StevenBlack, Blocklist.de, URLhaus/Feodo), MkDocs site + `INTEGRATIONS.md` in 7 languages / **couche entreprise / SOC** — `snitch.toml` déclaratif, syslog CEF/RFC 3164 + export ECS, import Sigma + export YARA-L, vue de flotte `/remote/fleet` + chart Helm, déploiements Ansible/Puppet/Salt/GPO, unité systemd durcie + `.deb`/`.rpm` nfpm, flux TI gratuits, site MkDocs + intégrations en 7 langues |+| **v1.6.x** | **Agent & fleet identity** — zero-dependency Rust agent (`agent/`, Linux `/proc` socket→PID attribution, `POST /ingest/events`), per-agent enrollment (`POST /ingest/enroll` → one-shot `sagt_…` tokens, hashed at rest, `/ingest/revoke`), automatic TI-feed refresh worker (`ti_feeds` setting, per-feed interval, hot firewall reload), cross-platform agent CI (Linux/macOS/Windows), headless Homebrew formula `snitchd` (CLI name de-conflicted, #51), end-to-end green release pipeline (nfpm + tap + winget/choco-ready), all CodeQL alerts closed, 235-test backend suite / **agent & identité de flotte** — agent Rust zéro-dépendance (attribution socket→PID Linux via `/proc`), enrôlement par agent (jetons `sagt_…` hashés, révocation), worker de rafraîchissement TI automatique (`ti_feeds`), CI agent sur 3 OS, formule Homebrew headless `snitchd`, pipeline release vert de bout en bout, alertes CodeQL fermées, 235 tests backend |## 🚧 v1.x — in progress / en cours- [x] **Signed Windows installer** — CI wired for [SignPath](https://signpath.org) OSS (free Authenticode for approved projects); activates once the application is accepted — see `docs/SIGNING.md` / CI branchée sur SignPath OSS (signature Authenticode gratuite pour projets acceptés) ; s'active dès l'acceptation — voir `docs/SIGNING.md`- [ ] **Signed & notarized macOS build** — needs an Apple Developer account ($99/yr), no free path exists. Until then the [tap](https://github.com/aixisstudio/homebrew-tap) strips quarantine for you / build macOS signée et notarisée — nécessite un compte Apple Developer, aucune voie gratuite. En attendant, le tap retire la quarantaine automatiquement- [ ] **Homebrew upstream** (`brew install --cask snitch`) — blocked: the `snitch` formula name is already taken by an unrelated project; revisit once we have Developer ID signing / bloqué : le nom `snitch` est déjà pris par un autre projet ; à revoir une fois la signature en place-- [ ] **winget publishing** — [PR #455520](https://github.com/microsoft/winget-pkgs/pull/455520) open, awaiting Microsoft review / en attente de validation Microsoft+- [ ] **winget publishing** — [PR #455520](https://github.com/microsoft/winget-pkgs/pull/455520) (v1.0.8) open; release pipeline now auto-submits the latest NSIS build once `Snitch-Setup-*.exe` assets exist / PR v1.0.8 ouverte ; le pipeline soumet automatiquement le NSIS le plus récent dès que les assets existent+- [ ] **Chocolatey** — package + silent GPO installer ready (`installer/Snitch.nuspec`); activates once a maintainer `CHOCO_API_KEY` is set in repo secrets / paquet + installeur GPO silencieux prêts ; s'active dès qu'une clé `CHOCO_API_KEY` est posée dans les secrets+- [x] **Headless Homebrew formula** — `brew install aixisstudio/tap/snitch` installs the `snitchd` daemon binary (bare `snitch` CLI name de-conflicted vs `karol-broda/snitch`, #51) / formule Homebrew headless — `brew install aixisstudio/tap/snitch` installe le binaire `snitchd` (nom CLI déconflictionné, #51)+- [ ] **Fleet scale-out** — current ingest + SQLite WAL fits SME fleets; >1 000 agents needs a queue-backed collector (NATS/Kafka) and PostgreSQL/TimescaleDB storage / passage à l'échelle — l'ingest actuel + WAL convient aux PME ; au-delà de 1 000 agents, collecteur à file (NATS/Kafka) + stockage PostgreSQL/TimescaleDB+- [ ] **Agent attribution on Windows/macOS** — the Rust agent ships Linux `/proc` attribution today; Windows needs `GetExtendedTcpTable`, macOS `libproc` / attribution agent sur Windows/macOS — l'agent Rust livre déjà l'attribution `/proc` Linux ; Windows exige `GetExtendedTcpTable`, macOS `libproc`- [x] **Windows 1-click installers** — Electron NSIS (`Snitch Setup.exe`, native app + tray) and Inno Lite (`Snitch-Lite-Setup.exe`, backend + browser UI) build in CI on tags; shipping since v1.0.6 / installeurs Windows en un clic — NSIS Electron + Inno Lite, construits en CI aux tags ; livré depuis v1.0.6- [x] **Linux packages** — .deb / AppImage / **snap** alongside Docker (no Flatpak: the sandbox cannot expose packet capture) / paquets Linux en plus de Docker — deb / AppImage / **snap** (pas de Flatpak : la sandbox ne peut pas exposer la capture)- [x] **Auto-update** — electron-updater on the published `latest-*.yml` feeds, opt-out in Settings / auto-mise à jour — electron-updater sur les flux `latest-*.yml`, désactivable dans Réglages