El módulo de Registros de Auditoría permite a los usuarios administradores de Ubidots llevar un seguimiento de las acciones relevantes dentro de la plataforma. Por ejemplo, si se cambia la descripción de un dispositivo, esa acción queda registrada junto con información importante sobre quién realizó el cambio, cuándo y desde dónde.
Los Registros de Auditoría están divididos en dos pestañas, cada una respondiendo una pregunta diferente:
Eventos: "¿Quién cambió este dispositivo/dashboard/variable, y qué cambió?"
Solicitudes: "¿Qué solicitud HTTP realizó ese cambio, desde qué IP y cómo?"
Los Registros de Auditoría son una excelente herramienta para:
Monitorear y responder a actividades sospechosas.
Detectar y rastrear cambios en entidades clave dentro de tus apps.
Garantizar el cumplimiento de estándares de seguridad y auditoría.
Requisitos
Una cuenta de Ubidots con un plan Enterprise.
1. ¿Cómo funcionan los Registros de Auditoría?
El módulo de Registros de Auditoría rastrea todas las acciones que modifican cualquiera de las entidades monitoreadas (consulta la sección 2):
Creación: Cada vez que se crea una nueva entidad (por ejemplo, un dispositivo o dashboard), se genera un registro. Estas acciones equivalen a métodos HTTP POST.
Actualización o modificación: Si una entidad sufre una modificación total o parcial, esta acción queda registrada. Estas acciones equivalen a métodos HTTP PUT/PATCH.
Eliminación: Cada vez que se elimina una entidad, la acción queda registrada. Estas acciones equivalen a métodos HTTP DELETE.
Además, los inicios de sesión de usuarios finales también se registran.
Notas:
|
2. Entidades monitoreadas
Las acciones realizadas sobre las siguientes entidades generan registros:
Apps
Dashboards
Dispositivos
Grupos de Dispositivos
Tipos de Dispositivos
Eventos
Propiedades Globales
Incidentes
Organizaciones
Páginas
Reportes
Roles
Tokens
Usuarios
Variables
3. Acceder al Módulo de Registros de Auditoría
Ve a tu cuenta de Ubidots, haz clic en tu foto de perfil y luego haz clic en la opción Registros de auditoría:
4. La pestaña Eventos
La pestaña Eventos muestra la actividad del ciclo de vida de las entidades — quién creó, modificó o eliminó un dispositivo, dashboard, variable, incidente, etc.
4.1. Columnas
Cada fila muestra:
Fecha: Cuándo tuvo lugar la acción.
Entidad: El nombre del registro afectado. Si no hay nombre disponible, se muestra el ID del registro. Si la entidad ha sido eliminada desde entonces, se muestra un marcador como "Incidente eliminado".
Evento: Una insignia de color que combina el tipo de entidad y la acción realizada (por ejemplo, "incident: Create" o "dashboard: Update").
Actor: El usuario que realizó la acción. Se muestra como un guion (—) para acciones del sistema o automatizadas.
Origen: Si el evento fue activado por un Servicio (un proceso interno automatizado) o una Solicitud (una llamada HTTP realizada por un usuario).
4.2. Filtrado y búsqueda
Sobre la tabla:
Buscar por ID: Encuentra un evento específico por el ID de la entidad, el actor o la solicitud.
Rango de fechas: Filtra eventos entre dos fechas.
5. La pestaña Solicitudes
La pestaña Solicitudes muestra las llamadas HTTP crudas a la API capturadas por la plataforma — qué endpoint fue llamado, por quién, desde qué IP y con qué resultado.
5.1. Columnas
Cada fila muestra:
Fecha: Cuándo se realizó la solicitud.
Método: El método HTTP utilizado (GET, POST, PUT, PATCH, DELETE).
Host: La dirección del servidor.
Ruta: El endpoint que fue llamado.
Estado: El código de estado HTTP devuelto.
Actor: El usuario que realizó la solicitud.
IP del cliente: La dirección IP desde la que se originó la solicitud.
Nota: No todas las solicitudes se registran. Las solicitudes GET generalmente no se auditan, y los endpoints relacionados con credenciales o ingestión masiva de datos se registran sin almacenar el cuerpo de la solicitud, debido a su sensibilidad y volumen. |
5.2. Filtrado y búsqueda
Sobre la tabla:
Buscar por ID: Encuentra un registro de solicitud específico por el ID del actor o la solicitud.
Rango de fechas: Filtra solicitudes entre dos fechas.
6. Revisar los registros
6.1. Detalles del evento
Haz clic en el valor de Entidad de un evento, o abre el menú de opciones de la fila (⋮) y selecciona Ver detalles, para abrir el panel de detalles del evento. Aquí encontrarás:
Creado el y la insignia del evento.
Entidad: El nombre del registro afectado (o su marcador de eliminación).
Actor y Origen.
Cambios: Una comparación antes/después de los campos que fueron modificados. Los campos agregados se resaltan en verde; en actualizaciones y eliminaciones, los campos eliminados o modificados se resaltan de forma correspondiente.
Objeto: Una sección expandible que muestra los datos completos del estado actual de la entidad, más allá de lo que cambió.
6.2. Detalles de la solicitud
Abre el menú de opciones de una fila de solicitud (⋮) y selecciona Ver detalles para abrir el panel de detalles de la solicitud. Aquí encontrarás:
Creado el, la insignia del Método y una ruta de navegación host → ruta.
Código de Estado.
Detalles: Actor, Host e IP del cliente.
Método de autenticación: Cómo se autenticó la solicitud (por ejemplo, "sesión").
Consulta: Los parámetros de consulta enviados con la solicitud.
Agente de usuario: El navegador o cliente que realizó la solicitud.
Correo electrónico: La dirección de correo del usuario que realizó la solicitud, si aplica.
Payload de la solicitud y Payload de la respuesta: Secciones expandibles que muestran el cuerpo de la solicitud y la respuesta del servidor, incluyendo tamaño y tiempo de respuesta.