DocumentationPolitique et catalogue

Politique et catalogue

Politique et catalogue

Format de la politique MaelGard, catalogue des services d'IA, catégories de données, modèles de détection, revue à deux yeux et publication signée.

La politique MaelGard est la configuration appliquée par les agents des postes. Elle décrit l'état des canaux (observation, protection), les catégories de données surveillées, les règles d'obfuscation, de blocage et de contournement, ainsi que les surcharges par groupe, canal ou service.

Elle est produite dans la console, relue par une autre personne, puis publiée sous forme de document JSON signé (JWS Ed25519). Les agents vérifient la signature avant d'appliquer la configuration.

1. Format d'une politique

Une politique est un document JSON structuré. Les sections principales sont les paramètres (settings), les surcharges (overrides), le catalogue client (catalog_client), les catégories (categories) et les règles de contournement (bypass_rules).

{
  "settings": {
    "channels.web.state": "protection",
    "channels.desktop.state": "protection",
    "channels.api.state": "observation",
    "channels.code.state": "protection",
    "policy.bypass.global": false,
    "interception.monitored_ports": [80, 443, 8443],
    "sync.server_url": "https://maelgard.example",
    "sync.tenant_id": "acme",
    "sync.pseudonymization_key": "<clé Ed25519 base64>"
  },
  "overrides": [
    {
      "scope": { "group": "legal" },
      "settings": { "categories.health.threshold": 5000 }
    },
    {
      "scope": { "channel": "api", "service": "azure-openai-corp" },
      "settings": { "policy.bypass.global": true }
    }
  ],
  "catalog_client": [
    {
      "id": "assistant-interne",
      "domains": ["ai.acme.example"],
      "channels": ["web", "api"],
      "min_agent_version": "1.4.0"
    }
  ],
  "categories": [
    {
      "id": "pii",
      "severity": "high",
      "default_action": "ask",
      "threshold": 7000,
      "bypass_allowed": true,
      "placeholder": "PII"
    }
  ]
}

2. Paramètres (settings)

Les paramètres sont des chemins pointés avec une valeur typée. Un paramètre absent prend la valeur par défaut de l'éditeur. Les principales familles :

FamilleParamètres
CanauxÉtat par canal (inactif, observation, protection) ; ports surveillés ; mode de redirection ; portée du blocage QUIC.
CatalogueEntrées client ; politique pour les applications épinglées ; injection de la CA dans les outils de développement.
CatégoriesActivation, sévérité, action par défaut, seuil, bypass_allowed, placeholder, correspondance avec les types du moteur.
PolitiquesBypass global ; bypass par groupe, canal, service ; motifs de bypass ; longueur de justification ; mémorisation des choix.
AnalyseDélais ; taille maximale ; limites d'extraction ; fail-open ou fail-closed par cause et par canal.
Interface du posteDélai de décision ; décision sans utilisateur ; masquage des valeurs ; vues du tableau de bord.
RemontéeServeur ; mode (temps réel, lot, différé) ; fréquence ; pseudonymisation ; destinations SIEM.
AdministrationGroupe des administrateurs locaux ; paramètres modifiables localement ; jeton de désinstallation.

Un paramètre marqué « verrouillé » dans la politique ne peut pas être changé par une surcharge, et aucune source de priorité inférieure ne peut le modifier (serveur central, configuration locale, défauts éditeur).

3. Surcharges (overrides)

Les surcharges adaptent des paramètres à un sous-ensemble du parc : un groupe de postes, un groupe d'utilisateurs, un canal ou un service. Elles portent sur les mêmes clés que les paramètres globaux.

Résolution : en cas de surcharges multiples, la plus spécifique l'emporte, dans l'ordre service > canal > groupe d'utilisateurs > groupe de postes > défaut. À spécificité égale, la plus restrictive l'emporte.

{
  "overrides": [
    { "scope": { "group": "soc" },      "settings": { "policy.bypass.global": true } },
    { "scope": { "channel": "web" },    "settings": { "channels.web.state": "protection" } },
    { "scope": { "service": "chatgpt" }, "settings": { "categories.secrets.default_action": "block" } }
  ]
}

4. Catalogue : éditeur et client

Catalogue éditeur

Le catalogue éditeur est fourni par MaelGard et mis à jour par les paquets signés de l'éditeur. Il décrit les services d'IA publics reconnus (ChatGPT, Claude, Gemini, Mistral, Copilot), leurs domaines, chemins d'accès et format de corps. Il est en lecture seule dans la console.

Catalogue client

Le catalogue client ajoute vos propres services : outil interne, instance Azure OpenAI du client, service non référencé. Chaque entrée déclare :

  • identifiant stable (clé technique) ;
  • canaux concernés (web, application de bureau, API, outil de code) ;
  • domaines (hôtes et chemins d'accès facultatifs) ;
  • chemins d'extraction JSONPath pour isoler les champs à analyser dans la requête ;
  • version minimale de l'agent requise pour appliquer la règle.

Le catalogue client suit le même cycle de revue que la politique. Il est publié avec elle, signé, puis distribué aux agents.

5. Catégories de données

Les catégories regroupent les types d'entités renvoyés par le moteur. Quand une requête contient plusieurs catégories, la décision applique la règle la plus restrictive, et le bypass n'est proposé que si toutes les catégories détectées l'autorisent.

Attributs d'une catégorie.
AttributTypeDescription
idchaîne stableClé technique, par exemple pii, health, finance.
parentid ou videPermet des sous-catégories (pii.national_id).
enabledbooléenCatégorie active ou non.
severityfaible / moyenne / élevée / critiqueOrdre d'affichage et fusion des entités.
default_actionask, auto_obfuscate, block, logDécision par défaut appliquée sur le poste.
thresholdentier 0 à 10 000Score minimal pour retenir une entité.
bypass_allowedbooléenContournement autorisé pour cette catégorie.
placeholderchaîneRacine du libellé d'obfuscation, par exemple EMAIL donne [EMAIL_1].
engine_typeslisteTypes d'entités du moteur rattachés.
modelslisteModèles de détection requis.
Actions par défaut.
ActionEffetFenêtre affichée
blockRequête rejetée sans choix possible.Non — notification uniquement.
askRequête retenue, obfuscation présélectionnée.Oui.
auto_obfuscateObfuscation appliquée sans intervention.Non — notification discrète.
logRequête envoyée telle quelle, événement créé.Non.

Un canal en observation force l'action log quelle que soit la catégorie. L'action effective d'une interception est la plus restrictive des catégories détectées, dans l'ordre block > ask > auto_obfuscate > log.

6. Modèles de détection

Les modèles de détection sont des bibliothèques signées, chargées par les agents selon la configuration. Un modèle listé dans le catalogue n'est pas forcément chargé par chaque poste : la sélection dépend des catégories actives et de la langue.

Modèles disponibles.
ModèleLanguesCatégories couvertesÉtat
pii-baselinefr, enPII (nom, adresse, téléphone, courriel, identifiants nationaux), IBAN, cartes bancaires.Disponible.
secrets-baselineagnostiqueClés d'API, jetons, mots de passe, clés privées, chaînes de connexion.Disponible.
pii-advancedfr, enSanté, RH, juridique, confidentiel entreprise, infrastructure interne.Bientôt.

7. Règles de contournement (bypass)

Le contournement n'est proposé à l'utilisateur que si les quatre conditions suivantes sont réunies : bypass global autorisé, autorisé pour chaque catégorie détectée, autorisé pour l'utilisateur ou son groupe, autorisé pour le canal et le service d'IA.

{
  "bypass_rules": {
    "global": false,
    "require_justification": true,
    "min_justification_length": 20,
    "allowed_reasons": [
      "donnee_publique",
      "test_sans_donnee_reelle",
      "accord_metier"
    ],
    "memory": { "scope": "session", "allow_bypass_memory": false }
  }
}

La mémorisation d'un choix d'obfuscation porte sur le couple (empreinte de la valeur, service d'IA). La mémorisation d'un contournement est un réglage distinct, désactivé par défaut.

8. Cycle Brouillon → Publication

Chaque modification de politique suit un cycle à quatre étapes : Brouillon · En revue · Approuvé · Publié. Un brouillon peut aussi être Rejeté ; le motif est transmis à l'auteur.

  1. Brouillon : l'administrateur sécurité (ou le DPO pour les paramètres de vie privée) édite les paramètres, les surcharges et le catalogue client. Enregistrer n'applique rien.
  2. Simulation (facultatif) : calcul du nombre de postes et de personnes concernés, aperçu de la configuration résultante, test sur un texte fictif.
  3. Soumettre à la revue : le brouillon n'est plus modifiable. Une autre personne reçoit la notification de relecture.
  4. Approuver ou Rejeter : par une autre personne que l'auteur, dotée du rôle requis par le contenu du brouillon.
  5. Publier : la configuration est signée par la clé du client, puis notifiée aux agents concernés.

9. Revue à deux yeux

La revue à deux yeux impose qu'une personne distincte de l'auteur approuve la publication. Le relecteur doit avoir le rôle qui correspond au contenu du brouillon.

Contenu du brouillonRôle relecteur requis
Paramètres de vie privée seulementDPO
Autres paramètres, catalogue clientAdministrateur sécurité
Brouillon mélangeant les deuxUne seule personne cumulant les deux rôles

10. Signature et vérification côté agent

La politique publiée est signée par la clé du client (Ed25519) dans une enveloppe JWS compacte. L'agent la vérifie à la réception avec la clé publique ConfigPublicKey fournie à l'installation (propriété MSI, stratégie Windows, ou paramètre d'installeur Linux).

  • La rotation de la clé de signature se fait par un document signé avec l'ancienne clé (rotation chaînée).
  • Une politique mal signée ou invalide est rejetée en bloc. L'agent conserve la configuration précédente et crée un événement de configuration.
  • Chaque configuration appliquée est versionnée par empreinte. L'agent remonte cette empreinte au serveur, qui l'affiche sur la fiche du poste.
  • Les changements s'appliquent sans redémarrage du service ni de la session, à l'exception du mode de redirection du driver, qui prend effet à la connexion suivante.

11. Erreurs courantes et diagnostic

SituationDiagnostic
Agent qui refuse la politiqueVérifiez la signature avec la clé ConfigPublicKey et les événements de configuration dans la fiche du poste.
Surcharge sans effetUn paramètre verrouillé par la politique globale ne peut pas être surchargé. Déverrouillez-le ou rapprochez-vous de l'auteur du verrou.
Bypass refusé par l'utilisateurAu moins une catégorie détectée interdit le contournement, ou le canal / service / groupe ne l'autorise pas. Consultez le détail de l'événement.
Clé de pseudonymisation absenteL'approbation d'une réidentification exige sync.pseudonymization_key dans la politique publiée.
Modèle non chargé par un posteLe modèle n'est chargé que si la catégorie correspondante est active et la langue déclarée. Vérifiez la fiche du poste.