Audit log: quién cambió qué y cuándo

Para qué sirve

El audit log muestra quién cambió qué y cuándo. Registra automáticamente cada acción de escritura de la interfaz de administración, de la API pública, del autoservicio de usuarios finales (incluidos los portales de agente y de operadora) y de los trabajos en segundo plano y la cola. Por cada conexión CUCM se añaden los cambios realizados directamente en CUCM.

Lo necesita para rastrear una avería hasta un cambio ("the phone has not been ringing since yesterday"), como prueba para auditorías y protección de datos, y para casos de soporte. Los inicios de sesión en EasyUC también figuran en el log, correctos y fallidos, sin la contraseña. El acceso de solo lectura no se registra; las exportaciones sí.

Cada fila es una acción, por ejemplo la modificación de un dispositivo. Lo que se escribió realmente, como las llamadas AXL individuales a CUCM, se enumera como cambios individuales en la vista de detalle. Nunca se almacenan contraseñas, PIN, claves ni el contenido de las solicitudes.

Requisitos previos

• Rol de página ROLE_APP_VIEW_LOG_PAGE para la entrada de menú y ROLE_APP_LIST_LOG ("Logs: classic list and audit log" en el editor de roles) para la lista y los detalles.
• Para la pestaña Technical y las direcciones IP en la exportación: ROLE_APP_VIEW_AUDIT_TECHNICAL. Asígnelo de forma selectiva por las direcciones IP.
• Para Export y el log de soporte: ROLE_APP_EXPORT_AUDIT.
• Para Settings (retención, fuentes): ROLE_APP_EDIT_AUDIT_SETTINGS.
• Los roles se asignan en el editor de usuarios, en Administration → Access & Appearance → Administrators & Roles, área Logs.
• Los administradores restringidos por ubicación solo ven las entradas de sus ubicaciones y sus propias acciones. No ven entradas sin ubicación.
• Para los cambios realizados directamente en CUCM, el CUCM change log debe estar activado en la conexión CUCM.

Paso a paso: encontrar un cambio

1. Seleccione en la cabecera la conexión CUCM a la que pertenece el objeto.
2. Abra Logs → EasyUC Logs. La página se titula Audit log.
3. Introduzca lo que sepa en el campo de búsqueda: nombre de dispositivo o dirección MAC, número de teléfono, ID de usuario, dirección de correo electrónico o el nombre del actor. Bajo el campo, "Searching as: …" muestra cómo se interpretó la entrada.
4. Haga clic en Search.
5. En Time range, ajuste Today, Last 7 days, Last 30 days o Custom. El valor predeterminado son los últimos 7 días.
6. Utilice Add filter para añadir más filtros: Source, Result, Type of change, Object type, Action, Performed by o Location. Cada filtro aparece como chip y se puede quitar individualmente.
7. Haga clic en la fila de la lista. Se abre el panel lateral Details.
8. En la pestaña Changes, lea Before y After por campo.
9. Abra la pestaña Involved para ver los cambios individuales con resultado y texto de error, y todos los objetos afectados.
10. Si es necesario, haga clic en Show all entries of this operation para ver todos los pasos de la misma acción, incluidos los que continuaron en segundo plano.
11. Load more obtiene coincidencias más antiguas. Reset all filters restablece la vista inicial.

Paso a paso: exportar y crear un log de soporte

1. Ajuste la búsqueda y los filtros de modo que la lista muestre las entradas que desea.
2. Haga clic en Export, arriba a la derecha, y elija Export as CSV o Export as Excel file (XLSX).
3. Si hay más coincidencias de las permitidas, la página ofrece exportar solo las entradas más recientes.
4. Para un caso de soporte: reproduzca el problema y haga clic en Last 5 minutes o Last 10 minutes en el recuadro Download support log. Recibirá como CSV toda la actividad de EasyUC y de CUCM de ese intervalo de tiempo.

Paso a paso: ajustar la retención y las fuentes

1. Haga clic en Settings, arriba a la derecha. Se abre el diálogo Retention and sources.
2. Introduzca los períodos en Keep EasyUC entries (months) y Keep CUCM entries (months).
3. Introduzca el período para las direcciones IP en Remove IP addresses after (days).
4. En Recorded sources, active o desactive Record por fuente.
5. Haga clic en Save. El cambio surte efecto en todos los servicios como máximo a los 30 segundos.

Campos y opciones

Cómo leer la lista y los detalles

Comprobar el resultado y acotar errores

• Pruebe la función con un pequeño cambio propio, como la descripción de un teléfono de prueba. Aparece de inmediato con la fuente Admin UI, su usuario y el campo en Changes.
• No ve ninguna entrada: revise el intervalo de tiempo (predeterminado 7 días), la conexión CUCM de la cabecera y su restricción de ubicación.
• "You do not have permission to view the change log.": falta ROLE_APP_LIST_LOG. Los permisos del widget de logs o del historial del perfil de usuario final no son suficientes.
• "You are not allowed to view technical details.": falta ROLE_APP_VIEW_AUDIT_TECHNICAL.
• "The filter is invalid (…). Please check your input.": corrija el campo de filtro indicado, por ejemplo un intervalo de tiempo superior a 366 días.
• "Too many matches for the export: at most … rows.": acote el filtro o exporte solo las entradas más recientes.
• Un cambio aparece dos veces: una como acción de EasyUC y otra como posible eco de CUCM. Los ecos solo son visibles cuando la opción correspondiente está activada.
• No se muestra ningún usuario en "CUCM direct": el change feed de CUCM no conoce al usuario. El audit log de CUCM lo añade si está activado en la conexión.
• Un trabajo diario en segundo plano elimina las entradas más antiguas según los períodos de retención. Los entornos grandes generan varios GB al año. Vigile el volumen de la base de datos; los períodos de retención son la palanca para ello.
• Si la fuente Admin UI está desactivada, las demás acciones de la interfaz dejan de registrarse. Desactive las fuentes solo de forma deliberada.