Microsoft 365-data via Microsoft Graph in je Azure datawarehouse
Microsoft 365-data via Graph
Microsoft Graph is de ingang van Microsoft voor Microsoft 365-data, en in Yres de onderliggende koppeling voor scenario's als Teams en Office 365. Je registreert één app in Microsoft Entra ID, geeft die de Graph-permissies die bij je vraag horen en vult tenant-ID, client-ID, client secret en scope in. Yres haalt met OAuth2 een token op, stuurt dat bij elk verzoek mee en loopt alle pagina's af. De data landt in een Azure SQL-database in je eigen tenant en is van daaruit te gebruiken in Power BI.
In het kort
- Verbinding
- Microsoft Graph versie 1.0. Het adres ligt vast; het tokenadres stelt Yres samen uit je tenant-ID
- Aanmelden
- OAuth2 via een app in Microsoft Entra ID. Grant type Client Credentials of Authorization Code (dan met verplicht refresh token)
- Scope
- De OAuth-scope die je opgeeft, bijvoorbeeld https://graph.microsoft.com/.default
- Permissies
- Application- of delegated-permissies op Microsoft Graph, afhankelijk van je scenario, met admin consent van een beheerder
- Paginering
- Yres volgt de vervolglink (@odata.nextLink) die Graph in elk antwoord meestuurt
- Waar draait het
- Op de cloud-runtime van Azure Data Factory; Graph is publiek bereikbaar via HTTPS. Self-hosted alleen als verkeer via een afgeschermd of lokaal netwerk moet
- Waar staan de gegevens van de app
- Client-ID, secret en grant type in de Key Vault van je eigen omgeving; refresh token, scope en tokenadres in een configuratietabel van je eigen datawarehouse-database
Wat je zelf regelt
- 1Registreer een app in het Microsoft Entra-beheercentrum en neem van de overzichtspagina de Application (client) ID en de Directory (tenant) ID over.
- 2Maak onder Certificates & secrets een client secret aan. Kopieer de waarde meteen, want die verschijnt maar één keer.
- 3Voeg onder API permissions de Graph-permissies toe voor de gegevens die je wilt lezen en laat een beheerder admin consent verlenen.
- 4Bepaal het grant type: Client Credentials voor toegang zonder ingelogde gebruiker, Authorization Code plus refresh token voor toegang namens een gebruiker.
- 5Voeg in Yres de bron Graph toe en vul tenant-ID, client-ID, client secret, scope en grant type in.
Wanneer heb je dit nodig — en wanneer niet
Een losse connector is genoeg als…
Heb je één overzicht uit Microsoft 365 nodig, dan is een export of een ingebouwd rapport in het beheercentrum sneller dan een app-registratie en een datawarehouse.
Yres voegt iets toe als…
Yres wordt zinvol als Microsoft 365-gegevens structureel naast andere bronnen moeten staan, bijvoorbeeld gebruikers en groepen naast je HR-systeem, en je die op vaste tijden ververst wilt hebben zonder dat iemand exports hoeft te maken.
Veelgestelde vragen: Microsoft Graph
Welke Microsoft 365-gegevens kan ik via Graph laden?
Wat de Graph-endpoints teruggeven waarvoor je app rechten heeft. Dat is de kern van deze koppeling: één app-registratie, en de permissies bepalen wat leesbaar is. Yres schrijft geen permissies voor; je kiest application- of delegated-permissies die bij je scenario passen en laat een beheerder ze goedkeuren.
Waar wordt het refresh token bewaard?
Niet in de webapplicatie. Client-ID, client secret, grant type en het adres gaan naar de Key Vault van je omgeving. Het refresh token, de scope en het tokenadres staan in een configuratietabel in je eigen datawarehouse-database, waar het proces dat tokens ververst ze gebruikt.
Wat moet ik invullen bij Scope?
De OAuth-scope waarvoor Yres een token aanvraagt. Voor Microsoft Graph is dat bijvoorbeeld https://graph.microsoft.com/.default. Het tokenadres hoef je niet zelf in te vullen: Yres stelt dat samen uit je tenant-ID en toont het als alleen-lezen veld.
Is Microsoft Graph in Yres een OData-bron?
Graph werkt met OData-conventies en Yres pagineert via de OData-vervolglink, maar het is geen gewone OData-bron met Basic-aanmelding. Sinds versie 1.56 slaat Yres Graph op als OData-bron met OAuth2, zodat het token per run wordt opgehaald en als header wordt meegestuurd.
Volledige technische beschrijving in de kennisbank →·Laatst gecontroleerd:
Datawarehouse-automatisering die in je eigen Azure draait
Gebouwd voor organisaties op Azure en Power BI. Yres koppelt je bronnen, bewaart de historie en rolt wijzigingen gecontroleerd uit, zonder handwerk.