Leer el registro de auditoría¶

El registro de auditoría de tu organización guarda cada cambio en sus personas, grupos, roles, atributos, reglas, invitaciones y ajustes. Esta página muestra cómo leerlo y filtrarlo. Qué contiene y qué no está en Roles y acceso.

Leer el registro de auditoría puede hacerlo org-admin o auditor. Aún no tiene pantalla en OS: lo lees mediante la API. Los ejemplos usan $OS, $TOKEN y $ORG como en Administrar grupos.

Leer el registro¶

curl -s "$OS/api/v1/organisations/$ORG/audit-events?limit=100" \
    -H "Authorization: Bearer $TOKEN"

OS devuelve las filas de la más antigua a la más reciente, en páginas de como máximo 200 (por defecto 50). Pasa next_cursor como cursor para la página siguiente. Una fila tiene este aspecto:

{"id": 4182, "at": "2026-10-17T09:12:00Z", "request_id": "...",
 "actor_membership_id": "mem_...", "actor_organisation_id": "org_...",
 "event": "role.assigned", "kind": "role", "thing_id": "ras_...",
 "changes": {"role": [null, "people-admin"], "reach": [null, "organisation"],
             "member_id": [null, "mem_..."]},
 "allowed_actions": ["see"]}

Campo	Significado
`at`, `request_id`	cuándo, y la solicitud que hizo el cambio
`actor_membership_id`	quién: una membresía, o `system` para lo que hizo OS por sí mismo
`actor_organisation_id`	desde qué organización: la tuya, o una superior si actuó un socio o un operador
`event`	qué ocurrió, como `<tipo>.<verbo>`
`kind`, `thing_id`	sobre qué ocurrió
`changes`	cada campo registrado que cambió, como `[antes, después]`

Filtrar¶

Añade uno o más filtros a la consulta:

event=membership.deactivated: solo este evento;
kind=group: solo cambios en un tipo de cosa;
actor=mem_...: solo lo que hizo una persona.

curl -s "$OS/api/v1/organisations/$ORG/audit-events?event=rule.replaced" \
    -H "Authorization: Bearer $TOKEN"

Qué eventos hay¶

Evento	Qué queda registrado
`group.created`, `group.changed`, `group.deleted`	nombre y etiquetas; al eliminar, cuántos miembros tenía el grupo
`group.member_added`, `group.member_removed`	el grupo y el miembro
`role.created`, `role.changed`, `role.deleted`	nombre, etiquetas y reglas; al eliminar, cuántas concesiones se fueron con él
`role.assigned`, `role.unassigned`	el rol, el alcance, y el miembro o el grupo
`attribute.defined`, `attribute.changed`, `attribute.deleted`	nombre, valores permitidos y `multiple`; al eliminar, cuántos valores se fueron con él
`attribute.value_assigned`, `attribute.value_removed`	el atributo, el valor, y el miembro o el grupo
`rule.replaced`	las reglas
`membership.deactivated`, `membership.reactivated`, `membership.removed`	el estado
`membership.profile_changed`	cuáles de nombre y teléfono cambió un administrador, nunca los valores
`membership.rows_removed`	cuántos roles, grupos y valores desaparecieron cuando OS limpió a un miembro eliminado
`invitation.sent`, `invitation.revoked`, `invitation.accepted`	la membresía de la invitación; al aceptar, la persona nueva es el actor
`organisation.relabelled`, `organisation.retention_set`	las etiquetas que lleva la organización; el plazo de conservación

Una invitación aceptada genera también una fila por cada rol, grupo y valor que dio.

Qué no contiene el registro¶

No contiene contraseñas, tokens ni claves, ni direcciones de correo electrónico: una invitación queda registrada con su id. Después de borrar a una persona, sus ids de membresía siguen apareciendo, pero ya no señalan a nadie.

Un cambio en las personas o los ajustes aparece de inmediato en el registro. Los cambios en membresías e invitaciones llegan en segundo plano, poco después. Si vuelves a leer una página, ves también filas registradas más tarde; el registro sirve para leerlo, no para seguirlo en directo.

Cuánto tiempo se conserva el registro¶

Las filas se conservan por defecto 400 días; después OS las elimina. El plazo está en audit_retention_days de la organización. Solo tu operador lo modifica; pregúntale allí si necesitas otro plazo.

Si OS rechaza¶

Respuesta	Significado	Qué haces
`403`	La organización, o una superior, está suspendida.	Pregunta a tu operador qué ocurre.
`404`	No puedes leer el registro, y entonces no existe para ti; o la organización no existe o no llegas a ella.	Comprueba `$ORG`, o pide a un administrador el rol `auditor`.
`422`	Un filtro o `limit` no es correcto, por ejemplo `limit` por encima de 200.	Lee `errors` en la respuesta.