Auditoría
El Registro de auditoría es un historial cronológico de todas las operaciones realizadas en la plataforma. Permite saber quién hizo qué, cuándo y desde dónde, lo que facilita la detección de cambios no autorizados, la resolución de incidencias y el cumplimiento de políticas de seguridad.
Accede desde Configuración → Auditoría.
Cada institución solo puede ver los registros generados dentro de su propia cuenta. Los datos de otras instituciones nunca son visibles.
Qué se registra
Automáticamente
Toda operación de escritura exitosa que pase por la API registra un evento de forma automática. Esto incluye creaciones, ediciones y eliminaciones de cualquier recurso (usuarios, grupos, cursos, calificaciones, pagos, etc.).
De forma explícita
Algunas acciones no son simples escrituras HTTP y se registran manualmente en la lógica de negocio:
| Acción | Ejemplo |
|---|---|
| LOGIN / LOGOUT | Inicio y cierre de sesión |
| ENROLL | Inscripción de un alumno a un grupo |
| EXPORT | Descarga de reportes o datos |
| UPLOAD | Subida de archivos o importaciones masivas |
Tabla de registros
Cada fila representa un evento y muestra:
| Columna | Contenido |
|---|---|
| Fecha | Fecha y hora exacta del evento (DD/MM/AA HH:mm:ss) |
| Usuario | Nombre completo y correo del usuario que realizó la acción |
| Acción | Tipo de operación, con etiqueta de color |
| Módulo | Área del sistema afectada (ej. users, courses, finance) |
| Recurso | Entidad específica afectada y su identificador (ej. user #42) |
| Endpoint | Método HTTP y ruta de la API que se llamó |
| Status | Código de respuesta HTTP |
| IP | Dirección IP desde la que se originó la solicitud |
| 👁 | Botón para ver el detalle del evento (solo aparece si hay datos adicionales) |
Colores de acción
| Acción | Color |
|---|---|
| CREATE | 🟢 Verde |
| UPDATE | 🔵 Azul |
| DELETE | 🔴 Rojo |
| LOGIN | 🟣 Morado |
| LOGOUT | ⬜ Gris |
| ENROLL | 🩵 Cian |
| EXPORT | 🟠 Naranja |
| UPLOAD | 🟡 Dorado |
Colores de status HTTP
| Rango | Color | Significado |
|---|---|---|
| 2xx | 🟢 Verde | Éxito |
| 4xx | 🟠 Naranja | Error del cliente |
| 5xx | 🔴 Rojo | Error del servidor |
Filtros
Puedes combinar los siguientes filtros para acotar los resultados. La tabla se actualiza automáticamente al cambiar cualquier filtro.
| Filtro | Descripción |
|---|---|
| Acción | Filtra por tipo de operación (CREATE, UPDATE, DELETE, etc.) |
| Módulo | Filtra por área del sistema. Las opciones se generan dinámicamente a partir de los registros visibles |
| Recurso | Filtra por entidad afectada |
| Rango de fechas | Muestra solo los eventos dentro de un intervalo de días |
El botón Actualizar recarga la tabla con los filtros actuales sin cambiar la página.
Detalle del evento
Cuando un evento tiene información adicional, aparece el ícono 👁 al final de la fila. Al hacer clic se abre un modal con dos secciones:
Metadata
Información de contexto del evento. Por ejemplo, en un ENROLL puede incluir el número de alumnos inscritos; en un EXPORT, la cantidad de filas exportadas.
{
"count": 15,
"plan": "Primer semestre"
}
Cambios
Desglose campo a campo de qué se modificó, con el valor anterior y el nuevo. Solo aparece en eventos UPDATE y operaciones similares.
{
"rol": { "from": "alumno", "to": "profesor" },
"activo": { "from": false, "to": true }
}
Exportar a CSV
Da clic en Exportar CSV para descargar los registros actualmente filtrados en un archivo compatible con Excel y Google Sheets.
- El nombre del archivo incluye la fecha de descarga:
audit-log-YYYY-MM-DD.csv - Se exportan hasta 10 000 registros por descarga
- Los filtros activos en pantalla se aplican también a la exportación
- El CSV incluye todas las columnas visibles más metadata y cambios completos
Para exportar un periodo específico combina el filtro de Rango de fechas antes de descargar.