DocumentationConcepts

Concepts

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.

Les quatre issues possibles d'une requête.
IssueEffet sur la requêteFenêtre affichée
PasseEnvoyée telle quelle, aucune donnée sensible détectée au-dessus du seuil.Non
MasquéeLes 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écisionLa requête est retenue. L'utilisateur choisit entre obfusquer, modifier, envoyer sans protection ou annuler.Oui
BloquéeLa 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.

Les cinq canaux pris en charge et leur règle de classement.
CanalRègleExemples
Interface webProcessus navigateur signé + domaine marqué webchatgpt.com, claude.ai, gemini.google.com
Application desktopProcessus identifié par le catalogueChatGPT Desktop, Claude Desktop, Copilot
API directeDomaine marqué API, processus hors navigateur et hors IDEapi.openai.com, api.anthropic.com
Assistant de codeProcessus IDE connu ou domaine marqué codeVS Code, Visual Studio, JetBrains, Cursor
IA interneDomaine ou IP déclaré par le clientPasserelle 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égories livrées et sévérité proposée par défaut.
CatégorieÉditionSévérité
Données personnelles (PII)EssentielÉlevée
SantéAdvancedCritique
FinanceAdvancedÉlevée
RH et juridiqueAdvancedÉlevée
Secrets techniquesAdvancedCritique
InfrastructureAdvancedMoyenne

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.

Actions possibles pour une catégorie.
ActionEffetFenêtre
logEnvoi sans modification, événement crééNon
auto_obfuscateObfuscation appliquée sans interventionNon, notification discrète
askRequête retenue, choix utilisateurOui
blockRequête rejetée sans choixNon

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.