Concepts
Les notions clés pour lire la console et les événements : point de contrôle, 4 issues, catalogue, canaux, catégories, politiques.
Cette page définit le vocabulaire employé partout dans MaelGard. Chaque terme est stable d'un écran à l'autre. Un même mot renvoie toujours à la même notion dans la console, l'agent et les exports.
Point de contrôle
Le point de contrôle est le proxy TLS local de l'agent. Il reçoit le trafic redirigé par le driver, décide si le flux concerne un service d'IA actif, et applique la politique. Il reste sur le poste.
- Il n'ouvre jamais un flux dont le domaine n'est pas au catalogue.
- Il émet des certificats feuilles à la volée, signés par une CA locale propre au poste.
- Il relaie les réponses sans mise en mémoire tampon ni analyse.
- Il écrit un événement signé pour chaque interception.
Les 4 issues d'une requête
Toute requête destinée à un service d'IA actif aboutit à l'une des quatre issues suivantes. Les noms sont fixes dans la console, les événements et les exports.
| Issue | Effet sur la requête | Fenêtre affichée |
|---|---|---|
| Passe | Envoyée telle quelle, aucune donnée sensible détectée au-dessus du seuil. | Non |
| Masquée | Les valeurs détectées sont remplacées par des libellés comme [EMAIL_1] ou [IBAN_1]. | Non, sauf si la politique l'exige |
| Décision | La requête est retenue. L'utilisateur choisit entre obfusquer, modifier, envoyer sans protection ou annuler. | Oui |
| Bloquée | La requête est rejetée. L'utilisateur reçoit une notification. | Non |
Catalogue des services d'IA
Le catalogue liste les services d'IA reconnus par l'agent. Chaque entrée décrit le domaine, les chemins, le canal et la règle d'extraction des champs de prompt. Il est signé par l'éditeur.
- Catalogue éditeur : liste publiée par MaelGard, signée en Ed25519. L'agent vérifie la signature avant chargement.
- Catalogue local : complément propre au client pour les IA internes et les API privées. Signé par la clé du tenant.
- Fusion : les deux catalogues sont fusionnés sur le poste. En cas de conflit sur une entrée, le catalogue local l'emporte.
- Mises à jour : poussées par le serveur ou par un CDN éditeur, selon la configuration.
Canaux
Un canal désigne une famille d'usage. Chaque canal s'active séparément par politique. Un canal inactif n'est pas déchiffré. Un canal en observation est analysé mais aucune requête n'est retenue.
| Canal | Règle | Exemples |
|---|---|---|
| Interface web | Processus navigateur signé + domaine marqué web | chatgpt.com, claude.ai, gemini.google.com |
| Application desktop | Processus identifié par le catalogue | ChatGPT Desktop, Claude Desktop, Copilot |
| API directe | Domaine marqué API, processus hors navigateur et hors IDE | api.openai.com, api.anthropic.com |
| Assistant de code | Processus IDE connu ou domaine marqué code | VS Code, Visual Studio, JetBrains, Cursor |
| IA interne | Domaine ou IP déclaré par le client | Passerelle LLM interne, Ollama en interne |
Catégories de détection
Une catégorie regroupe les types d'entités que le moteur sait repérer : identifiants, données bancaires, données techniques. Chaque catégorie porte une sévérité, un seuil et une action par défaut.
| Catégorie | Édition | Sévérité |
|---|---|---|
| Données personnelles (PII) | Essentiel | Élevée |
| Santé | Advanced | Critique |
| Finance | Advanced | Élevée |
| RH et juridique | Advanced | Élevée |
| Secrets techniques | Advanced | Critique |
| Infrastructure | Advanced | Moyenne |
Politique et actions
Chaque catégorie porte une action par défaut. L'action effective d'une interception est la plus restrictive des catégories détectées.
| Action | Effet | Fenêtre |
|---|---|---|
log | Envoi sans modification, événement créé | Non |
auto_obfuscate | Obfuscation appliquée sans intervention | Non, notification discrète |
ask | Requête retenue, choix utilisateur | Oui |
block | Requête rejetée sans choix | Non |
Ordre de priorité des surcharges
Une politique s'applique par défaut à tous les postes. Des surcharges ciblent un groupe, un canal ou un service. En cas de superposition, la plus spécifique l'emporte : service, canal, groupe utilisateur, groupe machine, défaut.
Exceptions et mémorisation
- Exceptions : liste blanche par valeur précise, motif, service d'IA approuvé, processus, utilisateur ou groupe.
- Empreintes : les valeurs en liste blanche sont stockées sous forme d'empreinte HMAC, jamais en clair.
- Mémorisation : l'utilisateur peut cocher mémoriser ce choix. La portée est définie par l'administrateur, de la session Windows à N jours.
- Expiration : chaque exception porte une date d'expiration facultative et un auteur.