Registros de auditoría

Quién puede hacerlo: admins de empresa
Qué planes: plan Enterprise
Qué plataformas: Navegador

Los registros de auditoría permiten a los admins de la organización con los privilegios correspondientes rastrear la actividad de los usuarios en su organización de Miro. Los registros son extremadamente útiles para investigar un problema o para obtener un informe detallado de eventos importantes (por ejemplo, cambios en la configuración de seguridad global, invitaciones de nuevos usuarios o la creación de nuevos tableros).

✏️ Actualmente, los eventos se registran desde el momento de la creación de la suscripción Enterprise y se almacenan por defecto durante 180 días:
a) Si mejoras a Enterprise desde otro plan, los eventos se registrarán desde el momento de la mejora.
b) Si migras algunos equipos a la suscripción Enterprise, sus datos se registrarán solo cuando formen parte de la suscripción.

Acceder a los registros de auditoría

Para acceder a los registros de auditoría, haz lo siguiente:

1. Ve a Configuración de la empresa.
2. En el panel izquierdo, haz clic en Seguridad > Registros de auditoría.
3. Puedes filtrar los registros de auditoría eligiendo un Rango de fechas, uno o más Actores (incluidas aplicaciones y agentes de IA que actúen en nombre de un usuario), una o más Categorías de eventos, uno o más Eventos específicos y uno o más Objetos afectados.

Haz clic en el botón Ver eventos para previsualizar los eventos que coinciden con tus criterios de filtrado. La hora se muestra en formato ISO 8601, en la zona horaria local. Puedes ver los detalles de un evento en particular haciendo clic en los tres puntos de la columna Detalles.

✏️ Puedes previsualizar eventos hasta donde alcance el periodo de retención de registros de auditoría de tu organización (hasta 365 días).

Exportar registros de auditoría

Puedes exportar los registros en formato de archivo CSV.

En el archivo de exportación CSV, la fecha y la hora del evento se proporcionan en formato ISO 8601, zona horaria UTC. No hay límite en la cantidad de registros que se pueden exportar a la vez; sin embargo, mientras más datos exportes, más tiempo tomará preparar el archivo para descargar. Ten en cuenta también que las aplicaciones más populares para trabajar con tablas tienen límites respecto al volumen de datos que pueden abrir. El archivo exportado refleja los filtros que hayas aplicado, incluido el objeto afectado.

Para exportar los registros, haz clic en el botón Exportar a CSV.

La barra con los detalles de tu archivo de exportación aparecerá abajo. Cuando el archivo esté listo para descargar, puedes hacer clic en el botón Descargar CSV. El archivo estará disponible para descargar durante 24 horas.

✏️ Actualmente, por organización solo hay un archivo de exportación disponible para descargar a la vez. Al hacer clic en el botón Exportar a CSV, se reemplazará el archivo de exportación actual.

Acceder a los registros de auditoría mediante la API

Los administradores pueden usar la Audit Log API o las integraciones SIEM compatibles para acceder y recopilar de forma programática los datos del registro de auditoría.

La API admite los mismos filtros que la interfaz: Actor, categoría de evento, Evento y Objeto afectado; cada uno acepta múltiples valores. Los administradores pueden recuperar el historial completo de registros de auditoría de su organización mediante la API.

Retiro de Audit Logs API v1

La Audit Logs API v1 ha sido retirada. Si tienes una integración personalizada basada en v1 (GET /v1/audit/logs), migra esa integración a v2 (GET /v2/audit/logs). La autenticación y los parámetros de la ventana temporal no han cambiado, pero la paginación, el formato de la respuesta y algunos nombres de campos son distintos; consulta la referencia de la API para más detalles. Si usas una aplicación proporcionada por Miro o un conector del Marketplace (por ejemplo, la app de Miro para Splunk o Microsoft Sentinel), actualiza la app o el conector a la versión más reciente, que ya es compatible con v2.

Cambios notables en la respuesta de v2:

• La paginación es por cursor (un valor de cursor opaco) en lugar de basada en offset; no hay un recuento total de registros.
• createdBy.id se devuelve como una cadena (antes era un número).
• Cada evento incluye un campo de primer nivel category.
• Los ID de eventos son cadenas UUID (antes tenían un sufijo numérico); trátalos como valores opacos.
• createdAt refleja cuándo se almacenó el evento en lugar de cuándo ocurrió exactamente la acción (normalmente con un retraso de unos segundos).
• Los campos details usan camelCase (p. ej. organizationId), los valores numéricos grandes se serializan como cadenas, las marcas de tiempo usan ISO 8601 y las claves con valores nulos se omiten.
• Para acciones realizadas por una app, una integración o un agente de IA en nombre de un usuario, el objeto actor incluye el campo onBehalfOf que identifica a ese usuario.
• El nombre del actor para los visitantes que no han iniciado sesión ahora es "Visitante" (antes "Invitado").
• Los eventos relacionados con tableros hacen referencia al boardKey público del tablero en lugar de un ID numérico interno.
• Los tipos de eventos y las categorías que referenciaban "project" ahora usan "space" (por ejemplo, project_created ahora es space_created); esto se aplica retroactivamente a los eventos históricos recuperados vía v2.

Eliminar registros de auditoría

Los administradores pueden establecer una política de retención para los registros de auditoría. Puedes elegir entre 30, 90, 180 o 365 días.

⚠️ Una vez que se eliminan los registros de auditoría, no se pueden recuperar.

✏️ La retención indefinida para los registros de auditoría ha quedado obsoleta.

Para establecer un período de eliminación, haz lo siguiente:

1. Ve a Configuración de la empresa.
2. En el panel izquierdo, haz clic en Seguridad > Registros de auditoría.
3. En Registros de auditoría, haz clic en la pestaña Configuración.
4. Elige una opción de la lista desplegable. Se te pedirá que confirmes tu elección.

Eventos en los Registros de auditoría

Los registros de auditoría incluyen entradas sobre las siguientes categorías de eventos:

Preguntas frecuentes