Exportar el registro de auditoría

Los propietarios, administradores y auditores pueden exportar el registro de auditoría en cualquier momento. Las exportaciones están pensadas para revisiones, respuesta a incidentes y auditores, y para tu propio SIEM.

Desde el panel

Abre Evidence en el espacio de trabajo de tu organización, elige el periodo y los filtros, y exporta como CSV o JSON.

Cada exportación aparece en el registro de exportaciones con su fecha, autor, filtros, número de filas y el SHA-256 del archivo. El panel compara el hash del archivo recibido con ese registro, de modo que puedes demostrar a un auditor que el archivo es el que generó zn.

Evidencia de la organización reúne en un solo archivo el registro de auditoría de zn-gate y las comprobaciones en la nube de las API keys de tus miembros, en formato OpenTelemetry (OTLP JSON Lines), CSV o JSON, y se añade al mismo registro de exportaciones.

Las exportaciones identifican a las personas mediante un id de miembro opaco (mem_…), nunca por correo electrónico. Miembros muestra a qué persona corresponde cada id.

OpenTelemetry (OTLP JSON Lines)

zn-gate también puede escribir el registro como logs de OpenTelemetry: un ExportLogsServiceRequest en OTLP/JSON por línea, hasta 500 registros por línea, un recurso por instalación. En cualquier máquina, sin cuenta:

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

Es el formato que lee el receptor otlpjsonfile del OpenTelemetry Collector, y cada línea también puede enviarse tal cual a cualquier endpoint OTLP/HTTP POST /v1/logs. Una configuración mínima del Collector (contrib):

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

Sustituye debug por el exportador de tu SIEM.

Cada registro es un evento zn.gate.decision con atributos semánticos de OpenTelemetry donde corresponden (gen_ai.agent.name, gen_ai.tool.name, server.address, process.executable.name) y atributos zn.* para el resto: la decisión y su motivo, el nombre y el modo del secreto, y la cadena de auditoría (zn.audit.seq, zn.audit.prev, zn.audit.mac). Un uso con una regla Avisar tiene la gravedad WARN. Nunca incluye valores de secretos.

Los mismos registros siempre producen los mismos bytes, y por tanto el mismo hash.

Retención

zn conserva los registros de auditoría durante 180 días y las evidencias de la nube durante 90 días. Una revisión SOC 2 Type II suele abarcar 12 meses: exporta con regularidad (por ejemplo, mensualmente) y guarda los archivos junto con sus hashes. Consulta SOC 2 y agentes de programación con IA.

Enviar el registro directamente a tu SIEM, una retención más larga, SSO y SCIM no forman parte de Team v0. Contáctanos si los necesitas.