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.

Sync project surfaces to v1.6.3 + fix winget gate

MoneyLisa3128b64f41bd
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index 6c10be9..8f10679 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -14,6 +14,11 @@ name: release
on:
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 winget
if: env.WINGET_TOKEN != '' && steps.assets.outputs.count != '0'
uses: vedantmgoyal9/winget-releaser@v2
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 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.md
index 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's
hardening 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 durcissement
de chaque pair ; un chart Helm (`deploy/helm/snitch`) fait tourner le
collecteur 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 listes
de 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.md
index 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