# Auditoría

## Para qué sirve

La pantalla **Auditoría** junta en una sola lista los cambios que se hicieron en Lymen: quién lo hizo, qué hizo, sobre qué y cuándo. Por ejemplo: quién invitó a una persona, quién cambió el valor de una credencial del [Llavero](https://lymen.app/docs/operacion/llavero/), quién desplegó una versión de Procesamiento o quién pausó una regla.

Es **solo lectura**: nadie puede cambiar ni borrar estos registros desde el portal.

La abrís desde el menú: **Auditoría**, en el grupo **Administración**.

## Cuándo usarla

- Algo dejó de funcionar y querés saber qué se cambió antes.
- Necesitás responder a un control interno o externo: quién tuvo acceso, quién cambió una configuración, quién usó una credencial.
- Querés revisar lo que hizo una persona antes de cambiarle los permisos.
- Para guardar una copia: la lista se exporta a CSV.

## Quién puede verla

Hace falta el permiso **Ver** del área **Auditoría**. Lo traen los roles de fábrica **Administrador** y **Auditor**. Si armás un rol propio, marcá **Ver** en **Auditoría** (ver [Usuarios y roles](https://lymen.app/docs/operacion/usuarios-y-roles/)). Sin ese permiso, la opción no aparece en el menú.

## Qué muestra cada movimiento

| Columna | Qué dice |
|---|---|
| **Cuándo** | Fecha y hora, y hace cuánto fue. |
| **Quién** | El nombre de la persona y su correo. Si no lo hizo una persona, dice de dónde vino (ver abajo). |
| **Qué** | La acción ("Creó", "Cambió el valor", "Invitó a un usuario"…) y el área de Lymen donde pasó. |
| **Sobre qué** | El objeto: una credencial, una regla, un servidor, un rol, un dashboard… |
| **Resultado** | Solo en algunos movimientos: si una consulta salió bien o con error, si una credencial se entregó o se rechazó, si un alta de servidor se rechazó. |

Debajo de quién aparece el **origen**:

| Origen | Qué significa |
|---|---|
| **Portal** | Lo hizo una persona desde el portal. |
| **Agente** | Lo informó un agente o el instalador de un servidor (por ejemplo, un alta rechazada). Si se conoce, se muestra desde qué dirección IP. |
| **Automático** | Lo hizo Lymen solo: una automatización programada, el ajuste de la retención a tu plan, un aviso de límite. |
| **Consola del servidor** | Lo hizo alguien con acceso al servidor de Lymen, fuera del portal (por ejemplo, recuperar el acceso de administrador). |

Con **Ver detalle** se abre lo que cambió: el antes y el después, la versión, la nota que se dejó. Si un movimiento no tiene detalle, no aparece el botón.

## Lo que nunca se muestra

En la auditoría **nunca** aparecen los valores de las credenciales del Llavero, contraseñas, tokens, claves, encabezados de autorización ni direcciones de webhooks que llevan la clave adentro. Del Llavero queda registrado **quién** creó, editó, usó o cambió el valor de una credencial y **cuándo**, pero nunca el valor.

Si algún dato tiene forma de secreto, en el detalle aparece como **oculto**. Las direcciones web se muestran sin usuario, sin clave y sin lo que va después del `?`.

## Filtrar, paso a paso

1. Elegí el rango con **Desde** y **Hasta**. Al entrar, la pantalla muestra los **últimos 30 días**. Si dejás un campo vacío, no hay límite de ese lado.
2. Si buscás lo que hizo alguien, elegilo en **Persona**.
3. Si te interesa una sola parte de Lymen, elegila en **Área**.
4. En **Buscar** escribí parte de la acción, del nombre de la persona o del objeto (por ejemplo "Slack" o "editar").
5. La lista se actualiza sola. Al final, **Ver más movimientos** trae los siguientes.

| Campo | Qué hace | Impacto |
|---|---|---|
| Desde | Primer día que se muestra (desde las 00:00). | Un rango más corto carga más rápido. |
| Hasta | Último día que se muestra (hasta las 23:59). | No puede ser anterior a **Desde**: si pasa, la pantalla lo avisa y no busca. |
| Persona | Solo lo que hizo esa persona (o ese origen, como **consola** o **agente**). | La lista de personas muestra a quienes hicieron algo hace poco. |
| Área | Solo los movimientos de esa parte de Lymen. | "Consultas ejecutadas" junta cada consulta que se corrió en dashboards y en Explorar. |
| Buscar | Busca en la acción, la persona y el objeto. | No busca dentro del detalle. |

## Exportar a CSV

Tocá **Exportar CSV** (arriba a la derecha). Se baja un archivo con **los mismos filtros** que tenés en pantalla, con una fila por movimiento y una columna con el detalle (también sin secretos). Se abre bien en Excel y en cualquier planilla.

Se exportan hasta **10.000 movimientos** por archivo. Si hay más, la última línea lo avisa: acotá el rango de fechas y exportá por partes.

## Qué queda registrado

| Área | Qué se registra |
|---|---|
| Usuarios y Roles | Invitaciones, cambios de nombre, de estado y de roles, bajas, creación, cambios y borrado de roles, recuperación del administrador. También cada vez que alguien conecta o desconecta un [asistente de IA](https://lymen.app/docs/operacion/asistentes-de-ia/), con token o con login, con el nombre de la conexión (en las de login, el nombre del asistente) y nunca el token. |
| Plan y consumo | Adicionales contratados, límites alcanzados y ajustes de la retención al plan. |
| Llavero | Crear, editar, cambiar el valor, borrar, cada uso de una credencial por una automatización (entregada o rechazada), rotación de la clave y retiro de la clave de un gateway. |
| Servidores, agentes y gateways | Códigos de alta, altas y altas rechazadas, revocaciones, gateways activados o apagados, chequeos lanzados, cambios de listas, de configuración de Kubernetes y de logs a recibir. |
| Monitoreo profundo | Activar, pausar o reiniciar la instrumentación de una aplicación. |
| Procesamiento | Versiones guardadas, despliegues, borradores descartados y pasos aplicados o probados. |
| Almacenamiento | Cambios de buckets, de retención y del plan de almacenamiento. |
| Reglas de captura, Aplicaciones y privacidad, Etiquetas, Perfil de negocio | Altas, cambios y bajas. |
| Reglas y anomalías, A quién avisar, Mantenimiento, Objetivos (SLO) | Altas, cambios y bajas. |
| Flujos y automatizaciones | Crear, editar, activar, pausar, restaurar, borrar y ejecutar. |
| Dashboards | Guardar, migrar consultas y subir imágenes. |
| Consultas ejecutadas | Cada consulta que se corrió, cuánto tardó y si dio error. Incluye las que hace un asistente de IA en nombre de una persona. |
| Equipos de red | Altas, cambios, bajas y descubrimientos. |

## Problemas comunes

| Problema | Qué hacer |
|---|---|
| No veo la opción **Auditoría** en el menú. | Tu rol no tiene **Ver** en **Auditoría**. Pedíselo a quien administra los usuarios. |
| "No hay movimientos con estos filtros". | Ampliá el rango de fechas o sacá el filtro de persona o de área. |
| Una persona aparece con su correo y sin nombre. | Esa persona ya no es usuaria de tu organización o hizo el cambio con otra cuenta. El registro se conserva igual. |
| En **Sobre qué** veo un código en vez de un nombre. | Es el identificador del objeto (por ejemplo, de un servidor). Abrí **Ver detalle** para más datos. |
| Veo "oculto" en el detalle. | Es a propósito: ese dato era una credencial, una clave o algo con forma de secreto. |
| El CSV termina con un aviso de 10.000 filas. | Exportá por partes con rangos de fechas más cortos. |
