Exporter la piste d'audit

Les propriétaires, administrateurs et auditeurs peuvent exporter la piste d'audit à tout moment. Les exports sont destinés aux revues, à la réponse aux incidents et aux auditeurs, ainsi qu'à votre propre SIEM.

Depuis le tableau de bord

Ouvrez Evidence dans l'espace de travail de votre organisation, choisissez la période et les filtres, puis exportez au format CSV ou JSON.

Chaque export figure dans le journal des exports avec sa date, son auteur, ses filtres, le nombre de lignes et le SHA-256 du fichier. Le tableau de bord compare le hachage du fichier reçu à ce journal, afin que vous puissiez montrer à un auditeur qu'un fichier est bien celui produit par zn.

Preuves de l’organisation regroupe dans un seul fichier la piste d'audit de zn-gate et les vérifications cloud des clés API de vos membres, au format OpenTelemetry (OTLP JSON Lines), CSV ou JSON, et ajoute l'export au même journal.

Les exports identifient les personnes par un identifiant de membre opaque (mem_…), jamais par adresse e-mail. Membres indique à qui correspond chaque identifiant.

OpenTelemetry (OTLP JSON Lines)

zn-gate peut aussi écrire la piste sous forme de logs OpenTelemetry : un ExportLogsServiceRequest au format OTLP/JSON par ligne, jusqu'à 500 enregistrements par ligne, une ressource par installation. Sur n'importe quelle machine, sans compte :

zn log export --otlp --since 7d --out zn-audit-7d.otlp.jsonl

C'est le format que lit le récepteur otlpjsonfile de l'OpenTelemetry Collector, et chaque ligne peut aussi être envoyée telle quelle à n'importe quel endpoint OTLP/HTTP POST /v1/logs. Une configuration minimale du Collector (contrib) :

receivers:
  otlpjsonfile: { include: ["./zn-audit-*.otlp.jsonl"], start_at: beginning }
exporters:
  debug: { verbosity: detailed }
service:
  pipelines:
    logs: { receivers: [otlpjsonfile], exporters: [debug] }

Remplacez debug par l'exporteur de votre SIEM.

Chaque enregistrement est un événement zn.gate.decision avec les attributs sémantiques OpenTelemetry lorsqu'ils s'appliquent (gen_ai.agent.name, gen_ai.tool.name, server.address, process.executable.name) et des attributs zn.* pour le reste : la décision et sa raison, le nom et le mode du secret, ainsi que la chaîne d'audit (zn.audit.seq, zn.audit.prev, zn.audit.mac). Un usage soumis à une règle Avertir a la gravité WARN. Jamais de valeurs de secrets.

Les mêmes enregistrements produisent toujours les mêmes octets, donc le même hachage.

Rétention

zn conserve les enregistrements d'audit pendant 180 jours et les preuves cloud pendant 90 jours. Une revue SOC 2 Type II porte généralement sur 12 mois : exportez régulièrement (par exemple chaque mois) et conservez les fichiers avec leurs hachages. Voir SOC 2 et agents de codage IA.

L'envoi direct de la piste vers votre SIEM, une rétention plus longue, SSO et SCIM ne font pas partie de Team v0. Contactez-nous si vous en avez besoin.