M365Con 2027 – conferenza online gratuita · 11–22 Jan 2027 · 120 sessions m365con.net

Blog · Mirko Peters

Graph Data Connect e autorizzazioni di Microsoft Graph spiegate: configurazione, consenso, privilegio minimo

Di ·

Che cosa fa Microsoft Graph Data Connect, in cosa si differenzia dalle API di Graph, i passaggi di configurazione e approvazione, e come funzionano le autorizzazioni di Graph (delegate, applicazione, consenso).

Tradotto automaticamente con l'IA dal post originale. Leggi l'originale in inglese

Microsoft Graph Data Connect e le autorizzazioni di Microsoft Graph sono due argomenti distinti che spesso vengono cercati insieme. Data Connect è un servizio di estrazione dati in blocco per l'analisi di Microsoft 365. Le autorizzazioni di Graph controllano ciò che un'app può fare tramite l'API di Graph. Entrambi si basano sul consenso e premiano la stessa buona abitudine: chiedere l'accesso minimo che serve per svolgere il lavoro.

Punti chiave

  • Graph Data Connect estrae in blocco i dati di Microsoft 365 in un archivio di Azure per l'analisi. Le API di Graph sono adatte a piccole quantità di dati provenienti da utenti e gruppi selezionati.
  • La configurazione richiede un Amministratore globale che la abiliti, una registrazione app in Entra, un account di archiviazione di Azure e l'approvazione amministrativa della richiesta di accesso ai dati.
  • Le pipeline comportano circa 45 minuti di overhead, e una prima esecuzione può superare i 40 minuti, consenso incluso.
  • Le autorizzazioni di Graph sono di due tipi. Le autorizzazioni delegate agiscono per conto di un utente che ha effettuato l'accesso. Le autorizzazioni di applicazione agiscono senza un utente e richiedono il consenso dell'amministratore.
  • Microsoft consiglia il modello delegato quando soddisfa le esigenze dell'app, e l'autorizzazione più ristretta che funziona.
  • I nomi delle autorizzazioni seguono lo schema {resource}.{operation}.{constraint}, come Application.ReadWrite.OwnedBy.

Cos'è Graph Data Connect

Microsoft descrive Data Connect come un accesso sicuro e scalabile ai set di dati di Microsoft 365 in Microsoft Fabric, Azure Synapse e Azure Data Factory, per l'analisi aziendale. I dati provengono da fonti come Microsoft Entra ID, Outlook, Teams, SharePoint, Viva Insights e i gruppi Microsoft.

I set di dati si dividono in tre gruppi: di base (contenuti grezzi creati dal cliente), puliti (normalizzati o privi di duplicati) e curati (creati per uno scenario specifico). L'elenco include, ad esempio, TeamsCallRecords_v1, SharePointPermissions_v1, GroupMembers_v0 e PlannerTasks_v0. I set di dati di Viva Insights richiedono una licenza Viva Insights, che è l'unica indicazione sulle licenze presente nella pagina dei set di dati.

Data Connect o API di Graph

Le domande frequenti su Data Connect la mettono così: entrambi raggiungono gli stessi dati sottostanti. Data Connect estrae grandi quantità di dati in blocco in tutta l'organizzazione. Le API di Graph sono adatte a piccole quantità di dati provenienti da utenti e gruppi selezionati. Le domande frequenti suggeriscono di combinarle, ad esempio Data Connect per l'estrazione iniziale e le API di Graph per il lavoro in tempo reale successivo.

Limiti noti dalle domande frequenti:

  • Le pipeline hanno un overhead di circa 45 minuti, indipendentemente dalle dimensioni dei dati.
  • Gli utenti di Exchange locali non sono supportati, incluse le configurazioni ibride.
  • Messaggi ed eventi degli account risorsa non sono supportati.
  • L'accesso ai set di dati tra tenant non è disponibile. Le risorse di Azure e Microsoft 365 devono trovarsi nello stesso tenant di Entra.

Passaggi di configurazione

La guida introduttiva illustra questi passaggi. I nomi dei menu sono quelli riportati da Microsoft.

  1. Abilita Data Connect. Accedi a admin.microsoft.com come Amministratore globale. Seleziona Impostazioni > Impostazioni dell'organizzazione, quindi, nella scheda Servizi, seleziona Microsoft Graph Data Connect. Seleziona l'opzione per attivarlo per l'intera organizzazione e salva.
  2. Crea l'applicazione in Entra. Nell'interfaccia di amministrazione di Microsoft Entra, vai su Registrazioni app > Nuova registrazione. Scegli «Solo account in questa directory dell'organizzazione». Copia l'ID applicazione (client) e l'ID tenant, crea un segreto client e salva subito il suo valore. Il proprietario dell'applicazione ha bisogno di una casella di posta e, secondo la guida rapida, di un abbonamento E5 funzionante.
  3. Crea Azure Storage. Crea un account di archiviazione in un'area che corrisponda a quella di Microsoft 365. Assegna all'applicazione il ruolo Storage Blob Data Contributor in Controllo di accesso (IAM) e crea un contenitore privato.
  4. Registra l'applicazione in Data Connect nel portale di Azure. Scegli la destinazione, l'applicazione e i set di dati e le colonne.
  5. Approva la richiesta. Un amministratore apre Impostazioni > Impostazioni organizzazione > Sicurezza e privacy > Applicazioni di Microsoft Graph Data Connect. L'applicazione mostra Pre-consenso. Verifica i set di dati e seleziona Approva. La guida rapida avverte che non è possibile approvare la propria richiesta.
  6. Esegui la pipeline in Synapse, Data Factory o Fabric. Lo stato passa da Initializing, Consent Pending, Extracting Data, Persisting Data a Succeeded. La prima esecuzione può richiedere più di 40 minuti.

Le destinazioni supportate includono Azure Data Lake Storage Gen2, Azure Storage Blob, Azure SQL DB (solo con data flow di mapping) e Microsoft Fabric OneLake. L'autenticazione con entità servizio è l'unico meccanismo supportato.

Consenso e costi

Il consenso copre l'ambito dell'estrazione: set di dati, colonne, utenti e destinazione. Un'esecuzione con lo stesso ambito non richiede una nuova richiesta. La fatturazione avviene tramite le sottoscrizioni di Azure, per esecuzione della pipeline, con le unità frazionarie arrotondate per eccesso. L'esempio delle domande frequenti: 20 esecuzioni da 500 righe ciascuna vengono fatturate come 20 unità, non 10. Le pagine lette non indicano le tariffe.

Autorizzazioni Graph: le basi

Per l'API Graph, Microsoft definisce due tipi di autorizzazioni.

| | Delegate | Applicazione | |---|---|---| | Agiscono | Per conto di un utente con accesso | Senza un utente | | Accesso effettivo | Limitato dalle autorizzazioni dell'app e da quelle dell'utente | Tutti i dati coperti dall'autorizzazione | | Chi può dare il consenso | Gli utenti, oppure gli amministratori per tutti gli utenti | Solo amministratore | | Altri nomi | Ambiti | Ruoli dell'app |

Il consenso per le autorizzazioni dell'applicazione richiede il ruolo Amministratore ruolo con privilegi o Amministratore globale. Il consenso dell'utente per le autorizzazioni delegate può comunque essere limitato dai criteri di consenso delle app del tenant.

Denominazione e privilegio minimo

Le autorizzazioni seguono il formato {resource}.{operation}.{constraint}. Gli esempi della pagina usano operazioni come Read e ReadWrite e vincoli come All e OwnedBy. Se non è indicato alcun vincolo, l'accesso è limitato ai dati di proprietà dell'utente con accesso. Ad esempio, Application.ReadWrite.OwnedBy gestisce solo le applicazioni create o possedute dall'app, mentre Application.ReadWrite.All gestisce tutte le applicazioni.

Le indicazioni di Microsoft: concedi il minimo di autorizzazioni necessario. Usa Directory.AccessAsUser.All, Directory.ReadWrite.All e Directory.Read.All con cautela e preferisci autorizzazioni più limitate. Il consenso specifico per risorsa permette a un utente di concedere l'accesso a una singola istanza di risorsa, come un team, anziché all'intero tenant. È supportato solo da un sottoinsieme di funzionalità.

Problemi comuni

  • La registrazione dell'agente di connettore non riesce. Learn indica che le autorizzazioni delegate non sono supportate per la registrazione dell'agente di connettore. Richiedi autorizzazioni applicative con privilegi minimi e concedi il consenso amministratore a livello di tenant.
  • I membri mostrano solo id e @odata.type. L'app non ha l'autorizzazione per leggere quel tipo di membro.
  • Troppe autorizzazioni su una sola app. Le app il cui pubblico di accesso include account Microsoft personali possono richiedere al massimo 30 autorizzazioni; i pubblici organizzativi possono richiederne fino a 400.

Ciò che la documentazione non dice

Le pagine di Data Connect lette non descrivono per quanto tempo un'approvazione resta valida e non indicano le tariffe. Non elencano inoltre i requisiti di licenza oltre alla configurazione di esempio della guida rapida.

Correlati

Fonti

FAQ

Qual è la differenza tra Graph Data Connect e l'API di Microsoft Graph?

Le domande frequenti su Data Connect di Microsoft Learn spiegano che entrambi danno accesso agli stessi dati sottostanti, ma in modi diversi. Data Connect è progettato per estrarre grandi quantità di dati in blocco per l'intera organizzazione, mentre le API di Graph sono adatte a piccole quantità di dati provenienti da utenti e gruppi selezionati.

Chi approva un'applicazione di Graph Data Connect?

Nella guida introduttiva di Microsoft, un amministratore approva la richiesta nell'interfaccia di amministrazione di Microsoft 365, in Impostazioni > Impostazioni dell'organizzazione > Sicurezza e privacy > Applicazioni di Microsoft Graph Data Connect. La guida precisa che non puoi approvare autonomamente le tue app.

Ogni esecuzione della pipeline richiede una nuova richiesta di consenso?

No. Secondo le domande frequenti su Data Connect, finché l'ambito resta lo stesso per set di dati, colonne, utenti e sink, un'esecuzione non richiede una nuova richiesta di consenso. È coperta anche l'esecuzione dello stesso ambito per date diverse.

Un'app deve usare autorizzazioni delegate o autorizzazioni di applicazione?

Microsoft Learn spiega che le autorizzazioni di applicazione hanno privilegi elevati e che, dal punto di vista del privilegio minimo, il modello delegato è consigliato ogni volta che soddisfa le esigenze dell'app. Le autorizzazioni di applicazione richiedono sempre il consenso dell'amministratore.

Entità in questo articolo

Temi di questo articolo:

Microsoft Graph Data Connect – Parte di Microsoft Graph Microsoft Graph permissions – Sottotema di Microsoft Graph Microsoft Graph – Strumento per sviluppatori di Microsoft

Articoli correlati

Altri articoli su temi correlati:

RSS