Catégorie | Description | Exemples | Clés de catégorie et clés de message | ||
---|---|---|---|---|---|
ANALYTICS | Actions relatives aux entités Analytique. Opérations effectuées par ThingWorx Analytics | Opérations de création, de modification et de suppression appliquées aux définitions d'analyses de données Autres actions effectuées dans ThingWorx Analytics | Clé de catégorie : audit.AuditCategory.Analytics | ||
AUDIT | Pour utilisation par le sous-système d'audit interne. | Activée par défaut. Active le suivi des exécutions des services d'audit, car ils peuvent contenir des données sensibles. Le message d'audit renvoie le nom de l'utilisateur (USERNAME) qui a exécuté le service. Les services audités par défaut sont les suivants : • ArchiveAuditHistory • ArchiveAuditHistoryDirectPersistence • PurgeAuditData • ExportAuditData • ExportOnlineAuditData • CleanUpOfflineAudit Les services suivants ne sont pas audités par défaut : • QueryAuditHistory • QueryAuditHistoryWithQueryCriteria • QueryAuditHistoryContextConstrained • GetAuditEntryCount | Clé de catégorie : audit.AuditCategory.Audit Clés de message : • 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 | Actions relatives à l'authentification | • Connexion/déconnexion de l'utilisateur (succès ou échec) et erreurs liées à l'utilisation des clés d'application. Par exemple : Login successful for user: Administrator. • L'entrée Logout active le suivi des actions de déconnexion de l'utilisateur. Cette entrée est générée pour une déconnexion initiée par l'utilisateur à partir de ThingWorx Composer. Le nom d'utilisateur est inclus dans le message d'audit. • L'entrée LoginSucceeded active le suivi des actions de connexion réussies de l'utilisateur. Le nom d'utilisateur est inclus dans le message d'audit. • L'entrée LoginFailed active le suivi des actions de connexion de l'utilisateur qui ont échoué. Le nom d'utilisateur est inclus dans le message d'audit. • L'entrée ApplicationKeySucceeded active le suivi des authentifications avec clé d'application réussies. Le nom d'utilisateur est inclus dans le message d'audit. • L'entrée ApplicationKeyFailed active le suivi des authentifications avec clé d'application qui ont échoué. Le nom d'utilisateur est inclus dans le message d'audit. | Clé de catégorie : audit.AuditCategory.Authentication Clés de message : • 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 | Actions relatives aux entités collaboration | Opérations de création, de modification et de suppression appliquées aux blogs et wikis | Clé de catégorie : audit.AuditCategory.Collaboration | ||
DATA_MANAGEMENT | Actions relatives à la gestion ou à l'utilisation des données | Opérations de suppression appliquées aux données | Clé de catégorie : audit.AuditCategory.DataManagement | ||
DATA_STORAGE | Actions relatives aux entités stockage de données et aux sous-systèmes associés | Opérations de création, de modification et de suppression appliquées aux tables de données, aux flux et à d'autres entités stockage de données | Clé de catégorie : audit.AuditCategory.DataStorage | ||
DEVICE_COMMUNICATION | Action relative à la communication avec des périphériques Edge. | Le service CloseWebSocketSessions de WSCommunicationSubsystem est audité. Pour plus d'informations sur le service, reportez-vous à la section "Services" de la rubrique Sous-système de gestion des communications WebSocket.
| Clé de catégorie : audit.AuditCategory.DeviceCommunication | ||
FILE_TRANSFER | Actions et événements relatifs aux chargements et téléchargements de fichiers | Pour les transferts de fichiers : réussite d'un transfert, annulation d'un transfert et génération d'erreurs lors d'un transfert | Clé de catégorie : audit.AuditCategory.FileTransfer | ||
IMPORT_EXPORT | Actions relatives à l'importation et l'exportation de données vers et depuis ThingWorx | Opérations d'importation/exportation de modèles et de données Importation d'une extension | Clé de catégorie : audit.AuditCategory.ImportExport | ||
LIFECYCLE | Actions relatives à un événement spécifique un objet, tel que ThingEnable | Des événements comme ThingEnable et ThingDisable sont générés lorsque des services correspondants sont appelés sur un objet. L'audit des événements ThingStart est désactivé par défaut en raison de la charge lors du démarrage et du redémarrage de ThingWorx Platform. | Clé de catégorie : audit.AuditCategory.Lifecycle Clés de message : • com.thingworx.things.Thing.ThingStart.Audit • audit.EntityLifecycle.Enable • audit.EntityLifecycle.Disable | ||
Opérations de création et de suppression associées à toutes les entités, y compris les groupes d'objets | Les opérations et les messages suivants sont audités : • L'utilisateur X a créé un nouveau groupe d'objets Y : le message d'audit est "type "name" créé". • L'utilisateur X a supprimé un groupe d'objets Y : le message d'audit est "type "name" supprimé". • L'utilisateur X a supprimé tous les membres enfants du groupe d'objets Y : le message d'audit est "Tous les membres enfants supprimés du groupe d'objets typename". | Clé de catégorie : audit.LifeCycle Clés de message : • audit.LifeCycle.Created • audit.LifeCycle.Deleted • audit.LifeCycle.DeletedAll | |||
THINGGROUPMEMBERSHIPS | Opérations d'ajout associées à des appartenances à un groupe d'objets | Les opérations et les messages d'audit suivants sont audités : • L'utilisateur X a ajouté l'objet 123 en tant que membre enfant du groupe d'objets Y : le message d'audit est "Objet thingName ajouté en tant que membre enfant du groupe d'objets thingGroupName". • L'utilisateur X a ajouté le groupe d'objets ABC en tant que membre enfant du groupe d'objets Y : le message d'audit est "Groupe d'objets thingGroupName1 ajouté en tant que membre enfant du groupe d'objets thingGroupName2". | Clé de catégorie : audit.ThingGroupMemberships Clés de message : • com.thingworx.thinggroups.ThingGroup.AddedThingAsChildMember • com.thingworx.thinggroups.ThingGroup.AddedThingGroupAsChildMember | ||
Opérations de suppression associées à des appartenances à un groupe d'objets | Les opérations et les messages d'audit suivants sont audités : • L'utilisateur X a supprimé l'objet 123 en tant que membre enfant du groupe d'objets Y : le message d'audit est "Objet thingName supprimé en tant que membre enfant du groupe d'objets thingGroupName". • L'utilisateur X a supprimé le groupe d'objets ABC en tant que membre enfant du groupe d'objets Y : le message d'audit est "Groupe d'objets thingGroupName1 supprimé en tant que membre enfant du groupe d'objets thingGroupName2". • L'utilisateur X a supprimé tous les membres enfants (objets et/ou groupes d'objets) du groupe d'objets Y : le message d'audit est "Tous les membres enfants supprimés du groupe d'objets thingGroupName". | Clé de catégorie : audit.ThingGroupMemberships Clés de message : • com.thingworx.thinggroups.ThingGroup.DeletedThingAsChildMember • com.thingworx.thinggroups.ThingGroup.DeletedThingGroupAsChildMember • com.thingworx.thinggroups.ThingGroup.DeletedAllChildMembers | |||
MODELING | Actions relatives aux entités Modélisation Lorsqu'une entité est créée, le système génère un message d'audit qui inclut le propriétaire affecté à la nouvelle entité. Notez que le propriétaire d'une entité est défini automatiquement sur le nom d'utilisateur qui a créé l'entité. Le système génère un message d'audit lorsque l'une des méthodes suivantes de création d'entité est utilisée : • Via l'appel de PUT dans Composer • Via un appel d'une API Create, d'une API Clone ou de l'API SetOwner Tout utilisateur autorisé à consulter le sous-système d'audit peut afficher des rapports concernant les modifications de propriété. | Opérations de création, de modification et de suppression appliquées aux objets, modèles d'objet, formes d'objet, formes de données, réseaux, projets, modèles et tags Le format du message d'audit est le suivant : "Created <Source Type> <Source> with owner <username of owner>." Où : • Source Type correspond au type d'entité créé. Par exemple, un objet. • Source correspond au nom de la nouvelle entité. • owner affiche le username (nom d'utilisateur) de l'utilisateur qui exécute l'action de création. | Clé de catégorie : audit.AuditCategory.Modeling Clé de message : audit.EntityLifecycle.Create | ||
REMOTE_ACCESS | Actions relatives à l'accès à distance (tunnellisation) | • Démarrage de la session utilisateur : le message d'audit inclut l'ID utilisateur et l'heure de démarrage de la session. • Arrêt de la session utilisateur : le message d'audit inclut l'ID utilisateur, l'heure de fin et la durée totale de la session. | Clé de catégorie : audit.AuditCategory.RemoteAccess | ||
SCM (Software Content Management) | Actions relatives aux packages, déploiements et modifications de configuration | Création, modification, publication et suppression de packages. Création, lancement, transition et suppression de déploiements. Inclut les déploiements test et effectifs, les actifs spécifiés pour un déploiement test, et la réussite ou l'échec de l'installation de packages. Modifications de configuration pour la purge automatique et pour les déploiements simultanés Les informations relatives aux déploiements de package incluent l'ID utilisateur lorsque le déploiement est lancé directement par un utilisateur. Lorsqu'un déploiement est initié par la plateforme, SYSTEM est répertorié en tant qu'entité déployant le package. | Clé de catégorie : audit.AuditCategory.SoftwareManagement | ||
SECURITY_CONFIGURATION | Actions associées aux entités et autorisations de sécurité, y compris les utilisateurs, les groupes d'utilisateurs, les groupes d'objets, les organisations, les clés d'application, les services d'annuaire et les authentificateurs Un message d'audit est généré chaque fois que le propriétaire d'une entité est modifié. Un propriétaire peut être modifié via Composer, via un appel d'API ou via l'importation d'un fichier XML d'entités. Un message d'audit de propriété n'est pas généré dans les cas suivants : • Le sous-système d'audit est désactivé. • L'entité a été mise à jour sans modification de propriété. • L'appel de l'API SetOwner a défini le même propriétaire qui était déjà celui de l'entité. | Opérations de création, de modification et de suppression appliquées aux utilisateurs, groupes d'utilisateurs, groupes d'objets, organisations, clés d'application, services d'annuaire et authentificateurs Active le suivi des modifications associées aux groupes d'utilisateurs. L'entrée audit.Groups.Added est générée chaque fois qu'un utilisateur ou un groupe d'utilisateurs est ajouté en tant que membre d'un autre groupe d'utilisateurs. L'entité audit.Groups.Removed est générée chaque fois qu'un utilisateur ou un groupe d'utilisateurs est supprimé d'un groupe d'utilisateurs. Modifications des autorisations des entités (tous les types d'entités) Reportez-vous à la section ci-dessus Audit du changement de contexte de sécurité. Le format général du message d'audit de modification de propriété est le suivant : "Owner for <Source Type> <Source> changed from <original owner username> to <new owner username>." Où : • Source Type correspond au type d'entité dont le propriétaire a été modifié. Par exemple, un objet. • Source correspond au nom de l'entité dont le propriétaire a été modifié. • original owner username affiche le username (nom d'utilisateur) de l'utilisateur qui exécute l'action de modification. • new owner username est le username (nom d'utilisateur) du nouveau propriétaire. | Clé de catégorie : audit.AuditCategory.SecurityConfiguration Clés de message : • audit.Groups.Added • audit.Groups.Removed • audit.entity.ownership.change | ||
Administrateur activant et désactivant la délégation des autorisations de visibilité sur les groupes d'utilisateurs dans le sous-système de gestion des utilisateurs | Les opérations et les messages d'audit suivants sont audités : • L'administrateur a activé la délégation des autorisations de visibilité sur les groupes d'objets dans le sous-système de gestion des utilisateurs : le message d'audit est "Délégation de permission de visibilité du groupe d'objets activée". • L'administrateur a désactivé la délégation des autorisations de visibilité sur les groupes d'objets dans le sous-système de gestion des utilisateurs : le message d'audit est "Délégation de permission de visibilité du groupe d'objets désactivée". | Clé de catégorie : audit.AuditCategory.SecurityConfiguration Clés de message : • com.thingworx.thinggroups.ThingGroup.VisibilityPermissionDelegationEnabled • com.thingworx.thinggroups.ThingGroup.VisibilityPermissionDelegationDisabled | |||
SYSTEM | Actions relatives aux entités système | Opérations de création, de modification et de suppression appliquées aux tables de localisation, ressources, sous-systèmes et journaux Actions et modifications de configuration des sous-systèmes, y compris le démarrage, l'arrêt et le redémarrage. Toutes les entrées associées aux sous-systèmes apparaissent dans cette catégorie et n'appartiendront à aucune autre catégorie.
| Clé de catégorie : audit.AuditCategory.System | ||
VISUALIZATION | Actions relatives aux entités Visualisation | Opérations de création, de modification et de suppression appliquées aux applications composites, modèles de base, gadgets, tableaux de bord, menus, entités de média, définitions de style et définitions d'état | Clé de catégorie : audit.AuditCategory.Visualization |
Catégorie d'audit | Clé de message d'audit |
---|---|
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 |
Vous ne pouvez pas activer ou désactiver des événements individuels dans la catégorie LIFECYCLE. Vous devez tous les activer ou les désactiver à l'aide de la notation "MessageKeys" : ["ALL"]. |
Toute modification du fichier platform-settings.json pour les catégories d'audit et les messages d'événement nécessite un redémarrage de l'instance de ThingWorx Platform. Ce type de modification doit être limité au maximum. |
La section Audit doit être ajoutée en tant que noeud frère à l'entrée JSON de PlatformSettingsConfig. Il peut être situé avant ou après le noeud PlatformSettingsConfig, mais il doit se situer au même niveau de noeud. |