Skip to main content

Documentation Index

Fetch the complete documentation index at: https://woku.app/docs/llms.txt

Use this file to discover all available pages before exploring further.

Cada empresa en Woku tiene un registro de auditoría propio que captura todas las acciones críticas ejecutadas por sus usuarios.

​
Acceder al registro

  1. En admin.woku.app, ve a Empresa → Registro de auditoría.
  2. Verás una tabla paginada (25 entradas por página) con las acciones más recientes arriba.

​
Qué eventos quedan registrados

CategoríaEventos registrados
Autenticaciónauth.login, auth.logout, auth.lockout, auth.unlock, auth.session.revoke, auth.mfa.enroll.start, auth.mfa.enroll.confirm, auth.mfa.verify, auth.mfa.disable, auth.mfa.backup-codes.regenerate
Empresacompany.create, company.update, company.add-admin, company.remove-member
Usuariouser.create, user.update-name, user.update-email, user.password-recover
Wokuwoku.create, woku.update, woku.delete, woku.close
Formularioform.create, form.update, form.delete
Cada entrada incluye:
  • Fecha/hora exacta (ISO 8601 con milisegundos).
  • Acción (uno de los códigos de arriba).
  • Recurso afectado y su ID cuando aplica.
  • Actor: email del usuario que ejecutó la acción (cuando hay sesión autenticada).
  • IP del request (extraída de x-forwarded-for o IP directa).

​
Filtrar

La barra de filtros permite combinar:
  • Acción (texto exacto, por ejemplo auth.login).
  • Recurso (texto exacto, por ejemplo user o woku).
  • Email del actor.
  • Rango de fechas (Desde / Hasta, ambas opcionales).
Haz clic en Aplicar para refrescar la tabla con los filtros. Limpiar vuelve al estado sin filtros.

​
Exportar a CSV

El botón Exportar CSV descarga todas las entradas que coinciden con los filtros actuales (la paginación se ignora; siempre exporta el match completo). El archivo se llama audit-log-YYYY-MM-DD.csv y contiene las columnas: 
timestamp,action,resource,resourceId,actorEmail,actorId,companyId,ip,userAgent
Las comillas, comas y saltos de línea se escapan según RFC 4180.

​
Retención

  • Default: 365 días. Pasada esa fecha, MongoDB elimina las entradas vía un TTL index per-documento (expireAt).
  • Configurable per-empresa: una mejora pendiente expondrá el ajuste en la UI de Settings. Por ahora la retención se puede customizar contactando a soporte.

​
Garantías

  • Audit fire-and-forget: el registro de un evento NUNCA bloquea ni revierte la acción auditada. Si la base de auditoría está caída, la acción sigue su curso y el fallo se loguea internamente.
  • Aislamiento per-empresa: el filtro companyId siempre se aplica en queries del UI. No hay manera de listar acciones de otra empresa.
  • Inmutable: las entradas no se editan ni se borran a mano. Solo expiran por TTL.