Registros de acceso
En esta página
La pestaña Registros de acceso es el registro de auditoría: cada intento de desbloqueo (correcto, denegado o fallido; desde la aplicación móvil o por un administrador) se registra con quién, qué puerta, cuándo, desde dónde y el resultado. Esta página trata cómo leer el registro, cómo filtrarlo, la vista No visit recorded, la exportación a CSV y la vista de detalles del evento.
Figura 1: La pestaña Registros de acceso
Los eventos se conservan durante aproximadamente 13 meses y luego se eliminan automáticamente. Eliminar un usuario no elimina sus eventos: el historial se conserva para el registro de auditoría.
Los Registros de acceso son independientes de los Registros de auditoría, que registran las solicitudes realizadas en todo el Performance Hub.
Filtrar y buscar
Figura 2: Búsqueda, etiquetas de filtro, columnas, exportación, actualización en vivo e intervalo
| Control | Qué hace |
|---|---|
| Search | "Search door, person, event ID…": busca coincidencias en la puerta, la persona, el ID del evento, el ID del comando, el estado y el motivo de denegación |
| View | Door events (el registro de auditoría) o No visit recorded (consulta más abajo) |
| State, Result, Door, Source, Partner, Reason | Etiquetas de filtro que acotan la lista por estado del evento, resultado, puerta, origen de la solicitud, socio de integración y motivo de denegación |
| Columns | Elige qué columnas muestra la tabla; el botón indica cuántas están activadas |
| Exportar CSV | Descarga los eventos filtrados en ese momento (consulta Exportar a CSV) |
| Live | Actualiza la lista automáticamente, con una cuenta regresiva hasta la siguiente actualización; el botón de al lado la actualiza en ese momento |
| Range | Last day, Last 7 days, Last 30 days, Last 90 days o fechas personalizadas |
El encabezado muestra el número de eventos del intervalo y los filtros actuales. Cada intervalo carga hasta los 500 eventos más recientes.
Estados de los eventos
| Etiqueta de estado | Significado |
|---|---|
| Confirmed unlocked | El controlador de la puerta confirmó que el relé se liberó: la puerta se desbloqueó realmente |
| Unlocked | Se informó que el desbloqueo fue correcto |
| Admin Unlocked | Un administrador activó el desbloqueo desde el Performance Hub (anulación de administrador). Se registra en cuanto se envía el comando |
| Denied | La solicitud se rechazó; consulta la columna Reason (todos los motivos) |
| Pending / Request received | La solicitud todavía se está procesando (es transitorio; normalmente se resuelve en pocos segundos) |
| Timed out | El comando de desbloqueo se envió, pero el controlador no lo confirmó a tiempo; normalmente se debe a problemas de conectividad en la puerta |
| Failed | No se pudo completar el desbloqueo debido a un error |
| Locked by staff | El personal usó Lock now mientras la programación de desbloqueo automático mantenía la puerta abierta. Es un evento de la programación, no un intento de desbloqueo |
| Schedule resumed | La programación de desbloqueo automático volvió a tomar el control, ya sea en su siguiente cambio o porque el personal presionó Resume schedule. Es un evento de la programación, no un intento de desbloqueo |
Cada fila muestra la marca de tiempo, el estado, la puerta, la persona, la distancia a la puerta y la latencia del comando (cuando está disponible), y el motivo de denegación en los eventos denegados.
Sin visita registrada
Figura 3: La vista No visit recorded
Define View en No visit recorded para ver las Access Time Windows puntuales, agregadas por un administrador o una integración, en las que la persona nunca desbloqueó una puerta durante el período (incluido cualquier período de gracia). Columnas: Person, Scheduled period, Source / partner, Status. Los registros se conservan durante unos 13 meses.
Por ejemplo, una oficina puede ver qué contratistas con un período puntual nunca se presentaron.
Atribución de Access Policies
Los eventos autorizados por una política identifican la política por su nombre, y la audiencia, el destino y la programación que coincidieron. Las coincidencias programadas también pueden incluir el inicio y el fin concretos activos.
Las Access Time Windows propiedad de administradores y de integraciones conservan sus propias rutas de atribución (admin_time_window y source_time_window); no se vuelven a etiquetar como Access Policies. Las denegaciones por política distinguen entre discrepancias de destino, de audiencia y de programación inactiva. Una próxima ocurrencia usa outside_access_time_window con la disponibilidad estructurada cuando se conoce.
Detalles del evento
Haz clic en cualquier fila para abrir el cuadro de diálogo Access Details.
Figura 4: El cuadro de diálogo Access Details de un desbloqueo realizado por un miembro
El encabezado muestra la puerta, su ubicación, el resultado, una insignia Admin override cuando corresponde y el motivo de denegación si se denegó. Campos que se muestran cuando están disponibles:
| Campo | Notas |
|---|---|
| Date / Time | Cuándo se produjo el intento |
| Coordinates | La ubicación que informó el teléfono, con la precisión del GPS (±N m); se puede copiar |
| Door / Gate | Nombre y ubicación de la puerta |
| Person o Admin | Quién lo intentó; los desbloqueos de administrador muestran la cuenta del administrador |
| Device | El teléfono o dispositivo usado |
| IP Address | La IP que hizo la solicitud; se puede copiar |
| Hold time | Cuánto tiempo permaneció desbloqueada la puerta |
| Distance from door | La distancia calculada desde el centro de la geofence |
| Event ID / Command ID | Identificadores que se pueden copiar para escalar el caso al equipo de soporte |
| Latency | Cuánto tardó el controlador en responder al comando |
| Authorization source | Access Policy, concesión permanente, período de administrador o período de integración |
| Policy | ID o nombre de la política más la audiencia, el destino (puerta o Alcance de acceso) y el modo Anytime/Scheduled que coincidieron |
| Window / Source ID | Atribución acotada para los períodos programados o de origen activos |
| Active from / to | La ocurrencia concreta, en segundos Unix, que se usó para decidir sobre un período; el fin no está incluido |
Unlock Location sitúa las coordenadas informadas en un mapa con un enlace Open in Google Maps. Cuando no hay coordenadas, verás "No location captured — unlocked from the Performance Hub." (anulaciones de administrador) o "No location data was reported for this unlock attempt."
Exportar a CSV
Haz clic en Exportar CSV para descargar los eventos filtrados en ese momento. El archivo incluye campos de identidad, puerta, resultado, denegación, controlador, integración y atribución de política o período. El botón está deshabilitado cuando la lista filtrada está vacía. En la vista No visit recorded, Exportar CSV descarga esa lista.
Consejos
- La tarjeta Recent activity de la pestaña Doors es un acceso directo a las últimas 24 horas de este registro: al hacer clic en un evento ahí, se abre directamente aquí.
- ¿Estás investigando la queja de un miembro? Usa la etiqueta State o Result para mostrar los intentos denegados, busca su nombre y lee el motivo; luego, consulta Solución de problemas para ver la solución de cada motivo.
- Para las quejas relacionadas con políticas, confirma el nombre de la política y su Who/Where/When. Para los períodos de integración, revisa también la antigüedad del origen y la asignación de
scope_key. - Una serie de eventos Timed out en una puerta suele significar que el controlador de esa puerta tiene problemas de red; revisa su estado en la pestaña Doors.
- Tu Agente de IA puede leer los eventos de las puertas a través de MCP, por ejemplo para una bienvenida a cada visitante en el vestíbulo de una oficina. Los eventos de las puertas incluyen un ID de usuario, no un nombre ni una fecha de nacimiento.
Páginas relacionadas
- Referencia: todos los estados y motivos de denegación
- Programaciones de Access Policies
- Solución de problemas
- Doors