Esta página documenta la lista completa de eventos que se muestran con la función de registro de auditoría del espacio de trabajo. Esta lista está sujeta a cambios y se añadirán más eventos con el tiempo.
Los registros de auditoría siguen la versión 1.7.0 del Open Cybersecurity Schema Framework (OCSF), un esquema estandarizado e independiente de la plataforma diseñado para datos de eventos de seguridad.
Lista de eventos
Esta lista contiene todos los eventos disponibles actualmente; los eventos se identifican de forma única mediante sus valores numéricos activity_id y activity_name. Cada evento también pertenece a una clase específica (identificada mediante class_uid y class_name), y las clases se agrupan en diferentes categorías.
Para obtener más información sobre los datos contenidos en cada evento, puede consultar la documentación enlazada en el sitio web de OCSF para ver el esquema completo de cada clase, así como la lista de propiedades comunes y ejemplos de algunos detalles específicos de Read más adelante.
| class_uid | class_name | activity_id | activity_name | Descripción del activador |
|---|---|---|---|---|
| 3001 | Cambio de cuenta | 2 | Habilitar | Cuenta de usuario reactivada |
| 3001 | Cambio de cuenta | 4 | Restablecimiento de contraseña | Contraseña de usuario restablecida |
| 3001 | Cambio de cuenta | 5 | Deshabilitar | Cuenta de usuario desactivada |
| 3001 | Cambio de cuenta | 6 | Eliminar | Cuenta de usuario eliminada |
| 3001 | Cambio de cuenta | 99 | Otro | Correo electrónico del usuario verificado |
| 3002 | Autenticación | 1 | Inicio de sesión | El usuario inicia sesión |
| 3002 | Autenticación | 2 | Cierre de sesión | El usuario cierra sesión |
| 3005 | Administración del acceso de usuarios | 1 | Asignar privilegios | Acceso a la sesión* añadido para un usuario |
| 3005 | Administración del acceso de usuarios | 2 | Revocar privilegios | Acceso a la sesión* revocado para un usuario |
| 3006 | Administración de grupos | 1 | Asignar privilegios | Acceso a la sesión* creado para una entidad que no es un usuario (equipo/espacio de trabajo) |
| 3006 | Administración de grupos | 2 | Revocar privilegios | Acceso a la sesión* eliminado para una entidad que no es un usuario (equipo/espacio de trabajo) |
| 3006 | Administración de grupos | 3 | Añadir usuario | Miembro añadido a un espacio de trabajo o equipo |
| 3006 | Administración de grupos | 4 | Eliminar usuario | Miembro eliminado de un espacio de trabajo o equipo |
| 3006 | Administración de grupos | 99 | Otro | Invitación a un espacio de trabajo o equipo creada/eliminada |
| 6001 | Actividad de recursos web | 1 | Crear | Destino del registro de auditoría creado |
| 6001 | Actividad de recursos web | 3 | Actualizar | Configuración del espacio de trabajo, equipo o usuario actualizada |
| 6002 | Ciclo de vida de la aplicación | 1 | Instalar | Integración añadida |
| 6002 | Ciclo de vida de la aplicación | 2 | Eliminar | Integración eliminada |
| 6002 | Ciclo de vida de la aplicación | 6 | Habilitar | Integración activada |
| 6002 | Ciclo de vida de la aplicación | 7 | Deshabilitar | Integración deshabilitada |
*Sesión se refiere a un informe de reunión específico.
Propiedades comunes de los eventos
| Nombre | Descripción | Propiedad de OCSF |
|---|---|---|
| Identificador del evento | Un ULID único asociado al evento de registro específico | metadata.uid |
| Identificador del espacio de trabajo | El identificador del espacio de trabajo de Read AI al que está asociado el evento de registro | metadata.tenant_uid |
| Marca de tiempo | Una marca de tiempo que indica cuándo ocurrió el evento, con precisión de milisegundos | time |
| Tipo de evento | Una etiqueta que indica el tipo de evento, como «Inicio de sesión» o «Añadir usuario» (tanto un identificador numérico como un nombre de cadena) | activity_id / activity_name |
| Actor | La entidad responsable de activar el evento. Normalmente es un user_id, pero puede ser el propio Read AI en el caso de eventos que el sistema activa automáticamente. La información del actor no está disponible en los eventos de integración o de verificación de correo electrónico, que están impulsados por eventos de dominio. | actor |
| Correo electrónico del usuario | (cuando está disponible) La dirección de correo electrónico principal del usuario | actor.user.email_addr |
| Tipo de actor | El tipo de actor, normalmente Usuario, pero también podría ser Administrador, Propietario del espacio de trabajo, el propio sistema de Read AI o una integración de API | se indica mediante las propiedades del actor |
| Destino | Un identificador que representa el objeto sobre el que se actúa, como el identificador de una sesión (informe de reunión) | web_resources[].uid |
| Tipo de destino | El tipo de destino, por ejemplo, Espacio de trabajo, Usuario, Sesión (informe de reunión), etc. | web_resources[].type |
| Resultado | Indica si la acción se permitió, se denegó, falló o es desconocida | status / status_id |
| Motivo del resultado | (opcional) El motivo del «resultado»; por ejemplo, si se denegó una acción, puede contener un mensaje explicativo. Las llamadas a la API que devuelven errores 4XX suelen incluir un mensaje de este tipo. | status_detail |
| Dirección IP | (cuando está disponible) La dirección IP del actor | observables |
| Agente de usuario | (cuando está disponible) El agente de usuario del actor | observables |
| Mensaje | Un mensaje de registro sin procesar y de texto libre que proporciona contexto adicional sobre el evento | message |
Ejemplos
Evento de inicio de sesión («Logon»):
{
"activity_id":1,
"activity_name":"Logon",
"actor":{
"user":{
"email_addr":"ada@read.ai",
"uid":"1234567890"
}
},
"auth_factors":[
{
"factor_type_id":0,
"provider":"read"
}
],
"category_name":"Identity & Access Management",
"category_uid":3,
"class_name":"Authentication",
"class_uid":3002,
"message":"Authentication login for user 1234567890",
"metadata":{
"product":{
"name":"Read AI"
},
"tenant_id":"01K820PAE0S32BVWXDFN5NZR1X",
"uid":"f296be4f-a404-49e2-8c0e-412712665bb7",
"version":"1.7.0"
},
"observables":[
{
"type":"IP Address",
"type_id":2,
"value":"123.123.123.123"
},
{
"type":"HTTP User-Agent",
"type_id":16,
"value":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/145.0.0.0 Safari/537.36"
}
],
"severity":"Low",
"severity_id":2,
"status":"Success",
"status_id":1,
"time":"2026-03-13T16:00:00.785969",
"type_uid":300201,
"user":{
"email_addr":"ada@read.ai",
"full_name":"Ada Aiken",
"uid":"1234567890"
}
}Evento de cierre de sesión («Logoff»):
{
"activity_id":2,
"activity_name":"Logoff",
"actor":{
"user":{
"email_addr":"ada@read.ai",
"uid":"1234567890"
}
},
"category_name":"Identity & Access Management",
"category_uid":3,
"class_name":"Authentication",
"class_uid":3002,
"message":"Authentication logout for user 1234567890",
"metadata":{
"product":{
"name":"Read AI"
},
"tenant_id":"01K820PAE0S32BVWXDFN5NZR1X",
"uid":"5ed946d0-ef7b-408c-b756-92638d0dc385",
"version":"1.7.0"
},
"observables":[
{
"type":"IP Address",
"type_id":2,
"value":"123.123.123.123"
},
{
"type":"HTTP User-Agent",
"type_id":16,
"value":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/145.0.0.0 Safari/537.36"
}
],
"severity":"Low",
"severity_id":2,
"status":"Success",
"status_id":1,
"time":"2026-03-10T18:51:32.033259",
"type_uid":300202,
"user":{
"email_addr":"ada@read.ai",
"full_name":"Ada Aiken",
"uid":"1234567890"
}
}