Categoría | Descripción | Ejemplos | Claves de categoría y claves de mensaje | ||
---|---|---|---|---|---|
ANALYTICS | Acciones relacionadas con las entidades de análisis. Operaciones realizadas por ThingWorx Analytics. | Operaciones de creación, edición y borrado en definiciones de análisis de datos. Otras acciones en ThingWorx Analytics. | Clave de categoría: audit.AuditCategory.Analytics | ||
AUDIT | Para el uso interno del subsistema de auditoría. | Activado por defecto. Permite realizar el seguimiento de las ejecuciones del servicio de auditoría, ya que potencialmente pueden contener datos confidenciales. El mensaje de auditoría permite devolver el valor de USERNAME que ha ejecutado el servicio. Los servicios que se auditan por defecto son los siguientes: • ArchiveAuditHistory • ArchiveAuditHistoryDirectPersistence • PurgeAuditData • ExportAuditData • ExportOnlineAuditData • CleanUpOfflineAudit Los siguientes servicios no se auditan por defecto: • QueryAuditHistory • QueryAuditHistoryWithQueryCriteria • QueryAuditHistoryContextConstrained • GetAuditEntryCount | Clave de categoría: audit.AuditCategory.Audit Claves de mensaje: • audit.Audit.ExecutedService.ArchiveAuditHistory • audit.Audit.ExecutedService.ArchiveAuditHistoryDirectPersistence • audit.Audit.ExecutedService.PurgeAuditData • audit.Audit.ExecutedService.ExportAuditData • audit.Audit.ExecutedService.ExportOnlineAuditData • audit.Audit.ExecutedService.CleanUpOfflineAudit • audit.Audit.ExecutedService.Query AuditHistory • audit.Audit.ExecutedService.GetAuditEntryCount | ||
AUTHENTICATION | Acciones relacionadas con la autenticación. | • Conexión de usuario correcta e incorrecta, desconexión de un usuario y errores relacionados con el uso de claves de aplicación. Por ejemplo: Login successful for user: Administrator. • La entrada Logout permite realizar el seguimiento de las acciones de desconexión del usuario. Esta entrada se genera para la desconexión de ThingWorx Composer iniciada por el usuario. El nombre de usuario se incluye en el mensaje de auditoría. • La entrada LoginSucceeded permite realizar el seguimiento de las acciones de conexión del usuario correctas. El nombre de usuario se incluye en el mensaje de auditoría. • La entrada LoginFailed permite realizar el seguimiento de las acciones de conexión del usuario fallidas. El nombre de usuario se incluye en el mensaje de auditoría. • La entrada ApplicationKeySucceeded permite realizar el seguimiento de la autentificación correcta con una clave de aplicación. El nombre de usuario se incluye en el mensaje de auditoría. • La entrada ApplicationKeyFailed permite realizar el seguimiento de la autentificación fallida con una clave de aplicación. El nombre de usuario se incluye en el mensaje de auditoría. | Clave de categoría: audit.AuditCategory.Authentication Claves de mensaje • com.thingworx.things.security.SecurityMonitorThing.Logout.Audit • com.thingworx.things.security.SecurityMonitorThing.LoginSucceeded.Audit • com.thingworx.things.security.SecurityMonitorThing.LoginFailed.Audit • com.thingworx.things.security.SecurityMonitorThing.ApplicationKeySucceeded.Audit • com.thingworx.things.security.SecurityMonitorThing.ApplicationKeyFailed.Audit | ||
COLLABORATION | Acciones relacionadas con las entidades de colaboración. | Operaciones de creación, edición y borrado en blogs y wikis. | Clave de categoría: audit.AuditCategory.Collaboration | ||
DATA_MANAGEMENT | Acciones relacionadas con la administración o el uso de datos. | Operaciones de borrado en los datos. | Clave de categoría: audit.AuditCategory.DataManagement | ||
DATA_STORAGE | Acciones relacionadas con las entidades de almacenamiento de datos y los subsistemas relacionados. | Operaciones de creación, edición y borrado en tablas de datos, flujos y otras entidades de almacenamiento de datos. | Clave de categoría: audit.AuditCategory.DataStorage | ||
DEVICE_COMMUNICATION | Acción relacionada con la comunicación con dispositivos Edge. | Se audita el servicio CloseWebSocketSessions de WSCommunicationSubsystem. Para obtener información detallada sobre el servicio, consulte la sección "Servicios" del tema Subsistema de comunicaciones Websocket.
| Clave de categoría: audit.AuditCategory.DeviceCommunication | ||
FILE_TRANSFER | Acciones y eventos relacionados con cargas y descargas de ficheros. | Para las transferencias de ficheros, la finalización correcta de una transferencia, la cancelación de una transferencia y la generación de errores durante una transferencia. | Clave de categoría: audit.AuditCategory.FileTransfer | ||
IMPORT_EXPORT | Acciones relacionadas con la importación y exportación de datos a y desde ThingWorx. | Operaciones de importación/exportación de modelos y datos. Importación de una extensión. | Clave de categoría: audit.AuditCategory.ImportExport | ||
LIFECYCLE | Acciones relacionadas con un evento específico de cosa, como ThingEnable. | Los eventos como, por ejemplo, ThingEnable y ThingDisable, se generan cuando se llama a los servicios correspondientes en una cosa. La auditoría de eventos ThingStart está desactivada por defecto debido a la carga durante el inicio y el reinicio de ThingWorx Platform. | Clave de categoría: audit.AuditCategory.Lifecycle Claves de mensaje: • com.thingworx.things.Thing.ThingStart.Audit • audit.EntityLifecycle.Enable • audit.EntityLifecycle.Disable | ||
Operaciones de creación y borrado relacionadas con todas las entidades, incluidos los grupos de cosas. | A continuación se detallan las operaciones y los mensajes de auditoría: • El usuario X ha creado un nuevo grupo de cosas Y: el mensaje de auditoría es "Se ha creado el type "name". • El usuario X ha borrado el grupo de cosas Y: el mensaje de auditoría es "Se ha borrado el type "name". • El usuario X ha borrado todos los miembros hijo del grupo de cosas Y: el mensaje de auditoría es "Se han borrado de todos los miembros hijo de typename". | Clave de categoría: audit.LifeCycle Claves de mensaje: • audit.LifeCycle.Created • audit.LifeCycle.Deleted • audit.LifeCycle.DeletedAll | |||
THINGGROUPMEMBERSHIPS | Operaciones de adición relacionadas con las pertenencias a grupos de cosas | A continuación se detallan las operaciones y los mensajes de auditoría: • El usuario X ha añadido la cosa 123 como miembro hijo del grupo de cosas Y: el mensaje de auditoría es "Se ha añadido la cosa thingName como miembro hijo del grupo de cosas thingGroupName. • El usuario X ha añadido el grupo de cosas ABC como miembro hijo del grupo de cosas Y: el mensaje de auditoría es "Se ha añadido el grupo de cosas thingGroupName1 como miembro hijo del grupo de cosas thingGroupName2. | Clave de categoría: audit.ThingGroupMemberships Claves de mensaje: • com.thingworx.thinggroups.ThingGroup.AddedThingAsChildMember • com.thingworx.thinggroups.ThingGroup.AddedThingGroupAsChildMember | ||
Borrado de operaciones relacionadas con afiliaciones a un grupo de cosas | A continuación se detallan las operaciones y los mensajes de auditoría: • El usuario X ha borrado la cosa 123 como miembro hijo del grupo de cosas Y: el mensaje de auditoría es "Se ha borrado la cosa thingName como miembro hijo del grupo de cosas thingGroupName". • El usuario X ha borrado el grupo de cosas ABC como miembro hijo del grupo de cosas Y: el mensaje de auditoría es "Se ha borrado el grupo de cosas thingGroupName1 como miembro hijo del grupo de cosas thingGroupName2". • El usuario X ha borrado todos los miembros hijo (cosas y/o grupos de cosas) del grupo de cosas Y: el mensaje de auditoría es "Se han borrado todos los miembros hijo del grupo de cosas thingGroupName". | Clave de categoría:audit.ThingGroupMemberships Claves de mensaje: • com.thingworx.thinggroups.ThingGroup.DeletedThingAsChildMember • com.thingworx.thinggroups.ThingGroup.DeletedThingGroupAsChildMember • com.thingworx.thinggroups.ThingGroup.DeletedAllChildMembers | |||
MODELING | Acciones relacionadas con las entidades de modelado. Cuando se crea una entidad, el sistema genera un mensaje de auditoría en el que se incluye el propietario asignado a la nueva entidad. Se debe tener en cuenta que el propietario de una entidad se define automáticamente en el nombre de usuario que ha creado la entidad. El sistema genera el mensaje de auditoría cuando se utiliza cualquiera de las formas de crear una entidad: • Mediante una llamada a PUT en Composer • A través de una llamada a una API Create, una API Clone o la API SetOwner Todos los usuarios autorizados para ver el subsistema de auditoría pueden ver informes sobre los cambios de propiedad. | Operaciones de creación, edición y borrado en cosas, plantillas de cosa, definiciones de cosa, definiciones de datos, redes, proyectos, modelos y etiquetas. El formato del mensaje de auditoría es: "Created <Source Type> <Source> with owner <username of owner>." Donde: • Source Type es la clase de entidad creada. Por ejemplo, una cosa. • Source es el nombre de la nueva entidad. • owner muestra el elemento username del usuario que realiza la acción de creación. | Clave de categoría: audit.AuditCategory.Modeling La clave de mensaje es: audit.EntityLifecycle.Create. | ||
REMOTE_ACCESS | Acciones relacionadas con el acceso remoto (tunelización). | • Inicio de la sesión de usuario: en el mensaje de auditoría se incluye el ID de usuario y la hora de inicio de la sesión. • Detención de la sesión de usuario: en el mensaje de auditoría se incluyen el ID de usuario, la hora de fin y el tiempo total de la sesión. | Clave de categoría: audit.AuditCategory.RemoteAccess | ||
SCM (Software Content Management) | Acciones relacionadas con paquetes, implementaciones y cambios de configuración. | Creación, edición, publicación y borrado de paquetes. Creación, inicio, transición y borrado de implementaciones. Se incluyen las implementaciones de prueba y reales, activos especificados para una implementación de prueba y la instalación correcta o fallida de paquetes. Cambios de configuración para la depuración automática y para implementaciones simultáneas. En la información de las implementaciones de paquetes se incluye el ID de usuario cuando un usuario inicia la implementación directamente. Cuando la plataforma inicia una implementación, SYSTEM se muestra como la entidad que implementa el paquete. | Clave de categoría: audit.AuditCategory.SoftwareManagement | ||
SECURITY_CONFIGURATION | Acciones relacionadas con entidades y permisos de seguridad, incluidos usuarios, grupos de usuarios, grupos de cosas, organizaciones, claves de aplicación, servicios de directorio y autenticadores. Cuando la propiedad cambia para una entidad, se genera un mensaje de auditoría. Un propietario se puede cambiar a través de Composer, a través de una llamada a API o a través de una importación de un fichero XML de entidades. No se genera un mensaje de auditoría de propiedad en los siguientes casos: • El subsistema de auditoría está desactivado. • La entidad se ha actualizado sin cambios de propiedad. • La llamada a la API SetOwner define el mismo propietario que ya era el propietario de la entidad. | Operaciones de creación, edición y borrado en usuarios, grupos de usuarios, grupos de cosas, organizaciones, claves de aplicación, servicios de directorio y autenticadores. Permite activar el seguimiento de los cambios de grupo de usuarios. La entrada audit.Groups.Added se genera siempre que un usuario o un grupo de usuarios se añade como miembro de otro grupo de usuarios. La entidad audit.Groups.Removed se genera siempre que se quita un usuario o un grupo de usuarios de un grupo de usuarios. Cambios de permisos de entidades (todos los tipos de entidad). Consulte la sección anterior, Auditoría del cambio del contexto de seguridad. El formato general del mensaje de auditoría de cambio de propiedad es el siguiente: "Owner for <Source Type> <Source> changed from <original owner username> to <new owner username>." Donde: • Source Type es el tipo de entidad cuyo propietario ha cambiado. Por ejemplo, una cosa. • Source es el nombre de la entidad cuyo propietario ha cambiado. • original owner username muestra el elemento username del usuario que realiza la acción de cambio. • new owner username es el elemento username del nuevo propietario. | Clave de categoría: audit.AuditCategory.SecurityConfiguration Claves de mensaje: • audit.Groups.Added • audit.Groups.Removed • audit.entity.ownership.change | ||
Activación y desactivación de la delegación del permiso de visibilidad del grupo de cosas en el subsistema de gestión de usuarios por el administrador | A continuación se detallan las operaciones y los mensajes de auditoría: • Delegación del permiso de visibilidad del grupo de cosas activada por el administrador en el subsistema de gestión de usuarios: el mensaje de auditoría es "Delegación de permiso de visibilidad de grupo de cosas activada". • Delegación del permiso de visibilidad del grupo de cosas desactivada por el administrador en el subsistema de gestión de usuarios: el mensaje de auditoría es "Delegación de permiso de visibilidad de grupo de cosas desactivada". | Clave de categoría: audit.AuditCategory.SecurityConfiguration Claves de mensaje: • com.thingworx.thinggroups.ThingGroup.VisibilityPermissionDelegationEnabled • com.thingworx.thinggroups.ThingGroup.VisibilityPermissionDelegationDisabled | |||
SYSTEM | Acciones relacionadas con las entidades de sistema. | Operaciones de creación, edición y borrado en tablas de localización, recursos, subsistemas y registros. Cambios y acciones de configuración del subsistema, incluidos el inicio, la detención y el reinicio. Todas las entradas relacionadas con el subsistema están en esta categoría y no aparecerán en otras categorías.
| Clave de categoría: audit.AuditCategory.System | ||
VISUALIZATION | Acciones relacionadas con las entidades de visualización. | Operaciones de creación, edición y borrado de operaciones en mashups, maestros, gadgets, tableros, menús, entidades multimedia, definiciones de estilo y definiciones de estado. | Clave de categoría: audit.AuditCategory.Visualization |
Categoría de auditoría | Clave de mensaje de auditoría |
---|---|
AUDIT | • audit.Audit.ExecutedService.QueryAuditHistory • audit.Audit.ExecutedService.QueryAuditHistoryWithQueryCriteria • QueryAuditHistoryContextConstrained • audit.Audit.ExecutedService.GetAuditEntryCount |
THINGGROUPMEMBERSHIPS | • com.thingworx.thinggroups.ThingGroup.AddedThingAsChildMember • com.thingworx.thinggroups.ThingGroup.DeletedThingAsChildMember • com.thingworx.thinggroups.ThingGroup.AddedThingGroupAsChildMember • com.thingworx.thinggroups.ThingGroup.DeletedThingGroupAsChildMember • com.thingworx.thinggroups.ThingGroup.DeletededAllChildMembers |
LIFECYCLE | audit.Lifecycle.ThingStart |
No se pueden activar ni desactivar eventos individuales en la categoría LIFECYCLE. Se deben activar o desactivar todos mediante la notación "MessageKeys" : ["ALL"]. |
Para realizar cambios en el fichero platform-settings.json para categorías de auditoría y mensajes de evento es necesario reiniciar la instancia de ThingWorx Platform. Este tipo de cambio debe realizarse con la menor frecuencia posible. |
La sección Audit se debe añadir como nodo del mismo nivel a la entrada JSON de PlatformSettingsConfig. Puede encontrarse antes o después del nodo PlatformSettingsConfig, pero debe estar en el mismo nivel de nodo. |