Filtrar e investigar
Usa los filtros de los registros de auditoría para encontrar los eventos que necesitas, con recetas para las investigaciones más habituales.
En esta página
- Los filtros
- Recetas
- ¿Quién cambió el rol o el estado de alguien?
- ¿Alguien intenta entrar en una cuenta?
- ¿Qué ha cambiado en los ajustes de seguridad?
- ¿Quién recibió acceso a una aplicación?
- ¿Cuándo se usó por última vez una integración?
- ¿Qué pasó durante un incidente?
- Para desarrolladores: leer los registros de auditoría a través de la API
Una organización con mucha actividad registra muchos eventos al día. Los filtros de la parte superior de la página Registros de auditoría reducen la lista a lo que buscas.
Los filtros
| Filtro | Qué conserva |
|---|---|
| Tipo de actor | Usuario: acciones realizadas por personas y usuarios de servicio. Sistema: acciones que BreezeAuth realizó por su cuenta. |
| Tipo de evento | Un tipo de evento, como Error de autenticación del usuario. La lista está en orden alfabético: escribe unas letras para buscar. |
| Usuario | Los eventos sobre un usuario de tu organización. Busca por nombre o correo. |
| Grupo | Los eventos sobre un grupo, como sus cambios y los miembros añadidos o quitados. |
Para quitar un filtro, bórralo con la × del campo.
Cuando usas varios filtros, un evento debe cumplirlos todos. Por ejemplo, Tipo de evento Usuario de la organización actualizado y Usuario “Ana Souza” muestra solo los cambios realizados en el usuario de Ana.
Importante: el filtro Usuario encuentra los eventos sobre el usuario seleccionado, no los eventos que ese usuario realizó. Para revisar lo que hizo un administrador, filtra por Tipo de evento y fíjate en la columna Actor.
Los filtros forman parte de la dirección de la página. Para compartir una investigación con un compañero que también pueda ver los registros de auditoría, copia la dirección del navegador: verá la misma lista filtrada.
Recetas
¿Quién cambió el rol o el estado de alguien?
- En Usuario, elige a la persona.
- En Tipo de evento, elige Usuario de la organización actualizado.
- Pasa el ratón por el icono de documento de cada entrada para ver los cambios, como
adminRoleostatus, y revisa la columna Actor para ver quién los hizo.
¿Alguien intenta entrar en una cuenta?
- En Tipo de evento, elige Error de autenticación del usuario.
- Si quieres, elige a la persona en Usuario.
- Fíjate en las columnas Dirección IP y Fecha. Muchos errores en poco tiempo, o desde una dirección desconocida, merecen atención.
Si parece un ataque, finaliza las sesiones del usuario y plantéate restringir el acceso por red o por país. Los errores de inicio de sesión solo se registran para los usuarios gestionados.
¿Qué ha cambiado en los ajustes de seguridad?
- En Tipo de evento, elige Organización actualizada.
- Pasa el ratón por el icono de documento para ver qué ajustes cambiaron, como
mfaEnforced,minimumPasswordLengthoapplicationsAccessLocked.
¿Quién recibió acceso a una aplicación?
En Tipo de evento, elige Asignación de aplicación creada para los accesos dados a usuarios concretos, o Asignación de aplicación al grupo creada para los accesos dados a grupos. La columna Entidad / Recurso muestra la aplicación y el usuario o el grupo.
¿Cuándo se usó por última vez una integración?
En Tipo de evento, elige Credencial de usuario de servicio utilizada. Cada entrada es una credencial usada para obtener un token de acceso, con el usuario de servicio en la columna Entidad / Recurso y la dirección IP de la integración.
¿Qué pasó durante un incidente?
Filtra por Tipo de actor Usuario y recorre los eventos del periodo, del más antiguo al más reciente, buscando actores y direcciones IP inesperados. Después, revisa las propias acciones de respuesta a incidentes, como Todas las sesiones activas de la organización finalizadas o Actualización de contraseña exigida a todos. Consulta Respuesta a incidentes.
Para desarrolladores: leer los registros de auditoría a través de la API
Para exportar los registros de auditoría a tu propio sistema de registros, SIEM o cumplimiento, léelos a través de la API de BreezeAuth con un usuario de servicio que tenga el rol Auditor:
curl -G "https://api.breezeauth.com/organizations/$ORGANIZATIONS_UUID/audit-events" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
--data-urlencode "page=0" \
--data-urlencode "pageSize=50" \
--data-urlencode "sort=createdAt,desc" \
--data-urlencode 'filter={"type":"FilterItem","field":"eventType","operator":"FILTER_OPERATOR_EQUAL","value":"USER_LOGIN_FAILED"}'
pageempieza en0. El campometade la respuesta indica el número total de registros.filteres opcional. Puedes filtrar poreventTypeyactorType(conFILTER_OPERATOR_EQUAL, oFILTER_OPERATOR_INy una lista separada por comas), y porapplicationsUuid,usersUuid,membershipsUuidogroupsUuid(conFILTER_OPERATOR_EQUAL). Para combinar condiciones, agrúpalas en{"type":"FilterOperator","operator":"AND","filterItems":[…]}.- Los tipos de evento usan sus nombres técnicos, como
MEMBERSHIP_UPDATEDoUSER_LOGIN_FAILED. Están en el catálogo de eventos.
Para reaccionar a los cambios en cuanto ocurren, en lugar de leer el historial, usa webhooks.
Última actualización: 13 de octubre de 2026