Vai al contenuto

Pronto a creare con AnyBot?

Documentazione AnyBot
Team e sicurezza

Registro di controllo

Un registro a sola aggiunta e a prova di manomissione di ogni azione che modifica lo stato nel tuo spazio, con confronti prima/dopo a livello di campo, e gli indirizzi IP mai esposti.

Il registro di controllo risponde a una sola domanda sul tuo spazio: chi ha fatto cosa, quando e su cosa. Ogni azione che modifica lo stato, creare un agente, cambiare il ruolo di un membro, connettere un'integrazione, eliminare conoscenza, scrive una voce immutabile. AnyBot riconosce 559 azioni in tutta la piattaforma, quindi la copertura è l'intera superficie, non una selezione dei momenti salienti.

Anatomia di una voce

Ogni riga registra la stessa struttura, così qualsiasi azione si legge allo stesso modo:

CampoCosa cattura
AttoreIl membro che l'ha eseguita, oppure l'agente / sistema per gli eventi automatizzati e attivati da callback
Marca temporaleQuando è successo
AmbitoLo spazio, e lo specifico agente quando l'azione riguarda un agente
AzioneUn namespace.verb canonico (es. space.member_updated) più un'etichetta in linguaggio semplice
EntitàCosa è stato toccato, un agente, un membro, un'integrazione, un lead, un file
ModificaUn confronto prima / dopo a livello di campo, solo i nomi dei campi e valori sicuri
Sensibilitàhigh · med · low, così puoi filtrare per le azioni che contano
Esitosuccess · failed · denied · neutral
ClientUn riepilogo approssimativo di browser / OS / dispositivo, visibile solo a proprietari e amministratori

Cosa copre

Le azioni sono raggruppate in domini per cui puoi filtrare: agenti, conoscenza, integrazioni e canali, inbox e conversazioni, CRM e lead, social, prodotti, riunioni, telefonia, calendario, landing page e governance (membri, ruoli, spazi, fatturazione, sicurezza, esportazioni). Se un'operazione modifica lo stato, creare, aggiornare, eliminare, concedere, revocare, connettere, pubblicare, accedere, cambiare una password, è progettata per lasciare una traccia. Quella copertura è imposta nel codice: una nuova azione che modifica lo stato e che viene rilasciata senza una scrittura nel registro non supera un controllo interno.

Come si collegano i pezzi

Ogni azione appartiene a un'entità, e ogni entità a un dominio. Sensibilità ed esito derivano dall'azione stessa, non memorizzati in modo approssimativo, così lo stesso classificatore guida le etichette, i livelli colorati e i filtri. Ecco perché filtrare per "alta sensibilità, esito negato, governance" restituisce esattamente gli eventi rilevanti per la sicurezza e nient'altro.

Prova di manomissione

Il registro è più che a sola aggiunta. Ogni nuova voce viene sigillata in una catena di hash: il suo hash è sha256(entry-contents | previous entry's hash). Poiché ogni voce incorpora quella precedente, modificare o eliminare qualsiasi riga storica cambia il suo hash e rompe ogni hash successivo, cosa che un controllo di integrità rileva e localizza con precisione. La sigillatura è fail-open: non può mai bloccare o rallentare l'azione registrata, e le voci scritte prima del rilascio della funzionalità della catena sono onestamente segnalate come pre-catena invece di essere considerate attendibili in silenzio.

Privacy: cosa viene oscurato

Il registro di controllo è costruito per essere sicuro da leggere:

  • Gli indirizzi IP non sono mai esposti attraverso l'API del registro, per progettazione, nemmeno a proprietari e amministratori. Vengono catturati per il registro, non mostrati.
  • Gli user agent sono ridotti a un'etichetta approssimativa di browser / OS / dispositivo. Nessuna impronta digitale.
  • Segreti e PII non entrano mai in una voce. Un cambio di password, un token, una credenziale API o un record di consenso viene registrato per nome del campo e un confronto sicuro, mai il valore.

Esempio pratico

Un membro del team promuove un altro membro da membro a amministratore. Viene scritta una voce:

  • Azione, space.member_updated · etichetta "Modificato il ruolo/le autorizzazioni di un membro"
  • Sensibilità, high · Esito, success
  • Attore, il membro che promuove · Entità, il membro promosso
  • Modifica, role: member → admin
  • Marca temporale + client approssimativo (vista proprietario/amministratore)

Più tardi, un operatore apre quel record dalla console di amministrazione. Poiché è ad alta sensibilità, l'atto stesso di visualizzarlo viene registrato (audit_log.viewed), il registro controlla i propri controllori. (Questa auto-registrazione scatta nel pannello operatore/amministratore, non nella vista del registro all'interno dello spazio.)

Chi può leggerlo

La lettura del registro di controllo è regolata dall'autorizzazione view_audit_log. I proprietari e gli amministratori la possiedono sempre; ai membri e ai visualizzatori può essere concessa individualmente tramite la matrice delle autorizzazioni, uno schema comune per un revisore della conformità che ha bisogno della traccia ma di nessun altro potere amministrativo.

FAQ

Una voce può essere modificata o rimossa? No. Il registro è a sola aggiunta, e la catena di hash rende rilevabile qualsiasi modifica a posteriori.

Perché non riesco a vedere chi ha fatto qualcosa prima che entrassimo? Le voci precedenti alla catena attuale sono contrassegnate come pre-catena; la garanzia di prova di manomissione inizia dalla prima voce sigillata dopo il rilascio della funzionalità.

L'agente compare come attore? Sì, gli eventi automatizzati e attivati da callback sono attribuiti all'agente/sistema anziché a una persona, così le modifiche guidate dal bot non vengono mai scambiate per azioni umane.

Avanti