Categoria | Descrizione | Esempi | Chiavi di categoria e chiavi di messaggio | ||
---|---|---|---|---|---|
ANALYTICS | Azioni correlate alle entità di analisi. Operazioni eseguite da ThingWorx Analytics. | Operazioni di creazione, modifica ed eliminazione su definizioni di analisi dei dati. Altre azioni in ThingWorx Analytics. | Chiave di categoria: audit.AuditCategory.Analytics | ||
AUDIT | Per l'uso interno del sottosistema Verifica. | Attivata per default. Consente la verifica delle esecuzioni del servizio di verifica in quanto possono contenere dati sensibili. Il messaggio di verifica restituisce lo USERNAME che ha eseguito il servizio. Di seguito sono riportati i servizi sottoposti a verifica per default: • ArchiveAuditHistory • ArchiveAuditHistoryDirectPersistence • PurgeAuditData • ExportAuditData • ExportOnlineAuditData • CleanUpOfflineAudit I servizi seguenti non vengono sottoposti a verifica per default: • QueryAuditHistory • QueryAuditHistoryWithQueryCriteria • QueryAuditHistoryContextConstrained • GetAuditEntryCount | Chiave di categoria: audit.AuditCategory.Audit Chiavi di messaggio: • 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 | Azioni correlate all'autenticazione. | • Accesso utente riuscito e non riuscito, utente bloccato ed errori relativi all'utilizzo delle chiavi di accesso, ad esempio Login successful for user: Administrator. • La voce Logout consente la verifica delle azioni di disconnessione dell'utente. Questa voce viene generata per la disconnessione avviata dall'utente in ThingWorx Composer. Il nome utente è incluso nel messaggio di verifica. • La voce LoginSucceeded consente la verifica delle azioni di accesso dell'utente riuscite. Il nome utente è incluso nel messaggio di verifica. • La voce LoginFailed consente la verifica delle azioni di accesso dell'utente non riuscite. Il nome utente è incluso nel messaggio di verifica. • La voce ApplicationKeySucceeded consente la verifica dell'autenticazione riuscita con una chiave di accesso. Il nome utente è incluso nel messaggio di verifica. • La voce ApplicationKeyFailed consente la verifica dell'autenticazione non riuscita con una chiave di accesso. Il nome utente è incluso nel messaggio di verifica. | Chiave di categoria: audit.AuditCategory.Authentication Chiavi di messaggio: • 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 | Azioni correlate alle entità di collaborazione. | Operazioni di creazione, modifica ed eliminazione su blog e wiki. | Chiave di categoria: audit.AuditCategory.Collaboration | ||
DATA_MANAGEMENT | Azioni relative alla gestione o all'utilizzo dei dati. | Operazioni di eliminazione sui dati. | Chiave di categoria: audit.AuditCategory.DataManagement | ||
DATA_STORAGE | Azioni correlate alle entità di archiviazione dati e ai relativi sottosistemi. | Operazioni di creazione, modifica ed eliminazione su tabelle dati, stream e altre entità di archiviazione dati. | Chiave di categoria: audit.AuditCategory.DataStorage | ||
DEVICE_COMMUNICATION | Azione correlata alla comunicazione con dispositivi edge. | Il servizio CloseWebSocketSessions di WSCommunicationSubsystem viene sottoposto a verifica. Per informazioni dettagliate sul servizio, fare riferimento alla sezione "Servizi" dell'argomento Sottosistema Comunicazioni WebSocket.
| Chiave di categoria: audit.AuditCategory.DeviceCommunication | ||
FILE_TRANSFER | Azioni ed eventi correlati a caricamenti e download di file. | Per i trasferimenti di file, il completamento riuscito di un trasferimento, l'annullamento di un trasferimento e la generazione di errori durante un trasferimento. | Chiave di categoria: audit.AuditCategory.FileTransfer | ||
IMPORT_EXPORT | Azioni correlate all'importazione e all'esportazione di dati da e verso ThingWorx. | Operazioni di importazione/esportazione dei dati e dei modelli. Importazione di un'estensione. | Chiave di categoria: audit.AuditCategory.ImportExport | ||
LIFECYCLE | Azioni correlate a un evento specifico di un oggetto, ad esempio ThingEnable. | Gli eventi come ThingEnable e ThingDisable vengono generati quando i servizi corrispondenti vengono chiamati per un oggetto. La verifica degli eventi ThingStart è disattivata per default a causa del carico durante l'avvio di ThingWorx Platform e viene riavviata. | Chiave di categoria: audit.AuditCategory.Lifecycle Chiavi di messaggio: • com.thingworx.things.Thing.ThingStart.Audit • audit.EntityLifecycle.Enable • audit.EntityLifecycle.Disable | ||
Operazioni di creazione ed eliminazione correlate a tutte le entità, compresi i gruppi di oggetti. | Di seguito sono riportati le operazioni e i messaggi sottoposti a verifica. • L'utente X ha creato un nuovo gruppo di oggetti Y - Il messaggio di verifica è "Creazione di tipo "nome" completata". • L'utente X ha eliminato il gruppo di oggetti Y - Il messaggio di verifica è "Eliminazione di tipo "nome" completata". • L'utente X ha eliminato tutti i membri figlio del gruppo di oggetti Y - Il messaggio di verifica è "Tutti i membri figlio di tiponome sono stati eliminati". | Chiave di categoria: audit.LifeCycle Chiavi di messaggio: • audit.LifeCycle.Created • audit.LifeCycle.Deleted • audit.LifeCycle.DeletedAll | |||
THINGGROUPMEMBERSHIPS | Aggiunta di operazioni correlate alle appartenenze ai gruppi di oggetti. | Di seguito sono riportati le operazioni e i messaggi di verifica sottoposti a verifica. • L'utente X ha aggiunto l'oggetto 123 come membro figlio del gruppo di oggetti Y - Il messaggio di verifica è "Oggetto nomeOggetto aggiunto come membro figlio del gruppo di oggetti nomeGruppoOggetti". • L'utente X ha aggiunto il gruppo di oggetti ABC come membro figlio del gruppo di oggetti Y - Il messaggio di verifica è "Gruppo di oggetti nomeGruppoOggetti1 aggiunto come membro figlio del gruppo di oggetti nomeGruppoOggetti2". | Chiave di categoria: audit.ThingGroupMemberships Chiavi di messaggio: • com.thingworx.thinggroups.ThingGroup.AddedThingAsChildMember • com.thingworx.thinggroups.ThingGroup.AddedThingGroupAsChildMember | ||
Operazioni di eliminazione correlate alle appartenenze ai gruppi di oggetti. | Di seguito sono riportati le operazioni e i messaggi di verifica sottoposti a verifica. • L'utente X ha eliminato l'oggetto 123 come membro figlio del gruppo di oggetti Y - Il messaggio di verifica è "Oggetto nomeOggetto eliminato come membro figlio del gruppo di oggetti nomeGruppoOggetti". • L'utente X ha eliminato il gruppo di oggetti ABC come membro figlio del gruppo di oggetti Y - Il messaggio di verifica è "Gruppo di oggetti nomeGruppoOggetti1 eliminato come membro figlio del gruppo di oggetti nomeGruppoOggetti2". • L'utente X ha eliminato tutti i membri figlio (oggetti e/o gruppi di oggetti) del gruppo di oggetti Y - Il messaggio di verifica è "Tutti i membri figlio del gruppo di oggetti NomeGruppoOggetti sono stati eliminati" | Chiave di categoria: audit.ThingGroupMemberships Chiavi di messaggio: • com.thingworx.thinggroups.ThingGroup.DeletedThingAsChildMember • com.thingworx.thinggroups.ThingGroup.DeletedThingGroupAsChildMember • com.thingworx.thinggroups.ThingGroup.DeletedAllChildMembers | |||
MODELING | Azioni correlate alle entità di modellazione. Quando viene creata un'entità, il sistema genera un messaggio di verifica che include il proprietario assegnato alla nuova entità. Il proprietario di un'entità viene impostato automaticamente sul nome utente che ha creato l'entità. Il sistema genera il messaggio di verifica quando viene utilizzato uno dei modi per creare un'entità: • Tramite chiamata PUT in Composer • Tramite una chiamata a un'API Create, a un'API Clone o all'API SetOwner Qualsiasi utente autorizzato a visualizzare il sottosistema di verifica può visualizzare i report relativi alle modifiche di proprietà. | Operazioni di creazione, modifica ed eliminazione su oggetti, modelli di oggetto, thing shape, data shape, reti, progetti, modelli e tag. Il formato del messaggio di verifica è: "Created <Source Type> <Source> with owner <username of owner>." Dove: • Source Type è il tipo di entità creata. Ad esempio un oggetto. • Source è il nome della nuova entità. • owner mostra lo username dell'utente che esegue l'azione di creazione. | Chiave di categoria: audit.AuditCategory.Modeling La chiave del messaggio è: audit.EntityLifecycle.Create. | ||
REMOTE_ACCESS | Azioni correlate all'accesso remoto (tunneling). | • Inizio della sessione dell'utente - Il messaggio di verifica comprende l'ID utente e l'ora di inizio della sessione. • Arresto della sessione dell'utente - Il messaggio di verifica comprende l'ID utente, l'ora di fine e la durata totale della sessione. | Chiave di categoria: audit.AuditCategory.RemoteAccess | ||
SCM (Software Content Management) | Azioni correlate a package, distribuzioni e modifiche alla configurazione. | Creare, modificare, pubblicare ed eliminare package. Creare, avviare, eseguire la transizione ed eliminare distribuzioni. Include implementazioni effettive e di test, asset specificati per una distribuzione di test e la riuscita o meno dell'installazione del package. Modifiche alla configurazione per l'eliminazione automatica e le distribuzioni simultanee. Le informazioni per le distribuzioni di package comprendono l'ID utente quando la distribuzione viene avviata direttamente da un utente. Quando una distribuzione viene avviata dalla piattaforma, SYSTEM viene elencato come entità che distribuisce il package. | Chiave di categoria: audit.AuditCategory.SoftwareManagement | ||
SECURITY_CONFIGURATION | Azioni correlate alle entità di sicurezza e ai permessi, compresi gli utenti, i gruppi di utenti, i gruppi di oggetti, le organizzazioni, le chiavi di accesso, i servizi di elenco e gli autenticatori. Ogni volta che per un'entità cambia la proprietà, viene generato un messaggio di verifica. È possibile cambiare un proprietario tramite Composer, tramite una chiamata API o tramite un'importazione di un file XML di entità Non viene generato un messaggio di verifica della proprietà nei casi riportati di seguito. • Il sottosistema di verifica è disattivato. • L'entità è stata aggiornata senza modifiche di proprietà. • La chiamata API SetOwner ha impostato lo stesso proprietario dell'entità. | Operazioni di creazione, modifica ed eliminazione su utenti, gruppi di utenti, gruppi di oggetti, organizzazioni, chiavi di accesso, servizi di elenco e autenticatori. Consente la verifica delle modifiche di un gruppo di utenti. La voce audit.Groups.Added viene generata ogni volta che un utente o un gruppo di utenti viene aggiunto come membro di un altro gruppo di utenti. L'entità audit.Groups.Removed viene generata ogni volta che un utente o un gruppo di utenti viene rimosso da un gruppo di utenti. Modifiche ai permessi delle entità (tutti i tipi di entità). Fare riferimento alla sezione precedente, Verifica del cambiamento del contesto di protezione. Il formato generale del messaggio di verifica delle modifiche di proprietà è il seguente: "Owner for <Source Type> <Source> changed from <original owner username> to <new owner username>." Dove: • Source Type è il tipo di entità il cui proprietario è stato modificato. Ad esempio un oggetto. • Source è il nome dell'entità il cui proprietario è cambiato. • original owner username mostra lo username dell'utente che esegue l'azione di modifica. • new owner username è il username del nuovo proprietario. | Chiave di categoria: audit.AuditCategory.SecurityConfiguration Chiavi di messaggio: • audit.Groups.Added • audit.Groups.Removed • audit.entity.ownership.change | ||
Attivazione e disattivazione della delega da parte dell'amministratore dei permessi di visibilità del gruppo di oggetti nel sottosistema Gestione utenti. | Di seguito sono riportati le operazioni e i messaggi di verifica sottoposti a verifica. • L'amministratore ha attivato la delega dei permessi di visibilità del gruppo di oggetti nel sottosistema Gestione utenti - Il messaggio di verifica è "Delega permesso di visibilità gruppo di oggetti attivata". • L'amministratore ha disattivato la delega dei permessi di visibilità del gruppo di oggetti nel sottosistema Gestione utenti - Il messaggio di verifica è "Delega permesso di visibilità gruppo di oggetti disattivata". | Chiave di categoria: audit.AuditCategory.SecurityConfiguration Chiavi di messaggio: • com.thingworx.thinggroups.ThingGroup.VisibilityPermissionDelegationEnabled • com.thingworx.thinggroups.ThingGroup.VisibilityPermissionDelegationDisabled | |||
SYSTEM | Azioni correlate alle entità di sistema. | Operazioni di creazione, modifica ed eliminazione su tabelle di localizzazione, risorse, sottosistemi e log. Azioni e modifiche di configurazione del sottosistema, quali avvio, arresto e riavvio. Tutte le voci correlate al sottosistema rientrano in questa categoria e non sono presenti in altre categorie.
| Chiave di categoria: audit.AuditCategory.System | ||
VISUALIZATION | Azioni correlate alle entità di visualizzazione. | Operazioni di creazione, modifica ed eliminazione su mashup, master, gadget, dashboard, menu, entità multimediali, definizioni di stile e definizioni di stato. | Chiave di categoria: audit.AuditCategory.Visualization |
Categoria di verifica | Chiave del messaggio di verifica |
---|---|
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 |
Non è possibile attivare o disattivare i singoli eventi nella categoria LIFECYCLE. Attivarli o disattivarli tutti, utilizzando la notazione "MessageKeys" : ["ALL"]. |
Se si apportano modifiche al file platform-settings.json per le categorie di verifica e i messaggi di evento, è necessario riavviare l'istanza di ThingWorx Platform. Questo tipo di modifica deve essere eseguito il più raramente possibile. |
La sezione Audit deve essere inserita come nodo di pari livello alla voce JSON di PlatformSettingsConfig. Può essere inserita prima o dopo il nodo PlatformSettingsConfig ma deve trovarsi allo stesso livello di nodo. |