Graph Data Connect en Microsoft Graph-machtigingen uitgelegd: installatie, toestemming, minimale bevoegdheden
By Mirko Peters ·
Wat Microsoft Graph Data Connect doet, hoe het verschilt van de Graph API, de installatie- en goedkeuringsstappen, en hoe Graph-machtigingen (gedelegeerd, toepassing, toestemming) werken.
Automatically translated with AI from the original post. Read the English original
Microsoft Graph Data Connect en Microsoft Graph-machtigingen zijn twee afzonderlijke onderwerpen die vaak samen worden gezocht. Data Connect is een dienst voor bulkextractie van data voor Microsoft 365-analyses. Graph-machtigingen bepalen wat een app via de Graph API mag doen. Beide draaien op toestemming, en beide belonen dezelfde gewoonte: vraag de minimale toegang die het werk klaarspeelt.
Belangrijkste punten
- Graph Data Connect extraheert Microsoft 365-data in bulk naar Azure-opslag voor analyses. De Graph API is geschikt voor kleine hoeveelheden data van geselecteerde gebruikers en groepen.
- Voor de installatie heb je een Global Administrator nodig om het in te schakelen, een app-registratie in Entra, een Azure Storage-account en een beheerdersgoedkeuring van de aanvraag voor gegevenstoegang.
- Pipelines hebben ongeveer 45 minuten overhead, en een eerste uitvoering kan inclusief toestemming meer dan 40 minuten duren.
- Graph-machtigingen komen in twee typen. Gedelegeerde machtigingen handelen namens een aangemelde gebruiker. Toepassingsmachtigingen handelen zonder gebruiker en vereisen beheerderstoestemming.
- Microsoft beveelt het gedelegeerde model aan zodra het aan de behoeften van de app voldoet, en de kleinste machtiging die werkt.
- Machtigingsnamen volgen het patroon {resource}.{operation}.{constraint}, zoals Application.ReadWrite.OwnedBy.
Wat Graph Data Connect is
Microsoft omschrijft Data Connect als veilige, schaalbare toegang tot Microsoft 365-datasets in Microsoft Fabric, Azure Synapse en Azure Data Factory, voor analyses in ondernemingen. De data komt van bronnen zoals Microsoft Entra ID, Outlook, Teams, SharePoint, Viva Insights en Microsoft-groepen.
Datasets vallen in drie groepen: basic (ruwe, door klanten gemaakte content), cleaned (genormaliseerd of ontdubbeld) en curated (gebouwd voor een specifiek scenario). De datasetlijst bevat bijvoorbeeld TeamsCallRecords_v1, SharePointPermissions_v1, GroupMembers_v0 en PlannerTasks_v0. Viva Insights-datasets vereisen een Viva Insights-licentie; dat is de enige licentievermelding op de datasetpagina.
Data Connect of Graph API
De Data Connect-FAQ stelt het zo: beide bereiken dezelfde onderliggende data. Data Connect extraheert grote hoeveelheden in bulk over de organisatie heen. De Graph API's zijn geschikt voor kleine hoeveelheden data van geselecteerde gebruikers en groepen. De FAQ adviseert om ze te combineren, bijvoorbeeld Data Connect voor de initiële extractie en daarna Graph API's voor realtime werk.
Bekende beperkingen uit de FAQ:
- Pipelines hebben een overhead van ongeveer 45 minuten, ongeacht de datagrootte.
- Exchange on-premises-gebruikers worden niet ondersteund, ook niet in hybride opstellingen.
- Berichten en gebeurtenissen van resourceaccounts worden niet ondersteund.
- Toegang tot datasets over tenants heen is niet beschikbaar. Azure-resources en Microsoft 365 moeten in dezelfde Entra-tenant staan.
Installatiestappen
De snelstartgids doorloopt deze stappen. Menunamen zijn overgenomen zoals Microsoft ze vermeldt.
- Schakel Data Connect in. Meld je aan op admin.microsoft.com als Global Administrator. Selecteer Instellingen > Organisatie-instellingen, selecteer vervolgens op het tabblad Services de optie Microsoft Graph Data Connect. Vink de optie aan om het voor de hele organisatie in te schakelen en sla op.
- Maak de Entra-toepassing aan. Ga in het Microsoft Entra-beheercentrum naar App-registraties > Nieuwe registratie. Kies "Accounts in deze organisatiemap alleen." Kopieer de toepassings-id (client) en de tenant-id, maak een clientgeheim aan en sla de waarde meteen op. De eigenaar van de toepassing heeft een mailbox nodig en, volgens de quickstart, een actief E5-abonnement.
- Maak Azure Storage aan. Maak een opslagaccount aan in een regio die overeenkomt met je Microsoft 365-regio. Ken de toepassing de rol Storage Blob Data Contributor toe onder Toegangsbeheer (IAM) en maak een privécontainer aan.
- Registreer de toepassing bij Data Connect in de Azure-portal. Kies de bestemming, de toepassing en de datasets en kolommen.
- Keur het verzoek goed. Een beheerder opent Instellingen > Organisatie-instellingen > Beveiliging en privacy > Microsoft Graph Data Connect-toepassingen. De toepassing toont Pre-consent. Controleer de datasets en selecteer Goedkeuren. De quickstart waarschuwt dat je het verzoek niet zelf kunt goedkeuren.
- Voer de pipeline uit in Synapse, Data Factory of Fabric. De status doorloopt Initializing, Consent Pending, Extracting Data, Persisting Data en Succeeded. De eerste run kan langer dan 40 minuten duren.
Ondersteunde sinks zijn onder meer Azure Data Lake Storage Gen2, Azure Storage Blob, Azure SQL DB (alleen mapping data flows) en Microsoft Fabric OneLake. Serviceprincipal-authenticatie is het enige ondersteunde mechanisme.
Toestemming en kosten
Toestemming geldt voor het bereik van de extractie: datasets, kolommen, gebruikers en sink. Een run met hetzelfde bereik heeft geen nieuw verzoek nodig. Facturering verloopt via Azure-abonnementen, per pipeline-run, waarbij gedeeltelijke eenheden naar boven worden afgerond. Het voorbeeld uit de FAQ: 20 runs van elk 500 rijen worden gefactureerd als 20 eenheden, niet als 10. De gelezen pagina's vermelden geen tarieven.
Graph-machtigingen: de basis
Voor de Graph API definieert Microsoft twee soorten machtigingen.
| | Gedelegeerd | Toepassing | |---|---|---| | Handelt | Namens een aangemelde gebruiker | Zonder gebruiker | | Effectieve toegang | Beperkt door de machtigingen van de app en die van de gebruiker zelf | Alle gegevens die de machtiging omvat | | Wie kan toestemming geven | Gebruikers, of beheerders voor alle gebruikers | Alleen beheerder | | Andere namen | Scopes | App-rollen |
Toestemming voor toepassingsmachtigingen vereist de rol Privileged Role Administrator of Global Administrator. Gebruikerstoestemming voor gedelegeerde machtigingen kan nog steeds worden beperkt door beleid voor app-toestemming van de tenant.
Naamgeving en least privilege
Machtigingen volgen het patroon {resource}.{operation}.{constraint}. De voorbeelden op de pagina gebruiken bewerkingen zoals Read en ReadWrite en beperkingen zoals All en OwnedBy. Als er geen beperking is opgegeven, is de toegang beperkt tot gegevens die eigendom zijn van de aangemelde gebruiker. Application.ReadWrite.OwnedBy beheert bijvoorbeeld alleen toepassingen die de app zelf heeft aangemaakt of waarvan hij eigenaar is, terwijl Application.ReadWrite.All ze allemaal beheert.
Het advies van Microsoft: verleen de minimaal benodigde machtiging. Gebruik Directory.AccessAsUser.All, Directory.ReadWrite.All en Directory.Read.All met voorzichtigheid en geef de voorkeur aan minder vergaande machtigingen. Resource-specifieke toestemming laat een gebruiker toegang verlenen tot één resource-exemplaar, zoals een team, in plaats van de hele tenant. Dat wordt maar door een deel van de functies ondersteund.
Veelvoorkomende problemen
- Registratie van de connector-agent mislukt. Learn meldt dat gedelegeerde machtigingen niet worden ondersteund voor registratie van de connector-agent. Vraag toepassingsmachtigingen met minimale rechten aan en verleen tenantbrede beheerderstoestemming.
- Leden tonen alleen id en @odata.type. De app heeft geen machtiging om dat type lid te lezen.
- Te veel machtigingen op één app. Apps waarvan het aanmeldingspubliek persoonlijke Microsoft-accounts omvat, kunnen maximaal 30 machtigingen aanvragen; organisatiepubliek kan er tot 400 aanvragen.
Wat de documentatie niet zegt
De gelezen Data Connect-pagina's beschrijven niet hoe lang een goedkeuring geldig blijft en geven geen tarieven. Ze noemen ook geen licentievereisten buiten de tutorialopzet van de quickstart.
Gerelateerd
Bronnen
- Overzicht van Microsoft Graph Data Connect
- Snelstart Data Connect
- Veelgestelde vragen over Data Connect
- Datasets, regio's en sinks
- Overzicht van Microsoft Graph-machtigingen
Veelgestelde vragen
Wat is het verschil tussen Graph Data Connect en de Microsoft Graph API?
De Data Connect-FAQ op Microsoft Learn stelt dat beide toegang geven tot dezelfde onderliggende data, maar op een andere manier. Data Connect is bedoeld om grote hoeveelheden data in bulk te extraheren voor de hele organisatie, terwijl de Graph API's geschikt zijn voor kleine hoeveelheden data van geselecteerde gebruikers en groepen.
Wie keurt een Graph Data Connect-toepassing goed?
In de snelstartgids van Microsoft keurt een beheerder de aanvraag goed in het Microsoft 365-beheercentrum onder Instellingen > Organisatie-instellingen > Beveiliging en privacy > Microsoft Graph Data Connect-toepassingen. In de snelstartgids staat dat je je eigen apps niet zelf kunt goedkeuren.
Heeft elke pipeline-uitvoering een nieuwe toestemmingsaanvraag nodig?
Nee. Volgens de Data Connect-FAQ hoeft een uitvoering geen nieuwe toestemmingsaanvraag als de scope voor datasets, kolommen, gebruikers en sink gelijk blijft. Dezelfde scope voor verschillende datums valt hieronder.
Moet een app gedelegeerde of toepassingsmachtigingen gebruiken?
Microsoft Learn stelt dat toepassingsmachtigingen zeer bevoorrecht zijn. Vanuit het principe van minimale bevoegdheden wordt het gedelegeerde model aanbevolen zodra het voldoet aan de behoeften van de app. Toepassingsmachtigingen vereisen altijd toestemming van een beheerder.