DocumentationÉvénements et journal d'audit

Événements et journal d'audit

É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

Champs d'un événement d'usage (spec agent 9.4).
ChampTypeDescription
idUUIDv7Identifiant unique de l'événement, trié par ordre temporel.
seqentierNuméro de séquence local, continu sur une chaîne.
tsISO 8601 UTCHorodatage de production, en millisecondes.
user_sidchaîneSID Windows ; pseudonymisé en h:<hmac> selon la configuration de remontée.
session_idchaîneSession Windows de l'utilisateur.
channelénumCanal : web, desktop, api, code_assistant, internal.
service_idchaîneIdentifiant du service d'IA dans le catalogue.
process_imagechaîneNom de l'exécutable d'origine, sans le chemin.
process_signerchaîneÉditeur Authenticode du processus, s'il est signé.
request_kindénumprompt, upload, websocket.
size_bytesentierTaille totale de la requête, en octets.
file_countentierNombre de fichiers joints.
file_typestableauPour chaque fichier : extension normalisée et taille.
entitiesobjetPar catégorie détectée : compteur, score maximal, sévérité, nombre exposé.
outcomeénumIssue de la requête (voir table dédiée).
bypass_reasonchaîneIdentifiant du motif choisi par l'utilisateur.
bypass_textchaîneJustification libre, après remplacement des entités (texte déjà caviardé).
analysis_msentierDurée d'analyse par la bibliothèque de détection.
decision_msentierTemps écoulé entre l'ouverture de la fenêtre et la décision.
policy_versionchaîneVersion de politique appliquée.
catalog_versionchaîneVersion du catalogue appliqué.
model_versionsobjetVersion de chaque modèle BLOB chargé lors de l'analyse.
prev_hashchaîneEmpreinte HMAC de l'événement précédent dans la chaîne.
hashchaîneEmpreinte HMAC de cet événement, scellant la chaîne.

Valeurs possibles de outcome

Issues de requête — valeurs du champ outcome.
ValeurSignificationRequête envoyée ?
cleanAucune donnée sensible détectée.Oui
obfuscatedEntités remplacées par leur libellé.Oui
auto_obfuscatedObfuscation automatique, sans décision utilisateur.Oui
editedUtilisateur a édité manuellement le prompt.Oui
bypassedEnvoi en clair après justification de l'utilisateur.Oui
cancelledRequête annulée par l'utilisateur.Non
blockedPolitique a bloqué sans option utilisateur.Non
timeoutFenêtre de décision expirée.Non
client_abortedApplication cliente a fermé la connexion.Non
analysis_failed_openAnalyse impossible, règle fail-open : passage autorisé.Oui
analysis_failed_closedAnalyse impossible, règle fail-closed : blocage.Non
not_inspectableFlux non inspectable (épinglage, chiffrement bout en bout).Oui
observedCanal en mode observation : trace sans blocage.Oui
rememberedChoix 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_hash est 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/Security de type Admin, valeur 16.
  • Gabarit : chaque entrée porte un champ Detail dé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

Mappage événement métier vers identifiant Windows (crates/dlpia-log/src/eventlog.rs).
IDSymboleNiveauSignification
1001LifecycleStartedInformationAgent démarré.
1002LifecycleStoppedInformationAgent arrêté.
1003LifecycleAbnormalErrorArrêt anormal détecté.
1004LifecycleUpdatedInformationAgent mis à jour.
1005LifecycleRolledBackWarningAgent revenu à une version antérieure.
1006LifecycleUninstallInformationDésinstallation en cours.
2001UsageBypassedErrorBypass utilisateur, remonté en moins de 5 s.
2002UsageBlockedWarningRequête bloquée par politique.
2003UsageObfuscatedInformationRequête obfusquée ou éditée.
2004UsageCancelledInformationRequête annulée par l'utilisateur.
3001ConfigChangedInformationConfiguration effective modifiée.
3002ConfigRejectedErrorDocument de configuration ou catalogue rejeté.
4001TamperCaRemovedCriticalCA locale retirée du magasin.
4002TamperWfpRemovedCriticalFiltres WFP retirés.
4003TamperDriverUnloadedCriticalDriver déchargé.
4004TamperServiceKilledCriticalService arrêté de force.
4005TamperExtensionMissingCriticalExtension navigateur absente.
4006TamperBrowserPolicyCriticalStratégie navigateur retirée.
4007TamperHostsRedirectCriticalRedirection via le fichier hosts.
4008TamperConfigSignatureCriticalSignature de configuration invalide.
4009TamperIntegrityChainCriticalChaîne d'intégrité rompue.
4010TamperBinaryModifiedCriticalBinaire de l'agent modifié.
4011TamperClockRollbackCriticalHorloge système reculée.
5001ModelUnavailableWarningModèle de détection indisponible.
5002DataLossErrorÉvénements perdus avant remontée.
5003StoreResetWarningBase d'événements réinitialisée.
6001UnknownAiEndpointInformationPoint d'accès IA hors catalogue découvert.
7001AdminActionInformationAction 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

Rétention et purge des événements sur le poste.
LimiteValeur par défautComportement
Âge90 joursPurge des événements plus anciens, sauf non remontés.
Taille2 GoPurge FIFO des plus anciens déjà remontés.
Les deuxLa première limite atteinteDé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

Rétention sur le serveur d'agrégation.
TypePar défautPlage configurable
Événements bruts365 jours1 à 3650 jours
Agrégats quotidiens1095 jours90 à 3650 jours
Alertes730 jours30 à 3650 jours
Journal d'audit3650 joursNon 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.

Formats d'export SIEM disponibles.
FormatTransportSource
Syslog RFC 5424TCP TLS, port 6514Agent ou serveur.
OCSFJSON sur HTTPSServeur, par connecteur.
Splunk HECHTTPS, en-tête Authorization: Splunk <token>Serveur.
Microsoft SentinelAgent Microsoft Monitoring AgentAgent par le canal ETW.
Google ChronicleJSON sur HTTPSServeur, 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

Niveaux de pseudonymisation à la remontée.
NiveauIdentité remontéeRéidentification
NominatifSID, UPN, nom de machineDirecte.
Pseudonymisé (défaut recommandé)HMAC-SHA-256(cle_client, UPN) et idem pour la machineSeulement par le détenteur de la clé, procédure documentée.
AnonymeAucune identité, seulement unité organisationnelle ou groupeImpossible.

Caviardage des champs texte

  • Le champ bypass_text est fourni par l'utilisateur, mais le service remplace chaque entité détectée avant stockage.
  • Le champ Detail du 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, trace compris.