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 :
| Famille | Paramètres |
|---|---|
| Canaux | État par canal (inactif, observation, protection) ; ports surveillés ; mode de redirection ; portée du blocage QUIC. |
| Catalogue | Entrées client ; politique pour les applications épinglées ; injection de la CA dans les outils de développement. |
| Catégories | Activation, sévérité, action par défaut, seuil, bypass_allowed, placeholder, correspondance avec les types du moteur. |
| Politiques | Bypass global ; bypass par groupe, canal, service ; motifs de bypass ; longueur de justification ; mémorisation des choix. |
| Analyse | Délais ; taille maximale ; limites d'extraction ; fail-open ou fail-closed par cause et par canal. |
| Interface du poste | Délai de décision ; décision sans utilisateur ; masquage des valeurs ; vues du tableau de bord. |
| Remontée | Serveur ; mode (temps réel, lot, différé) ; fréquence ; pseudonymisation ; destinations SIEM. |
| Administration | Groupe 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.
| Attribut | Type | Description |
|---|---|---|
id | chaîne stable | Clé technique, par exemple pii, health, finance. |
parent | id ou vide | Permet des sous-catégories (pii.national_id). |
enabled | booléen | Catégorie active ou non. |
severity | faible / moyenne / élevée / critique | Ordre d'affichage et fusion des entités. |
default_action | ask, auto_obfuscate, block, log | Décision par défaut appliquée sur le poste. |
threshold | entier 0 à 10 000 | Score minimal pour retenir une entité. |
bypass_allowed | booléen | Contournement autorisé pour cette catégorie. |
placeholder | chaîne | Racine du libellé d'obfuscation, par exemple EMAIL donne [EMAIL_1]. |
engine_types | liste | Types d'entités du moteur rattachés. |
models | liste | Modèles de détection requis. |
| Action | Effet | Fenêtre affichée |
|---|---|---|
block | Requête rejetée sans choix possible. | Non — notification uniquement. |
ask | Requête retenue, obfuscation présélectionnée. | Oui. |
auto_obfuscate | Obfuscation appliquée sans intervention. | Non — notification discrète. |
log | Requê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èle | Langues | Catégories couvertes | État |
|---|---|---|---|
pii-baseline | fr, en | PII (nom, adresse, téléphone, courriel, identifiants nationaux), IBAN, cartes bancaires. | Disponible. |
secrets-baseline | agnostique | Clés d'API, jetons, mots de passe, clés privées, chaînes de connexion. | Disponible. |
pii-advanced | fr, en | Santé, 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.
- 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.
- Simulation (facultatif) : calcul du nombre de postes et de personnes concernés, aperçu de la configuration résultante, test sur un texte fictif.
- Soumettre à la revue : le brouillon n'est plus modifiable. Une autre personne reçoit la notification de relecture.
- Approuver ou Rejeter : par une autre personne que l'auteur, dotée du rôle requis par le contenu du brouillon.
- 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 brouillon | Rôle relecteur requis |
|---|---|
| Paramètres de vie privée seulement | DPO |
| Autres paramètres, catalogue client | Administrateur sécurité |
| Brouillon mélangeant les deux | Une 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
| Situation | Diagnostic |
|---|---|
| Agent qui refuse la politique | Vérifiez la signature avec la clé ConfigPublicKey et les événements de configuration dans la fiche du poste. |
| Surcharge sans effet | Un 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'utilisateur | Au 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 absente | L'approbation d'une réidentification exige sync.pseudonymization_key dans la politique publiée. |
| Modèle non chargé par un poste | Le 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. |