@@ -24,6 +24,7 @@ Réglages par variables d'environnement, lues au démarrage :
 | `NETCROSS_API_WORKERS` | `2` | Analyses simultanées en tâche de fond. |
 | `NETCROSS_DB_PATH` | absent | Base SQLite : analyses conservées et rechargées au redémarrage. Absent : tout reste en mémoire. |
 | `NETCROSS_HISTORY_DB` | absent | Historique des runs (format `--history-db`) : `history=true` sur `/comparisons` y enregistre la comparaison, sur `/captures` et `/captures/multi` l'analyse (#890), `GET /history` le consulte. Absent : enregistrement refusé (400), consultation 503. Le client ne choisit jamais le chemin. |
+| `NETCROSS_API_BPF_FILTERS` | `~/.netcross/bpf_filters.json` | Fichier de la bibliothèque de filtres BPF (`/bpf-filters`, issue #906), même format que la GUI et `--bpf-library`. Le client ne choisit jamais le chemin. |
 | `NETCROSS_CVE_DB` | absent | Base CVE complète du rapport de sécurité (équivalent de `--cve-db`). Absent : base minimale embarquée, comme la CLI. Un chemin inexistant fait échouer l'analyse (la base n'est jamais créée vide). |
 | `NETCROSS_API_MAX_BATCHES` | 20 | Lots conservés en mémoire avec leurs rapports (issue #872) ; au-delà, les plus anciens lots terminés sont supprimés. |
 | `NETCROSS_PLUGIN_PATH` | absent | Fichiers plugins locaux, séparés par `:` (équivalent de `--plugin-path`, issue #867). Fixés par l'administrateur : le client ne fait que nommer un plugin dans le champ `plugins`. Voir [plugins](plugins.md#api-rest-issue-867). |
@@ -80,6 +81,9 @@ La spécification OpenAPI est disponible sur :
 | `POST` | `/tools/export` | Sous-ensemble filtré (`file`, `bpf`, `time_start`, `time_end`, `endpoints`, `format`) : `--export-pcap` (issue #886) |
 | `POST` | `/tools/adjust-time` | Recalage (`file`, puis `time_offset`, `normalize` ou `align_to`, `format`) : `--adjust-time-output` (issue #887) |
 | `POST` | `/tools/replay` | Rejeu (`file`, `interface`, `speed`, `loop`) : `--replay`. ÉMET du trafic réel ; refusé (403) sauf si `interface` figure dans `NETCROSS_REPLAY_INTERFACES` (liste séparée par des virgules, vide par défaut) ; 503 si tcpreplay absent (issue #871) |
+| `GET` | `/bpf-filters` | Bibliothèque de filtres BPF (`--bpf-library`, issue #906) : catalogue prédéfini (`predefined: true`) puis filtres enregistrés |
+| `PUT` | `/bpf-filters/{nom}` | Crée ou remplace un filtre (JSON `expression`, `description`) ; 409 pour un nom du catalogue, 422 si l'expression est vide |
+| `DELETE` | `/bpf-filters/{nom}` | Supprime un filtre enregistré ; 404 s'il est inconnu, 409 pour un nom du catalogue |
 | `GET` | `/health` | Health check |
 
 ## Exemples curl
 
@@ -23,6 +23,30 @@ Les erreurs (champ vide, nom déjà pris par le catalogue, fichier illisible,
 erreur d'écriture) s'affichent dans la fenêtre de sauvegarde ; rien n'est
 écrit dans ces cas.
 
+## Par l'API
+
+Issue #906. La bibliothèque est aussi gérée par l'API REST, sur le même
+fichier (celui du serveur : `$NETCROSS_API_BPF_FILTERS` s'il est défini,
+sinon `~/.netcross/bpf_filters.json` du compte qui exécute l'API) :
+
+```bash
+# catalogue prédéfini puis filtres enregistrés ("predefined": true/false)
+curl -H "X-API-Key: $NETCROSS_API_TOKEN" http://localhost:8000/bpf-filters
+
+# enregistrer (ou remplacer) un filtre
+curl -X PUT -H "X-API-Key: $NETCROSS_API_TOKEN" -H "Content-Type: application/json" \
+  -d '{"expression": "host 10.0.0.1 and tcp", "description": "Serveur web"}' \
+  "http://localhost:8000/bpf-filters/Serveur%20web"
+
+# supprimer
+curl -X DELETE -H "X-API-Key: $NETCROSS_API_TOKEN" "http://localhost:8000/bpf-filters/Serveur%20web"
+```
+
+Mêmes règles qu'en GUI : un nom du catalogue est refusé (409), une
+expression vide aussi (422), un fichier illisible n'est jamais écrasé (500,
+fichier intact). Un filtre enregistré par l'API est aussitôt utilisable par
+`--bpf-library NOM` et apparaît dans le menu « Filtres… » de la GUI.
+
 ## Catalogue prédéfini
 
 | Nom | Expression BPF |
 
@@ -11,7 +11,7 @@
 > Il remplace l'ancienne section 3 de `docs/features-backlog.md`, tenue à la main, qui avait dérivé
 > (voir `docs/sessions/session-36.md`, issue #140).
 
-194 modules · 282 classes · 671 fonctions publiques de module.
+195 modules · 283 classes · 678 fonctions publiques de module.
 
 Conventions : `+` public, `-` privé (préfixe `_`) ; `int?` = `int | None` ; `list~str~` = `list[str]` ;
 `<<module>>` regroupe les fonctions publiques d'un module ; `A --> B : champ` = `A` a un champ annoté
@@ -42,7 +42,7 @@ flowchart TD
     netcross_gtk4 -->|"6 imports"| pcap_parser
     netcross_api -->|"19 imports"| netcross_report
     netcross_api -->|"5 imports"| netcross_ai
-    netcross_api -->|"42 imports"| netcross_core
+    netcross_api -->|"45 imports"| netcross_core
     netcross_api -->|"3 imports"| pcap_parser
     netcross_report -->|"40 imports"| netcross_core
     netcross_ai -->|"10 imports"| netcross_core
@@ -656,6 +656,7 @@ classDiagram
         +load_bpf_filters(path) list~BPFFilter~
         +available_bpf_filters(path) list~BPFFilter~
         +upsert_bpf_filter(new, path) list~BPFFilter~
+        +delete_bpf_filter(name, path) list~BPFFilter~
     }
 
     %% ===== netcross_core.capture_tools =====
@@ -3874,6 +3875,7 @@ classDiagram
 | `netcross_api` | service REST FastAPI pour exposer les analyses Netcross (issue #209). |
 | `netcross_api.app` | application FastAPI pour exposer les analyses Netcross (issues #209, #354, #356). |
 | `netcross_api.batches` | lots de captures de l'API (issue #872). |
+| `netcross_api.bpf_routes` | bibliothèque de filtres BPF enregistrés (issue #906), équivalent API de ``--bpf-library NOM`` et des boutons « Filtres… » / « Enregistrer » de la GUI. |
 | `netcross_api.history_routes` | historique SQLite des runs (issue #874). |
 | `netcross_api.lua_doc_routes` | documentation hors ligne de l'API Lua Wireshark (issue #873), équivalent de ``netcross-lua-doc --json``. |
 | `netcross_api.models` | modèles Pydantic pour les requêtes/réponses API (issue #209). |
@@ -3980,6 +3982,22 @@ classDiagram
         +new_workdir() tuple~str, str~
     }
 
+    %% ===== netcross_api.bpf_routes =====
+    class BPFFilterBody {
+        <<BaseModel>>
+        +str expression
+        +str description
+    }
+    class mod_netcross_api_bpf_routes["netcross_api.bpf_routes"] {
+        <<module>>
+        +filters_path() Path?
+        +list_bpf_filters() dict~str, Any~
+        +put_bpf_filter(nom, body) dict~str, Any~
+        +delete_bpf_filter(nom) dict~str, Any~
+        +resolve_bpf_library(nom) str
+        +register(app, verify) None
+    }
+
     %% ===== netcross_api.history_routes =====
     class mod_netcross_api_history_routes["netcross_api.history_routes"] {
         <<module>>
 
@@ -2131,6 +2131,106 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/HTTPValidationError'
+  /bpf-filters:
+    get:
+      tags:
+      - bpf-filters
+      summary: List Bpf Filters
+      description: Catalogue prédéfini puis filtres enregistrés (la liste de la GUI).
+      operationId: list_bpf_filters_bpf_filters_get
+      responses:
+        '200':
+          description: Successful Response
+          content:
+            application/json:
+              schema:
+                additionalProperties: true
+                type: object
+                title: Response List Bpf Filters Bpf Filters Get
+        '500':
+          description: Fichier de filtres illisible ou non inscriptible (il n'est
+            pas modifié)
+      security:
+      - APIKeyHeader: []
+  /bpf-filters/{nom}:
+    put:
+      tags:
+      - bpf-filters
+      summary: Put Bpf Filter
+      description: Crée ou remplace le filtre ``nom`` ; renvoie la liste à jour.
+      operationId: put_bpf_filter_bpf_filters__nom__put
+      security:
+      - APIKeyHeader: []
+      parameters:
+      - name: nom
+        in: path
+        required: true
+        schema:
+          type: string
+          title: Nom
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/BPFFilterBody'
+      responses:
+        '200':
+          description: Successful Response
+          content:
+            application/json:
+              schema:
+                type: object
+                additionalProperties: true
+                title: Response Put Bpf Filter Bpf Filters  Nom  Put
+        '409':
+          description: Nom réservé au catalogue prédéfini
+        '500':
+          description: Fichier de filtres illisible ou non inscriptible (il n'est
+            pas modifié)
+        '422':
+          description: Validation Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+    delete:
+      tags:
+      - bpf-filters
+      summary: Delete Bpf Filter
+      description: Supprime le filtre enregistré ``nom`` ; renvoie la liste à jour.
+      operationId: delete_bpf_filter_bpf_filters__nom__delete
+      security:
+      - APIKeyHeader: []
+      parameters:
+      - name: nom
+        in: path
+        required: true
+        schema:
+          type: string
+          title: Nom
+      responses:
+        '200':
+          description: Successful Response
+          content:
+            application/json:
+              schema:
+                type: object
+                additionalProperties: true
+                title: Response Delete Bpf Filter Bpf Filters  Nom  Delete
+        '404':
+          description: Filtre enregistré introuvable
+        '409':
+          description: Nom réservé au catalogue prédéfini
+        '500':
+          description: Fichier de filtres illisible ou non inscriptible (il n'est
+            pas modifié)
+        '422':
+          description: Validation Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
 components:
   schemas:
     AnalysisAccepted:
@@ -2221,6 +2321,22 @@ components:
       - analysis_id
       title: AnalysisSummary
       description: Résumé d'une analyse (retourné par POST /captures).
+    BPFFilterBody:
+      properties:
+        expression:
+          type: string
+          title: Expression
+          description: Expression BPF (libpcap), transmise telle quelle à tshark (-f)
+        description:
+          type: string
+          title: Description
+          description: Description libre, facultative
+          default: ''
+      type: object
+      required:
+      - expression
+      title: BPFFilterBody
+      description: Corps de ``PUT /bpf-filters/{nom}``.
     Body_adjust_time_route_tools_adjust_time_post:
       properties:
         file:
 
@@ -16,7 +16,7 @@ ici fait donc échouer la CI.
 |---|---|---|
 | CLI | `cross_capture_analyzer_cli.py` (110 options), `cross_capture_diff_cli.py` (27), `cross_capture_batch_cli.py` (11), `cross_history_cli.py`, `netcross_lua_doc_cli.py`, `netcross_ai_models_cli.py` | Surface de référence : tout y est |
 | GUI | `netcross_gtk4` : 3 pages, 43 cases à cocher, 31 réglages numériques | Analyse interactive et exploration visuelle |
-| API | 41 routes FastAPI | Analyse avec sécurité ; options NAT, TLS, QUIC, anonymisation ; exports texte, PDF, CSV (issue #670) ; options avancées (#672) ; comparaison baseline/courant (#669) ; recherche forensic, extraction, comparaison de postes, NetFlow (#675) |
+| API | 44 routes FastAPI | Analyse avec sécurité ; options NAT, TLS, QUIC, anonymisation ; exports texte, PDF, CSV (issue #670) ; options avancées (#672) ; comparaison baseline/courant (#669) ; recherche forensic, extraction, comparaison de postes, NetFlow (#675) |
 
 
 Légende : **oui** = disponible ; **non** = absent ; **auto** = toujours
@@ -122,7 +122,7 @@ est conservée telle quelle pour les clients existants.
 | Durée maximale | oui | `--live-duration` | non |
 | Arrêt manuel puis analyse | oui (« Arreter et analyser ») | Ctrl+C | non |
 | Rotation de capture (ring buffer) | oui (« Rotation de capture », nombre de fichiers, durée par fichier) : même enregistreur que la CLI, répertoires et fichiers conservés indiqués dans le journal | `--ring-buffer N:SECONDES` : enregistre la capture brute de chaque point en pcapng tournants (ring buffer natif de tshark), incompatible avec `pipe://` (issue #676) | non |
-| Bibliothèque de filtres BPF enregistrés | oui (enregistrer, choisir) | `--bpf-library NOM` (lit `~/.netcross/bpf_filters.json`, issue #676) | non |
+| Bibliothèque de filtres BPF enregistrés | oui (enregistrer, choisir) | `--bpf-library NOM` (lit `~/.netcross/bpf_filters.json`, issue #676) | `GET /bpf-filters`, `PUT /bpf-filters/{nom}`, `DELETE /bpf-filters/{nom}` (même fichier, `$NETCROSS_API_BPF_FILTERS` côté serveur, issue #906) ; champ `bpf_library` par point avec #902 |
 | Rapport HTML rafraîchi en continu | oui (« Rapport HTML en continu », répertoire, intervalle, « Servir la page » et port ; issue #676) | `--live-report`, `--live-report-interval`, `--live-report-serve` | non |
 | Notifications (webhook, Slack, e-mail) | oui (« Notifier si », webhook, Slack, courriel, « Detail complet » ; avec « Rapport de securite », issue #676) | `--notify-on`, `--notify-webhook`, `--notify-slack`, `--notify-email`, `--notify-detail`, `--notify-silence`, `--notify-state` | `notify_on`, `notify_webhook`, `notify_slack`, `notify_email`, `notify_detail` (trace dans `security_report.notifications` de `/report`, URL jamais conservées ; issue #875) |
 
@@ -296,6 +296,9 @@ l'option CLI de même nom) : `nat_tolerant`, `nat_window_ms`, `tls`,
 | `GET /lua-doc/search` | Recherche dans la documentation Lua, `q`, `limit`, `full` (issue #873) |
 | `GET /comparisons/{comparison_id}/redact-map` | Table d'anonymisation commune baseline/courant (issue #876) |
 | `POST /tools/replay` | Rejeu sur une interface autorisée (issue #871) |
+| `GET /bpf-filters` | Bibliothèque de filtres BPF : catalogue puis filtres enregistrés (issue #906) |
+| `PUT /bpf-filters/{nom}` | Crée ou remplace un filtre BPF enregistré, `expression`, `description` (issue #906) |
+| `DELETE /bpf-filters/{nom}` | Supprime un filtre BPF enregistré (issue #906) |
 
 Réglages par variables d'environnement (`NETCROSS_API_TOKEN` pour
 l'en-tête `X-API-Key`, `NETCROSS_MAX_UPLOAD_MB`, `NETCROSS_API_MAX_FILES`,
 
@@ -2828,3 +2828,8 @@ async def get_batch_report(batch_id: str, name: str, _auth: None = Depends(_veri
 from netcross_api import lua_doc_routes as _lua_doc_routes  # noqa: E402
 
 _lua_doc_routes.register(app, _verify_api_key)
+
+# Issue #906 : bibliothèque de filtres BPF (fichier fixé par NETCROSS_API_BPF_FILTERS)
+from netcross_api import bpf_routes as _bpf_routes  # noqa: E402
+
+_bpf_routes.register(app, _verify_api_key)