Puoi utilizzare l'API Activity per accedere ai dati di base dei rapporti in modo programmatico. Se la tua edizione di Google Workspace la supporta, puoi utilizzare una nuova API Reports per accedere ai dati dei rapporti Google Workspace avanzati.
Importante:
- Non tutte le attività su Drive vengono registrate nei log. Per un elenco di cosa è incluso nel log, vedi Eventi registrati e non registrati nei log in questa pagina.
- Per maggiori dettagli sul momento in cui i dati diventano disponibili e sulla durata per cui vengono conservati, vedi Conservazione dei dati e tempi di attesa.
- Gli eventi di controllo di Drive vengono registrati solo per i file di proprietà degli utenti che utilizzano le versioni supportate.Le eccezioni sono gli eventi con accesso tramite URL, che vengono registrati quando l'utente che avvia uno script di Apps Script che accede a un URL fa parte della tua organizzazione e utilizza una versione supportata.
Your access to log events
- Your ability to run a search depends on your Google edition, your administrative privileges, and the data source. You can run a search on all users, regardless of their Google Workspace edition.
- Your Workspace subscription provides access to the log events using either the Audit & investigation tool or the Security center.
- Premium Google Workspace editions (Enterprise Plus, Enterprise Standard, or Education Plus) provide access to the Security Center and the more advanced features of the security investigation tool. The investigation tool enables super admins to identify, triage, and take action on security and privacy issues. For details, see About the security investigation tool.
- All other Google Workspace editions can access the logs using the Audit and Investigation tool. For details, see About the audit and investigation page.
Inoltrare i dati sugli eventi dei log a Google Cloud
Puoi attivare la condivisione dei dati sugli eventi dei log con Google Cloud. Se attivi la condivisione, i dati vengono inoltrati a Cloud Logging, dove puoi eseguire query sui log, visualizzarli e controllarne le modalità di routing e di archiviazione.
Eseguire una ricerca di eventi del log
Audit and investigation tool
To run a search for log events, first choose a data source. Then choose one or more filters for your search.
-
Accedi alla Console di amministrazione Google.
Accedi utilizzando l'account amministratore (che non termina con @gmail.com).
-
Nella Console di amministrazione, vai a Menu
Report
Controllo e indagine
- Fai clic su Aggiungi un filtro, quindi seleziona un attributo.
- Nella finestra popup, seleziona un operatore(Facoltativo) Per creare più filtri per la ricerca:
- Fai clic su Aggiungi un filtro e ripeti il passaggio 3.
- (Facoltativo) Per aggiungere un operatore di ricerca, sopra Aggiungi un filtro, seleziona AND oppure OR.
- (Optional) To create multiple filters for your search, repeat this step.
- (Optional) To add a search operator, above Add a filter, select AND or OR
- Fai clic su Cerca.
-
Nota:utilizzando la scheda Filtro, puoi includere semplici coppie di parametri e valori per filtrare i risultati di ricerca. Puoi anche utilizzare la scheda Generatore di condizioni, in cui i filtri sono rappresentati come condizioni con gli operatori AND/OR.
Security investigation tool
Per eseguire una ricerca nello strumento di indagine, scegli innanzitutto un'origine dati. Poi scegli una o più condizioni per la ricerca. Per ogni condizione, scegli un attributo, un operatore e un valore.
-
Accedi alla Console di amministrazione Google.
Accedi utilizzando l'account amministratore (che non termina con @gmail.com).
-
Nella Console di amministrazione, vai al Menu
Sicurezza
- Click Data source and select Admin log events.
- Fai clic su Aggiungi condizione.
Suggerimento: puoi includere una o più condizioni nella ricerca oppure personalizzarla con query nidificate. Per maggiori dettagli, vedi Personalizzare la ricerca con query nidificate. - Fai clic su Attributo
Per un elenco completo degli attributi, consulta la sezione Descrizioni degli attributi di seguito. - Fai clic su Contiene
- Inserisci un valore o selezionane uno dall'elenco a discesa.
- (Facoltativo) Per aggiungere altre condizioni di ricerca, ripeti i passaggi da 4 a 7.
- Fai clic su Cerca.
Nello strumento di indagine, i risultati di ricerca sono visualizzati in una tabella nella parte inferiore della pagina. - (Facoltativo) Per salvare la tua indagine, fai clic su Salva
Nota:
- Nella scheda Generatore di condizioni, i filtri sono rappresentati come condizioni con gli operatori AND/OR. Puoi anche utilizzare la scheda Filtro per includere semplici coppie di parametri e valori per filtrare i risultati della ricerca.
- Se hai assegnato un nuovo nome a un utente, le query in cui è utilizzato il suo nome precedente non restituiranno risultati. Ad esempio, se rinomini NomePrecedente@example.com in NuovoNome@example.com, non verranno restituiti risultati per gli eventi correlati a NomePrecedente@example.com.
Descrizioni degli attributi
Per questa origine dati, puoi utilizzare i seguenti attributi durante la ricerca dei dati sugli eventi di log:
Nota:
- Non tutti gli attributi nel seguente elenco vengono segnalati per tutti gli eventi.
- Il seguente elenco non è esaustivo ed è soggetto a modifiche. Per maggiori dettagli sugli eventi dei log di Drive, vai a Eventi dell'attività di controllo di Drive sul sito web dell'SDK Admin di Google Workspace.
| Attributo | Descrizione |
|---|---|
| Attore | Indirizzo email dell'utente che ha eseguito l'azione. Gli utenti esterni al dominio sono visualizzati come utenti anonimi, tranne se visualizzano o modificano un documento che è stato condiviso esplicitamente con loro (in qualità di singoli utenti o di membri di un gruppo specifico). |
| Nome del gruppo dell'attore |
Il nome del gruppo dell'attore. Per saperne di più, vedi Filtrare i risultati per gruppo Google. Per aggiungere un gruppo alla lista consentita dei gruppi filtro:
|
| Unità organizzativa che ha eseguito l'azione | Unità organizzativa dell'attore |
| Metodo API | Per le azioni Download e Contenuti degli elementi a cui si accede che si verificano tramite un'app di terze parti, il metodo API utilizzato dall'azione, ad esempio drive.files.export. |
| ID applicazione | ID client OAuth dell'app di terze parti che ha eseguito l'azione |
| Nome dell'app | L'app che ha eseguito l'azione |
| Pubblico | Dominio di destinazione nel caso in cui il log di controllo sia interessato da una modifica alla visibilità |
| Fatturabile | (Solo per la versione Essentials) Indica se l'azione dell'utente è un'attività soggetta a fatturazione- |
| Data |
La data e l'ora in cui si è verificato l'evento, riportati nel fuso orario predefinito del browser. Nota: la maggior parte degli eventi viene registrata non appena è completata. A volte l'inserimento nei log di caricamenti di grandi dimensioni può richiedere del tempo. |
| ID documento |
Identificatore univoco dell'elemento di Drive associato all'attività, come memorizzato nel link URL del file. Nota: per gli eventi Accesso tramite URL, l'ID documento e altri campi relativi ai file, come il tipo di documento e il proprietario, vengono registrati solo per determinate azioni. Per i dettagli, vedi la sezione URL a cui è stato eseguito l'accesso in questa pagina. |
| Tipo di documento | Il formato di file previsto dall'attività, ad esempio Documenti, Fogli e Presentazioni Google, JPEG, PDF, PNG, MP4, Microsoft Word, Excel, PowerPoint, txt, HTML, audio MPEG, video QuickTime, cartella o Drive condivisi. |
| Dominio* | Il dominio in cui si è verificata l'azione |
| Criptato* | Indica se il file è criptato lato client |
| Nome evento |
Eventi avviati dall'utente, ad esempio Visualizza, Rinomina, Crea, Modifica, Stampa, Elimina, Carica e Scarica. La maggior parte delle azioni viene registrata nel log immediatamente. Tuttavia, gli eventi relativi a Stampa mediante il visualizzatore di Drive possono essere ritardati di 12 ore o più dal momento dell'evento. I file che vengono eliminati automaticamente da Google Drive o eliminati dal Cestino vengono registrati. Gli altri eventi, come il caricamento di un file, vengono registrati una volta completati. |
| Indirizzo IP* |
Indirizzo dal quale l'utente ha eseguito l'attività. Potrebbe trattarsi della posizione fisica dell'utente, ma anche, ad esempio, di un server proxy o un indirizzo VPN (Virtual Private Network, rete privata virtuale). Non viene registrato alcun indirizzo IP per:
|
| Nuovo valore della visibilità di pubblicazione | Nuova visibilità del documento |
| Nuovo valore* | Nuovo valore dell'impostazione modificata |
| ID nuovi valori* | Nuovo valore del campo Etichetta* |
| Valore della visibilità di pubblicazione precedente | Visibilità precedente del documento se l'attività è una modifica di visibilità |
| Valore precedente* | Valore precedente dell'impostazione modificata |
| ID valori precedenti* | Valore precedente del campo Etichetta |
| Proprietario |
Utente proprietario del file. |
| Visibilità precedente | Visibilità precedente del documento nel caso in cui la visibilità venga modificata |
| Destinatari* | Indirizzi email dei destinatari |
| ID Drive condiviso | L'ID Drive del Drive condiviso che contiene il file. Se il file non si trova in un Drive condiviso, questo campo non viene compilato. |
| Destinazione | Utente il cui accesso è stato modificato |
| Titolo | Titolo del documento. |
| Visibilità | Visibilità dell'elemento di Drive associato all'attività. |
| Modifica visibilità | Visibilità dell'elemento di Drive prima dell'attività |
| Visitatore | Sì significa che l'attività è stata eseguita da un utente non Google. No significa che l'attività è stata eseguita da un utente Google. Scopri di più sulla condivisione di documenti con i visitatori. |
Nota: se hai assegnato un nuovo nome a un utente, le query in cui è utilizzato il suo nome precedente non restituiranno risultati. Ad esempio, se rinomini NomePrecedente@example.com in NuovoNome@example.com, non verranno restituiti risultati per gli eventi correlati a NomePrecedente@example.com.
Visualizzare i file condivisi al di fuori di un dominio
Per vedere i file condivisi con utenti al di fuori di un dominio:
Pagina di controllo e indagine
- Apri gli eventi del log come descritto in Aprire i dati sugli eventi del log di Drive.
- Fai clic su Aggiungi un filtro
- Fai clic su Cerca.
Se disattivi la condivisione esterna e un utente condivide una risorsa con un gruppo in cui sono ammessi gli utenti esterni, i dati vengono contrassegnati come Condiviso esternamente nel log, anche se il gruppo non ha utenti esterni. Tuttavia, gli utenti esterni del gruppo non potranno accedere alla risorsa condivisa.
Strumento di indagine sulla sicurezza
-
Accedi alla Console di amministrazione Google.
Accedi utilizzando l'account amministratore (che non termina con @gmail.com).
-
Nella Console di amministrazione, vai al Menu
- Fai clic su Origine dati
- Fai clic su Aggiungi condizione.
- Fai clic su Attributo
- Fai clic su Contiene
- Fai clic su Visibilità
- Fai clic su Cerca.
Nello strumento di indagine, i risultati di ricerca sono visualizzati in una tabella nella parte inferiore della pagina.
Se disattivi la condivisione esterna e un utente condivide una risorsa con un gruppo in cui sono ammessi gli utenti esterni, nel log i dati avranno la dicitura Condiviso esternamente. Tuttavia, gli utenti esterni del gruppo non potranno accedere alla risorsa condivisa. Inoltre, questo si verificherà anche se il gruppo non contiene utenti esterni.
Eventi registrati e non registrati nei log
Eliminazione
I file che vengono eliminati automaticamente da Google Drive o eliminati dal Cestino vengono registrati.
Copia
Quando un file viene copiato, vengono registrati gli eventi Crea e Copia per il nuovo file, mentre per il file originale viene registrato un evento Copia di origine.
Quando un utente esterno all'organizzazione copia un file in una posizione esterna, l'organizzazione non registra gli eventi Crea e Copia perché il nuovo file è esterno. Tuttavia, i log presentano l'evento Copia di origine nel file originale con un Tipo di copia impostato su Esterno. Per monitorare quando i dati vengono copiati al di fuori dell'organizzazione, puoi esaminare gli eventi Copia di origine che hanno un tipo di copia Esterno.
Stampa
Gli eventi Stampa non vengono registrati quando un utente stampa un file aperto in un formato file Google (Documenti, Fogli, Presentazioni, Disegni e Moduli).
Quando stampi i file utilizzando l'app Drive da un iPhone o iPad Apple o da un dispositivo Android, gli eventi Stampa potrebbero essere registrati come eventi di Download.
Download
La maggior parte dei download viene registrata, anche quando i file vengono copiati tra Drive e un dispositivo locale utilizzando Google Drive per desktop.
Alcune azioni Visualizzazione vengono registrate come download:
- L'anteprima di un file nell'app Drive su un dispositivo mobile viene registrata come evento Download.
- L'anteprima di un file, ad esempio un PDF, che non può essere aperto direttamente in Documenti Google o in un'altra app Google viene registrata come evento Download .
I download dalle seguenti origini non vengono inclusi nel log:
- Download di Google Takeout (cerca invece gli eventi del log Takeout)
- Download nella cache del browser offline
- Foto sincronizzate per il download da o la visualizzazione in Google Foto
- Elementi di Drive inviati come allegati email e scaricati mediante il client di posta del destinatario
Contenuti dell'elemento a cui è stato eseguito l'accesso
È possibile accedere ai file per conto degli utenti tramite un'app che utilizza un'API Google Workspace, come l'API Google Drive o l'API Google Fogli. Queste azioni non vengono registrate come eventi di download o visualizzazione, ma solo come accesso ai contenuti degli articoli.
Gli eventi di accesso ai contenuti degli elementi non vengono registrati quando un file viene visualizzato o aperto da un utente in Drive per il web, Drive su dispositivo mobile o nell'app Drive per computer.
Visualizza
- La visualizzazione di file con gli URL speciali /htmlview, /embed, /revisions e altri viene ora registrata come evento Visualizzazione.
Accesso all'URL
Gli eventi Accesso tramite URL vengono registrati quando uno script di Apps Script accede a un URL, compreso il momento in cui lo script viene eseguitoDashboard di Apps Script, eseguito come componente aggiuntivo o eseguito come funzione personalizzata in Fogli. Gli eventi accessibili all'URL non vengono registrati quando un utente fa clic su un link in un file.
Gli attributi segnalati dipendono da come è stato eseguito lo script e da chi ne è il proprietario:
- Quando uno script viene eseguito come funzione personalizzata, l'ID documento e altri attributi relativi al documento riflettono il foglio in cui la funzione è stata richiamata.
- Quando uno script non viene eseguito come funzione personalizzata, gli attributi relativi al documento non vengono segnalati.
- L'ID script viene indicato se lo script Apps Script è di proprietà della tua organizzazione.
URL di importazione di Fogli
La chiamata di una funzione di importazione di Fogli, che accede a un URL, viene registrata come un evento URL di importazione di Fogli. Viene registrato un evento quando i contenuti del foglio vengono modificati da un aggiornamento automatico o quando un utente apre il foglio.
Eventi che coinvolgono domini esterni
Alcuni eventi coinvolgono utenti, cartelle condivise o Drive condivisi all'esterno dell'organizzazione, ad esempio quando un utente dell'organizzazione condivide un file con un utente esterno. Entrambe le organizzazioni registrano un evento quando la proprietà di un elemento passa da un'organizzazione a un'altra.
Esempi di eventi registrati da entrambe:
- Un elemento di Drive di proprietà di un utente della tua organizzazione viene spostato in un Drive condiviso esterno.
- Un elemento di Drive di proprietà di un utente esterno all'organizzazione viene spostato in un Drive condiviso di proprietà della tua organizzazione.
- Un utente copia un file all'interno o all'esterno della tua organizzazione. L'organizzazione di destinazione registra il nome del file copiato, non quello del file originale.
Esempi di eventi registrati dalla tua organizzazione, ma non dal dominio esterno:
- Un elemento di Drive di proprietà di un utente della tua organizzazione viene condiviso con un utente esterno.
- Un elemento di Drive di proprietà di un utente della tua organizzazione viene condiviso con un gruppo che consente gli utenti esterni, anche se nessun utente esterno fa parte del gruppo.
- Un utente esterno visualizza, modifica, scarica, stampa o elimina un elemento di Drive di proprietà della tua organizzazione.
- Un utente esterno carica un file su un Drive condiviso di proprietà della tua organizzazione.
Gli eventi registrati dal dominio esterno, ma non dalla tua organizzazione, funzionano al contrario rispetto alla sezione precedente.
Utenti anonimi ed esterni
Per gli utenti anonimi (utenti che non hanno eseguito l'accesso a un account Google), vengono registrate le modifiche, ma non le visualizzazioni e i download.
Le azioni eseguite da utenti esterni al dominio vengono mostrate come anonime, tranne quando l'elemento viene condiviso esplicitamente con loro (in qualità di singoli utenti o di membri di un gruppo specifico).
L'accesso anonimo ed esterno può essere limitato dagli amministratori impostando i criteri di condivisione dell'organizzazione o i criteri delle regole di attendibilità.
Drive per computer
Quando i file vengono copiati tra Drive e un dispositivo locale utilizzando Google Drive per desktop, vengono registrati gli eventi Download.
Gestire i dati sugli eventi del log
Gestire i dati delle colonne dei risultati di ricerca
Puoi stabilire quali colonne di dati visualizzare nei risultati di ricerca.
- Nell'angolo in alto a destra della tabella dei risultati di ricerca, fai clic su Gestisci colonne
.
- (Facoltativo) Per rimuovere le colonne attualmente visualizzate, fai clic su Rimuovi
.
- (Facoltativo) Per aggiungere colonne, fai clic sulla Freccia giù
in corrispondenza di Aggiungi nuova colonna e seleziona la colonna di dati che ti interessa.
Ripeti queste operazioni in base alle necessità. - (Facoltativo) Trascina i nomi delle colonne per modificarne l'ordine.
- Fai clic su Salva.
Esportare i dati dei risultati di ricerca
- Nella parte superiore della tabella dei risultati di ricerca, fai clic su Esporta tutto.
- Inserisci un nome
L'esportazione viene visualizzata al di sotto della tabella dei risultati di ricerca, in Risultati dell'azione Esporta. - Per visualizzare i dati, fai clic sul nome dell'esportazione.
L'esportazione si apre in Fogli Google.
Creare regole di reporting
Vai a Creare e gestire le regole di reporting.
Quando sono disponibili i dati? Per quanto tempo?
Adottare azioni basate sui risultati di ricerca
Adottare azioni basate sui risultati di ricerca
Dopo aver eseguito una ricerca nello strumento di indagine, puoi operare sui relativi risultati. Ad esempio, puoi eseguire una ricerca basata sugli eventi del log di Gmail e quindi utilizzare lo strumento di indagine per eliminare messaggi specifici, metterli in quarantena o inviarli nella Posta in arrivo degli utenti. Per maggiori dettagli sulle azioni che puoi eseguire nello strumento di indagine, vedi Adottare azioni basate sui risultati di ricerca.
Creare regole di attività e configurare avvisi
Per contribuire a prevenire, rilevare e risolvere in modo efficiente i problemi di sicurezza, puoi creare regole di attività per automatizzare azioni nello strumento di indagine e configurare avvisi. Per configurare una regola, imposta le sue condizioni e specifica quali azioni eseguire quando quelle condizioni sono soddisfatte. Per maggiori dettagli e istruzioni, vedi Creare e gestire regole di attività.
Gestire le indagini
Visualizzare il proprio elenco di indaginiPer visualizzare un elenco delle indagini di tua proprietà e di quelle che sono state condivise con te, fai clic su Visualizza indagini. L'elenco delle indagini ne include i nomi, le descrizioni e i proprietari, nonché la data dell'ultima modifica.
Da questo elenco puoi eseguire azioni sulle indagini di tua proprietà, ad esempio eliminare un'indagine. Seleziona la casella in corrispondenza di un'indagine, quindi fai clic su Azioni.
Nota: nella sezione Accesso rapido al di sopra dell'elenco delle indagini, puoi visualizzare le indagini salvate di recente.
Come super amministratore, puoi fare clic su Impostazioni per:
- Modificare il fuso orario per le indagini. Il fuso orario si applica alle condizioni e ai risultati di ricerca.
- Attivare o disattivare l'opzione Richiedi revisore. Per maggiori dettagli, vedi Richiedere revisori per azioni collettive.
- Attivare o disattivare l'opzione Visualizza i contenuti. Questa impostazione consente agli amministratori con i privilegi appropriati di visualizzare i contenuti.
- Attivare o disattivare l'opzione Abilita motivazione azione.
Per istruzioni e dettagli, vedi Configurare le impostazioni per le indagini.
Puoi stabilire quali colonne di dati visualizzare nei risultati di ricerca.
- Nell'angolo in alto a destra della tabella dei risultati di ricerca, fai clic su Gestisci colonne
- (Facoltativo) Per rimuovere le colonne attualmente visualizzate, fai clic su Rimuovi elemento
- (Facoltativo) Per aggiungere colonne, fai clic sulla Freccia giù
Ripeti questa operazione in base alle necessità. - (Facoltativo) Per modificare l'ordine delle colonne, puoi trascinarne il nome.
- Fai clic su Salva.
- Nella parte superiore della tabella dei risultati di ricerca, fai clic su Esporta tutto.
- Inserisci un nome
L'esportazione viene visualizzata al di sotto della tabella dei risultati di ricerca, in Risultati dell'azione Esporta. - Per visualizzare i dati, fai clic sul nome dell'esportazione.
L'esportazione si apre in Fogli Google.
Quando visualizzi i risultati di ricerca esportati, tieni presente quanto segue:
- Dopo aver fatto clic su Esporta tutto nella parte superiore della tabella, nella cartella Il mio Drive viene creato un foglio Google che contiene i risultati di ricerca. A seconda delle dimensioni dei risultati, il processo di esportazione potrebbe richiedere del tempo e potrebbero essere creati più fogli Google. Il numero complessivo dei risultati dell'esportazione è limitato a 30 milioni di righe (ad eccezione delle ricerche di messaggi Gmail, i cui risultati sono limitati a 1,25 milioni di righe).
- Mentre l'esportazione è in corso, ai fogli Google creati viene assegnato un nome provvisorio, ad esempio TMP-1-<titolo>. Se vengono creati più fogli Google, i file aggiuntivi saranno denominati TMP-2-<titolo>, TMP-3-<titolo> e così via. Al termine del processo di esportazione, i file vengono automaticamente rinominati <title> [1 di N], <title> [2 di N] e così via. Se i dati esportati sono contenuti in un solo foglio Google, il file viene rinominato <title>.
- Le autorizzazioni di condivisione per i file contenenti i risultati di ricerca esportati si riferiscono alla configurazione del tuo dominio. Ad esempio, se i file creati vengono condivisi con tutti gli utenti dell'azienda per impostazione predefinita, anche i dati esportati avranno la stessa visibilità.
Per condividere una ricerca con altri utenti o salvarne i criteri, puoi creare e salvare un'indagine e, successivamente, condividerla, duplicarla o eliminarla.
Per informazioni dettagliate, vedi Salvare, condividere, eliminare e duplicare le indagini.
Per saperne di più sulle origini dati, vedi Conservazione dei dati e tempi di attesa.
Gestire le indagini
Requires a versione premium di Google Workspace (Enterprise Standard, Enterprise Plus o Education Plus)
View your list of investigationsTo view a list of the investigations that you own and that were shared with you, click View investigations. The investigation list includes the names, descriptions, and owners of the investigations, and the date last modified.
From this list, you can take action on any investigations that you own—for example, to delete an investigation. Check the box for an investigation, and then click Actions.
Note: Directly above your list of investigations, under Quick access, you can view recently saved investigations.
As a super administrator, click Settings to :
- Change the time zone for your investigations. The time zone applies to search conditions and results.
- Turn on or off Require reviewer. For more details, go to Require reviewers for bulk actions.
- Turn on or off View content. This setting allows admins with the appropriate privileges to view content.
- Turn on or off Enable action justification.
For instructions and details, go to Configure settings for your investigations.
To save your search criteria or share it with others, you can create and save an investigation, and then share, duplicate, or delete it.
For details, go to Save, share, delete, and duplicate investigations.
