Événements et journal d'audit
Schéma JSON des événements d'usage, chaîne d'intégrité HMAC, journal Windows DLPIA/Security, rétention locale et export SIEM. Aucune valeur sensible n'est jamais écrite.
L'agent produit des événements de métadonnées à chaque requête interceptée vers un service d'IA. Chaque événement décrit l'action sans jamais contenir le contenu du prompt, les valeurs détectées ni le nom de fichier en clair.
Les événements sont stockés dans une base SQLite chiffrée page par page, events.dat, chaînée par empreinte HMAC. Toute suppression ou modification est détectable, y compris par un administrateur local.
Schéma d'un événement d'usage
Chaque requête interceptée produit un événement de type usage. Le corps est un JSON stable, versionné par les versions de politique et de catalogue appliquées.
{
"id": "018f3b2a-7c6d-7e4a-9f12-0a1b2c3d4e5f",
"seq": 48213,
"ts": "2026-10-18T09:42:11.837Z",
"user_sid": "h:7a1c…",
"session_id": "s-42",
"channel": "web",
"service_id": "openai-chat",
"process_image": "msedge.exe",
"process_signer": "Microsoft Corporation",
"request_kind": "prompt",
"size_bytes": 1842,
"file_count": 1,
"file_types": [{ "extension": "pdf", "size": 184320 }],
"entities": {
"pii.email": { "count": 2, "max_score": 9820, "severity": "high", "exposed": 0 },
"pii.iban": { "count": 1, "max_score": 9910, "severity": "high", "exposed": 0 }
},
"outcome": "obfuscated",
"bypass_reason": null,
"bypass_text": null,
"analysis_ms": 54,
"decision_ms": 2180,
"policy_version": "p-2026-10-14",
"catalog_version": "c-2026-10-11",
"model_versions": { "pii": "1.4.2", "health": "0.9.1" },
"prev_hash": "b5e1…",
"hash": "a7c2…"
}Champs du corps d'événement
| Champ | Type | Description |
|---|---|---|
id | UUIDv7 | Identifiant unique de l'événement, trié par ordre temporel. |
seq | entier | Numéro de séquence local, continu sur une chaîne. |
ts | ISO 8601 UTC | Horodatage de production, en millisecondes. |
user_sid | chaîne | SID Windows ; pseudonymisé en h:<hmac> selon la configuration de remontée. |
session_id | chaîne | Session Windows de l'utilisateur. |
channel | énum | Canal : web, desktop, api, code_assistant, internal. |
service_id | chaîne | Identifiant du service d'IA dans le catalogue. |
process_image | chaîne | Nom de l'exécutable d'origine, sans le chemin. |
process_signer | chaîne | Éditeur Authenticode du processus, s'il est signé. |
request_kind | énum | prompt, upload, websocket. |
size_bytes | entier | Taille totale de la requête, en octets. |
file_count | entier | Nombre de fichiers joints. |
file_types | tableau | Pour chaque fichier : extension normalisée et taille. |
entities | objet | Par catégorie détectée : compteur, score maximal, sévérité, nombre exposé. |
outcome | énum | Issue de la requête (voir table dédiée). |
bypass_reason | chaîne | Identifiant du motif choisi par l'utilisateur. |
bypass_text | chaîne | Justification libre, après remplacement des entités (texte déjà caviardé). |
analysis_ms | entier | Durée d'analyse par la bibliothèque de détection. |
decision_ms | entier | Temps écoulé entre l'ouverture de la fenêtre et la décision. |
policy_version | chaîne | Version de politique appliquée. |
catalog_version | chaîne | Version du catalogue appliqué. |
model_versions | objet | Version de chaque modèle BLOB chargé lors de l'analyse. |
prev_hash | chaîne | Empreinte HMAC de l'événement précédent dans la chaîne. |
hash | chaîne | Empreinte HMAC de cet événement, scellant la chaîne. |
Valeurs possibles de outcome
| Valeur | Signification | Requête envoyée ? |
|---|---|---|
clean | Aucune donnée sensible détectée. | Oui |
obfuscated | Entités remplacées par leur libellé. | Oui |
auto_obfuscated | Obfuscation automatique, sans décision utilisateur. | Oui |
edited | Utilisateur a édité manuellement le prompt. | Oui |
bypassed | Envoi en clair après justification de l'utilisateur. | Oui |
cancelled | Requête annulée par l'utilisateur. | Non |
blocked | Politique a bloqué sans option utilisateur. | Non |
timeout | Fenêtre de décision expirée. | Non |
client_aborted | Application cliente a fermé la connexion. | Non |
analysis_failed_open | Analyse impossible, règle fail-open : passage autorisé. | Oui |
analysis_failed_closed | Analyse impossible, règle fail-closed : blocage. | Non |
not_inspectable | Flux non inspectable (épinglage, chiffrement bout en bout). | Oui |
observed | Canal en mode observation : trace sans blocage. | Oui |
remembered | Choix mémorisé réappliqué à l'identique. | Oui / Non |
Autres types d'événements
config_changed— configuration effective modifiée : source, version, liste des chemins modifiés. Aucune valeur.config_rejected— document de configuration ou de catalogue refusé : source et motif.tamper— manipulation détectée : nature (voir table 12.2 de la spec agent), détail court, criticité.lifecycle— démarrage, arrêt, mise à jour, retour en arrière, désinstallation en cours.sync— point d'ancrage de la chaîne d'intégrité envoyé au serveur.data_loss— purge forcée : nombre d'événements perdus et période couverte.
Chaîne d'intégrité HMAC
Chaque événement porte deux empreintes qui lient la base à son passé.
hash = HMAC-SHA-256(
cle_integrite,
prev_hash || canonical_json(event_sans_hash)
)- Clé d'intégrité : clé HMAC-SHA-256 propre au poste, encapsulée par le TPM ou DPAPI machine.
- Chaînage :
prev_hashest l'empreinte de l'événement précédent. Rompre la chaîne est détecté. - Points d'ancrage : toutes les heures et à chaque remontée, une paire
(seq, hash)est signée par la clé du poste et envoyée au serveur. - Vérification : au démarrage et toutes les 24 h, l'agent revérifie la chaîne depuis le dernier ancrage.
Journal Windows DLPIA/Security
L'agent écrit en parallèle du stockage interne un sous-ensemble d'événements dans un canal Windows ETW dédié, DLPIA/Security, déclaré par le manifeste installer/etw/dlpia.man.
- Fournisseur :
DLP-IA-Security· GUID{A7C3D2E1-1F4B-4C8A-9E6D-2B3C4D5E6F70}. - Canal :
DLPIA/Securityde type Admin, valeur 16. - Gabarit : chaque entrée porte un champ
Detaildéjà caviardé et une sévérité métier de 0 (Low) à 3 (Critical). - Les clients collectent le canal avec Windows Event Forwarding, l'agent Microsoft Sentinel ou Splunk Universal Forwarder.
Identifiants d'événement Windows
| ID | Symbole | Niveau | Signification |
|---|---|---|---|
| 1001 | LifecycleStarted | Information | Agent démarré. |
| 1002 | LifecycleStopped | Information | Agent arrêté. |
| 1003 | LifecycleAbnormal | Error | Arrêt anormal détecté. |
| 1004 | LifecycleUpdated | Information | Agent mis à jour. |
| 1005 | LifecycleRolledBack | Warning | Agent revenu à une version antérieure. |
| 1006 | LifecycleUninstall | Information | Désinstallation en cours. |
| 2001 | UsageBypassed | Error | Bypass utilisateur, remonté en moins de 5 s. |
| 2002 | UsageBlocked | Warning | Requête bloquée par politique. |
| 2003 | UsageObfuscated | Information | Requête obfusquée ou éditée. |
| 2004 | UsageCancelled | Information | Requête annulée par l'utilisateur. |
| 3001 | ConfigChanged | Information | Configuration effective modifiée. |
| 3002 | ConfigRejected | Error | Document de configuration ou catalogue rejeté. |
| 4001 | TamperCaRemoved | Critical | CA locale retirée du magasin. |
| 4002 | TamperWfpRemoved | Critical | Filtres WFP retirés. |
| 4003 | TamperDriverUnloaded | Critical | Driver déchargé. |
| 4004 | TamperServiceKilled | Critical | Service arrêté de force. |
| 4005 | TamperExtensionMissing | Critical | Extension navigateur absente. |
| 4006 | TamperBrowserPolicy | Critical | Stratégie navigateur retirée. |
| 4007 | TamperHostsRedirect | Critical | Redirection via le fichier hosts. |
| 4008 | TamperConfigSignature | Critical | Signature de configuration invalide. |
| 4009 | TamperIntegrityChain | Critical | Chaîne d'intégrité rompue. |
| 4010 | TamperBinaryModified | Critical | Binaire de l'agent modifié. |
| 4011 | TamperClockRollback | Critical | Horloge système reculée. |
| 5001 | ModelUnavailable | Warning | Modèle de détection indisponible. |
| 5002 | DataLoss | Error | Événements perdus avant remontée. |
| 5003 | StoreReset | Warning | Base d'événements réinitialisée. |
| 6001 | UnknownAiEndpoint | Information | Point d'accès IA hors catalogue découvert. |
| 7001 | AdminAction | Information | Action d'administration. |
Compilation du manifeste ETW
# Génération de l'en-tête et des ressources de messages (WDK/SDK requis)
mc.exe -um installer\etw\dlpia.man -r installer\etw\gen -h installer\etw\gen
rc.exe installer\etw\gen\dlpia.rc
# Enregistrement du canal (admin ; binaire porteur des ressources)
wevtutil im installer\etw\dlpia.man `
/rf:"%ProgramFiles%\DLP-IA\dlpia-svc.exe" `
/mf:"%ProgramFiles%\DLP-IA\dlpia-svc.exe"Rétention locale
| Limite | Valeur par défaut | Comportement |
|---|---|---|
| Âge | 90 jours | Purge des événements plus anciens, sauf non remontés. |
| Taille | 2 Go | Purge FIFO des plus anciens déjà remontés. |
| Les deux | La première limite atteinte | Déclenche la purge. |
| Non remonté | Préservé | Si la limite de taille force la purge, un événement data_loss est produit. |
Les deux limites sont configurables entre 1 et 3650 jours, et jusqu'à la taille du disque. Les postes à faible stockage réduisent la fenêtre à 30 jours.
Rétention côté serveur
| Type | Par défaut | Plage configurable |
|---|---|---|
| Événements bruts | 365 jours | 1 à 3650 jours |
| Agrégats quotidiens | 1095 jours | 90 à 3650 jours |
| Alertes | 730 jours | 30 à 3650 jours |
| Journal d'audit | 3650 jours | Non réductible |
Export SIEM
Au-delà du canal Windows, l'agent et le serveur peuvent exporter vers un SIEM externe. Le niveau de pseudonymisation configuré s'applique à tous les exports.
| Format | Transport | Source |
|---|---|---|
| Syslog RFC 5424 | TCP TLS, port 6514 | Agent ou serveur. |
| OCSF | JSON sur HTTPS | Serveur, par connecteur. |
| Splunk HEC | HTTPS, en-tête Authorization: Splunk <token> | Serveur. |
| Microsoft Sentinel | Agent Microsoft Monitoring Agent | Agent par le canal ETW. |
| Google Chronicle | JSON sur HTTPS | Serveur, par connecteur. |
{
"time": "2026-10-18T09:42:11.837Z",
"severity": "high",
"activity_name": "ai_prompt_obfuscated",
"class_name": "Data Security Finding",
"category_name": "Findings",
"actor": { "user": { "uid_alt": "h:7a1c…" } },
"process": { "name": "msedge.exe", "publisher": "Microsoft Corporation" },
"network": { "application": "openai-chat", "channel": "web" },
"finding": { "types": ["pii.email", "pii.iban"], "exposed": 0, "count": 3 },
"metadata": { "product": "MaelGard", "version": "2026.10" }
}Pseudonymisation
| Niveau | Identité remontée | Réidentification |
|---|---|---|
| Nominatif | SID, UPN, nom de machine | Directe. |
| Pseudonymisé (défaut recommandé) | HMAC-SHA-256(cle_client, UPN) et idem pour la machine | Seulement par le détenteur de la clé, procédure documentée. |
| Anonyme | Aucune identité, seulement unité organisationnelle ou groupe | Impossible. |
Caviardage des champs texte
- Le champ
bypass_textest fourni par l'utilisateur, mais le service remplace chaque entité détectée avant stockage. - Le champ
Detaildu canal Windows est caviardé par la couche de journalisation : aucune valeur ne traverse. - Les noms de fichiers ne sont jamais écrits : seule l'extension (10 caractères ASCII, à défaut
other) et la taille le sont. - Un test automatisé injecte des valeurs témoins et vérifie leur absence à tous les niveaux de journal,
tracecompris.