feat: #107 configuration - gestion des clés API & MCP (création/révocation, expiration 1j/1mois/6mois/1an/sans fin, une clé pour API REST + serveur MCP, dernière utilisation, store sans secret persisté; fix révocation longue durée) + script token MCP

docs/ROADMAP.md

@@ -1,6 +1,6 @@
 # ObsiGate — Roadmap
 
-> **Version :** 2.14.1 | **Dernière mise à jour :** 2026-09-22
+> **Version :** 2.15.0 | **Dernière mise à jour :** 2026-09-22
 > **Ce fichier ne contient que le travail à venir** (🔵 En cours + ⚪ Backlog) et un index compact
 > vers les fonctionnalités livrées.
 > - **Méthode de livraison à appliquer pour toute tâche : [DELIVERY_WORKFLOW.md](./DELIVERY_WORKFLOW.md)**
@@ -189,6 +189,7 @@
 | 104 | Configuration — Redesign UI de la section « Clés API IA » : recherche fournisseurs, carte défaut 2 colonnes + badges de capacités, cartes dépliables, footer d'actions sticky | 2.12.0 | [features/ai-keys-ui.md](./features/ai-keys-ui.md) |
 | 105 | Guide d'utilisation — audit de couverture complet, téléchargement Markdown/PDF, guide desktop élargi, section Architecture (Mermaid) + BUG-067 | 2.13.0 | [features/guide-coverage-105.md](./features/guide-coverage-105.md) |
 | 106 | Assistant IA — Actions instantanées contextuelles, catalogue « Toutes les actions » & frontmatter complet | 2.14.0 | [features/ai-quick-actions.md](./features/ai-quick-actions.md) |
+| 107 | Configuration — Gestion des clés API & MCP : création/révocation de jetons longue durée (1 j, 1 mois, 6 mois, 1 an, sans fin), une seule clé pour l'API REST et le serveur MCP, « dernière utilisation », store `data/api_tokens.json` sans secret persisté | 2.15.0 | [features/api-mcp-tokens-107.md](./features/api-mcp-tokens-107.md) |
 
 ---
 
@@ -196,7 +197,7 @@
 
 | Priorité | Items | Effort total estimé |
 |---|---|---|
-| ✅ Complété | #1 → #59, #61–72, #74–76, #78–84, #88–93, #94–100, #102–106, #92 | ~115 jours réalisés |
+| ✅ Complété | #1 → #59, #61–72, #74–76, #78–84, #88–93, #94–100, #102–107, #92 | ~116 jours réalisés |
 | 🔵 P2 restant | #77 Desktop : signature de code (non retenue), 6 tests E2E **manuels** ([protocole](./DESKTOP_E2E_CHECKLIST.md)) | ~0,5-1 jour |
 | ⚪ P4 restant | #73 Sync (6-8j) | 6-8 jours |
 | ⚪ P0/P1 restant | #85-87 Refonte architecturale, performance, CI/CD (BUG-035 → BUG-040 corrigés) | ~15-23 jours |

docs/features/api-mcp-tokens-107.md

@@ -0,0 +1,95 @@
+# #107 — Clés API & MCP (panneau de configuration)
+
+**Version : 2.15.0 — statut : complété (septembre 2026)**
+
+## Problème
+
+Pour brancher un client MCP externe (Claude Desktop, Cursor…) ou scripter
+l'API REST, il fallait soit se connecter et voler le JWT de session de 1 h
+dans le navigateur, soit générer un token à la main via `docker exec`
+(`generer_access_token.sh`) — sans expiration maîtrisable ni révocation.
+
+## Décision : une seule clé pour l'API ET le MCP
+
+Le serveur MCP (`/mcp`, `backend/mcp/server.py::_authenticate`) résout
+l'appelant via la même dépendance `get_current_user()` que l'API REST.
+Un jeton HS256 `type=access` authentifie donc **les deux surfaces** — il
+n'y a pas de famille de clés séparée à exposer dans l'UI. C'est dit
+explicitement dans la section (« la même clé fonctionne pour les deux »)
+et verrouillé par tests (REST 200 + MCP initialize 200 avec la même clé ;
+révocation → 401 des deux côtés).
+
+## Conception
+
+### Store — `data/api_tokens.json`
+
+```json
+{"version": 1, "tokens": {"<jti>": {
+  "name": "Claude Desktop", "username": "admin",
+  "created_at": 1790000000, "expires_at": 1792592000,
+  "expiry_key": "30d", "last_used_at": null
+}}}
+```
+
+Le JWT brut n'est **jamais persisté** : affiché une seule fois à la
+création, sinon perdu (pattern GitHub). La révocation fonctionne par
+`jti` : le JWT présenté est rejeté par `is_token_revoked` même s'il est
+encore valide dans sa signature.
+
+### Expirations (choix UI)
+
+| Clé | Durée | `exp` dans le JWT |
+|---|---|---|
+| `1d` | 1 jour | iat + 86 400 |
+| `30d` | 1 mois | iat + 2 592 000 |
+| `180d` | 6 mois | iat + 15 552 000 |
+| `365d` | 1 an | iat + 31 536 000 |
+| `never` | sans fin | **aucun claim exp** |
+
+Plafond : 50 tokens actifs par utilisateur (`API_TOKEN_MAX_PER_USER`).
+
+### Correction induite — révocation longue durée
+
+L'ancien `revoked_tokens.json` bornait toute entrée à 7 jours ; une clé
+1 an révoquée aurait « repris vie » au nettoyage suivant. Le store devient
+un dict `{jti: valid_until}` calé sur l'expiration réelle du jeton
+(« sans fin » → 100 ans). Session tokens inchangés (7 j).
+
+### « Dernière utilisation »
+
+`get_current_user` appelle `maybe_touch_api_token(jti)` pour les jetons
+`api: true` — écriture disque throttlée à 1 h par jti, silencieuse si le
+dossier est en lecture seule ; ne fait jamais échouer une requête.
+
+## Endpoints (`/api/auth`, auth requise, périmètre = l'appelant)
+
+- `GET /api/auth/tokens` → `{tokens: [...], expiry_choices: [...]}`
+- `POST /api/auth/tokens` `{name, expiry}` → `{token, ...record}` (secret unique)
+- `DELETE /api/auth/tokens/{jti}` → révocation immédiate API + MCP
+- Audit : `config_change` / `api_token_create|revoke`.
+
+## UI — panneau Configuration
+
+Nouvelle section `#cfg-tokens` « 🔑 Clés API & MCP » (après Sécurité) :
+liste (badge Active/Expirée, créée/expire/dernière utilisation), champ
+nom + sélecteur d'expiration + Créer, zone secrète en tirets avec Copier,
+bloc « Utilisation » : header `Authorization: Bearer <clé>` + exemple de
+config MCP avec headers sur `<base>/mcp`. 28 clés i18n FR/EN, SW v24.
+
+## Tests — `tests/test_api_tokens.py` (13)
+
+Création/liste (secret jamais restitué), les 5 durées dont l'absence
+d'`exp` pour `never`, expiration invalide → 400, clé identique acceptée
+par REST **et** `/mcp`, refus MCP anonyme, isolation par utilisateur,
+révocation → 401 immédiat des deux côtés, survie de la révocation
+longue durée après reload disque, drapeau `expired`, migration de format
+`revoked_tokens.json`. Suite auth + MCP complète verte (77).
+
+## Config MCP externe (exemple)
+
+```json
+{"mcpServers": {"obsigate": {
+  "url": "http://localhost:2020/mcp",
+  "headers": {"Authorization": "***"}
+}}}
+```