Monitorare l'accesso dell'agente a SharePoint e OneDrive

Il report di Agent Access Insights fornisce agli amministratori di SharePoint informazioni dettagliate sul modo in cui gli agenti accedono al contenuto in tutti i siti di SharePoint e OneDrive nell'organizzazione. Il report include tutti gli agenti registrati e attivati, ad esempio agenti di SharePoint, agenti dichiarativi, agenti personalizzati e altro ancora. Con questo report è possibile vedere come gli agenti interagiscono con il contenuto, i modelli di accesso spot e la distribuzione degli agenti tra siti. Usare queste informazioni dettagliate per rafforzare la sicurezza e applicare controlli di governance come il controllo degli accessi con restrizioni e l'individuazione di contenuto con restrizioni.

Agent Access Insights usa i log di controllo unificati di Microsoft 365 per tenere traccia del modo in cui gli agenti accedono ai siti di SharePoint e agli account di OneDrive. Questi log acquisiscono segnali come la lettura, la ricerca e l'interazione con il contenuto, offrendo una visualizzazione chiara dell'attività dell'agente.

È possibile generare e gestire il report di Agent Access Insights in SharePoint Amministrazione Center o usando SharePoint Online Management Shell.

Cosa serve per ottenere informazioni dettagliate sull'accesso degli agenti a SharePoint e OneDrive?

Quali sono i requisiti di licenza?

L'organizzazione deve avere la licenza corretta e soddisfare determinate autorizzazioni o ruoli amministrativi per usare la funzionalità descritta in questo articolo.

In primo luogo, l'organizzazione deve avere una delle licenze di base seguenti:

• Office 365 E3, E5 o A5
• Microsoft 365 E1, E3, E5 o A5

Inoltre, è necessario avere Microsoft 365 Copilot licenza.

Nota

Ad almeno un utente dell'organizzazione deve essere assegnata una licenza Copilot (non è necessario che l'utente sia un amministratore di SharePoint). Se l'organizzazione dispone di una licenza Copilot e ad almeno una persona dell'organizzazione viene assegnata una licenza Copilot, gli amministratori di SharePoint ottengono automaticamente l'accesso alle funzionalità di gestione avanzata di SharePoint necessarie per la distribuzione copilot.

Requisiti di amministratore

È necessario essere un amministratore di SharePoint o avere autorizzazioni equivalenti.

Importante

Se non si dispone di una licenza di Gestione avanzata di Microsoft SharePoint, verrà richiesto di abilitare la raccolta dei dati, in modo che il prodotto inizi a raccogliere i dati di controllo pertinenti per compilare questo report. Una volta abilitati, i report possono essere generati 24 ore dopo e contenere dati dal punto di raccolta. I dati vengono archiviati per 28 giorni. Se non vengono generati report almeno una volta in tre mesi, la raccolta dei dati viene sospesa e deve essere nuovamente abilitata. Per abilitare la raccolta dei dati per questi report, vedere la sezione Raccolta dati per il report di Agent Access Insights in questo articolo.

Come accedere al report di Agent Access Insights in SharePoint Amministrazione Center?

1. Accedere all'interfaccia di amministrazione di SharePoint con le credenziali di amministratore di SharePoint per l'organizzazione.
2. Nel riquadro di spostamento a sinistra espandere Report e selezionare Agent Insights.
3. Selezionare Accesso agente.
4. Esaminare i dettagli del report, inclusi l'attività dell'agente, i modelli di accesso e la distribuzione del sito.

Come creare report di accesso dell'agente in SharePoint Amministrazione Center

1. Nella pagina Agent Insights selezionare Crea un report.
2. Specificare un nome del report e specificare la durata del report (1, 7, 14 o 28 giorni).
3. Selezionare Crea ed esegui.

Nota

È possibile creare report per gli ultimi 1, 7, 14 o 28 giorni. I dati precedenti a 28 giorni vengono automaticamente implementati.

Visualizzare lo stato del report di accesso dell'agente in SharePoint Amministrazione Center

Per verificare se un report è pronto o l'ultimo aggiornamento, vedere la colonna Stato .

Visualizzare i dettagli del report di accesso dell'agente in SharePoint Amministrazione Center

Quando un report è pronto, selezionarlo per visualizzare i dati. È possibile visualizzare i primi 100 siti che ospitano il numero più alto di agenti. È possibile cercare siti o filtrare in base al modello di sito e ai criteri di governance.

Visualizzare i primi 20 agenti per un sito specifico

Quando si seleziona un sito, è possibile visualizzare i primi 20 agenti che accedono al contenuto nel sito selezionato.

Visualizzare la distribuzione dell'agente tra siti

Nella pagina del report Accesso agente scegliere Agenti univoci trovati in Siti di SharePoint o Agenti univoci nell'account di OneDrive. Questa visualizzazione mostra il modo in cui gli agenti vengono distribuiti tra i siti dell'organizzazione. È possibile visualizzare rapidamente il numero di siti in ogni categoria di modelli di sito e il numero di agenti univoci che vi accedono.

Applicare i criteri di governance del contenuto dal report di accesso

È possibile applicare criteri di governance del contenuto nei siti dal report informazioni dettagliate sull'accesso. I criteri disponibili sono Limitare i criteri di accesso al sito e Limitare l'individuazione contenuto.

Importante

Dopo l'applicazione di un criterio al sito dal report informazioni dettagliate, lo stato dei criteri nel report esistente non verrà aggiornato. Per visualizzare lo stato aggiornato dei criteri nel sito, selezionare il criterio per visualizzare lo stato più recente o accedere al pannello Sito attivo ed esaminare le impostazioni del sito.

Come accedere al report di Agent Access Insights usando SharePoint Online Management Shell?

È possibile generare, controllare e gestire report di Agent Access Insights usando SharePoint Online Management Shell.

Prerequisiti

1. In caso contrario, scaricare e installare la versione più recente di SharePoint Online Management Shell.

2. Connettersi a SharePoint Online come amministratore di SharePoint in Microsoft 365. Per altre informazioni, vedere Introduzione a SharePoint Online Management Shell.

3. Per generare e visualizzare questi report, assicurarsi che l'organizzazione disponga della licenza del componente aggiuntivo gestione avanzata di SharePoint o della licenza Microsoft 365 Copilot.

Creare e visualizzare un report di Agent Access Insights con SharePoint Online Management Shell

Con le autorizzazioni di almeno un amministratore di SharePoint, è possibile generare e visualizzare il report di informazioni dettagliate usando i comandi seguenti:

1. Per generare un report per una durata predefinita del report di un giorno, eseguire il comando :

Start-SPOM365AgentAccessInsightsReport

Questo comando genera un report di Agent Access Insights per l'ultimo giorno per impostazione predefinita.

2. È possibile specificare una durata diversa (7, 14 o 28 giorni) usando il -ReportPeriodInDays parametro . Ad esempio, per creare un report per gli ultimi 28 giorni, eseguire:

Start-SPOM365AgentAccessInsightsReport -ReportPeriodInDays <28>

3. Per controllare lo stato di tutti i report attivi e disponibili, eseguire il comando :

Get-SPOM365AgentAccessInsightsReport

4. Per visualizzare i dettagli di un report specifico, eseguire il comando :

Get-SPOM365AgentAccessInsightsReport -ReportId <ReportId>

Sostituire <ReportId> con l'ID report effettivo ottenuto dal comando precedente.

5. Per scaricare e visualizzare il report, eseguire il comando :

Export-SPOM365AgentAccessInsightsReport -ReportId <ReportId> -Action Download

Nota

PowerShell visualizza fino a 100 siti, ma i report scaricati possono contenere fino a 1 milione di siti.

Export-SPOM365AgentAccessInsightsReport -ReportId <ReportId> -View Download

Sostituire <ReportId> con l'ID report effettivo.

6. È anche possibile visualizzare informazioni dettagliate riepilogate degli agenti in tutti i tipi di sito eseguendo il comando :

Get-SPOM365AgentAccessInsightsReport –ReportId -Content SiteDistribution

Distribuzione siti: fornisce la visualizzazione riepilogativa degli agenti in tutti i tipi di siti, ad esempio siti di comunicazione, siti connessi a gruppi di Microsoft 365, account OneDrive e altro ancora.

Raccolta dati per il report di Agent Access Insights

Se non si dispone di una licenza di Gestione avanzata di Microsoft SharePoint, verrà richiesto di abilitare la raccolta dati. Questa sezione illustra come abilitare e controllare lo stato per la raccolta dei dati per il report di Agent Access Insights.

Abilitare la raccolta dati

Questo comando di PowerShell avvia la raccolta dei dati di controllo per i report sulle attività del giorno precedente:

Start-SPOAuditDataCollectionForActivityInsights –ReportEntity M365AgentInsights

Controllare lo stato della raccolta dati

Una volta abilitata la raccolta dati, i report possono essere generati dopo 24 ore. Per verificare se è possibile generare report, usare il comando di PowerShell:

Get-SPOAuditDataCollectionStatusForActivityInsights -ReportEntity M365AgentInsights

Il comando restituisce lo stato corrente della raccolta dati, che può essere "NotInitiated", "InProgress" o "Paused". I report possono essere generati quando lo stato è "InProgress".

Esperienze note con Microsoft 365 Agent Access Insights

Ecco alcune importanti esperienze note da tenere presenti quando si usano i report di Agent Access Insights in SharePoint Amministrazione Center o SharePoint Online Management Shell:

• È possibile eseguire nuovamente un report solo dopo 24 ore dalla generazione dell'ultimo report.

• Per i tenant di grandi dimensioni, la disponibilità dei dati può richiedere fino a 48 ore.

• Può esistere un solo report per ogni valore dell'intervallo di report (1, 7, 14 o 28 giorni). Ciò significa che è possibile visualizzare un massimo di quattro report in un determinato punto.

• Quando si genera un nuovo report per lo stesso intervallo di date, sostituisce il report precedente. Per mantenere il report precedente, scaricarlo prima di crearne uno nuovo.

• I report usano i dati di controllo unificati di Microsoft 365, che potrebbero non includere tutti gli eventi di controllo.

Articoli correlati

• Gestire l'accesso agli agenti di SharePoint
• Informazioni dettagliate sugli agenti di SharePoint
• Limitare l'accesso al sito di SharePoint con gruppi di Microsoft 365 e gruppi di sicurezza Microsoft Entra
• Limitare l'individuazione di siti e contenuti di SharePoint