Introductie tot Microsoft Graph

Azure-beveiliging implementeren voor developers

Anushika Agarwal

Cloud Data Engineer

Wat is Microsoft Graph?

Geünificeerde API voor toegang tot Microsoft 365-data
Eén endpoint voor alle services

Microsoft Graph - Eén endpoint voor alle services

Voorbeeld: PeopleSphere met Microsoft Graph

PeopleSphere gebruikt:
- Outlook voor verlofaanvragen
- Teams voor HR-vergaderingen
- OneDrive voor loonstroken
Graph verbindt alles

Hoe PeopleSphere Microsoft Graph gebruikt

Anatomie van een Graph API-call

Geünificeerde API: Eén endpoint voor resources van Microsoft Cloud-services Microsoft Graph API-aanvraag

De request uitgeplozen

Onderdelen van de request:
- Method: GET, POST, PATCH, etc.
- Version: v1.0, beta
- Resource: users, groups, etc.
- Queryparameters: $select, $filter
- Headers: Authorization, Content-Type

Microsoft Graph API-aanvraag

Methoden

Ondersteunde methoden:
- GET: Data ophalen
- POST: Nieuwe data maken
- PUT: Data volledig vervangen
- PATCH: Bestaande data bijwerken
- DELETE: Data verwijderen

Versiebeheer: v1.0

https://graph.microsoft.com/v1.0/groups
Stabiele API’s
Algemeen beschikbaar
Voor productie-apps

Versiebeheer - v1.0

Versiebeheer: beta

beta

https://graph.microsoft.com/beta/groups

Preview, experimentele features
Onstabiel, kan breken
Alleen voor testen, niet voor productie

`

Versiebeheer - Beta

Resource

De specifieke data waarmee je werkt.
Voorbeeld:
- Users: Info over gebruikers openen
  - /users, /me
- Groups: Werken met groepen
  - /groups
- Events: Afspraken ophalen
  - /users/{userId}/events

Gebruikers

Groepen

Queryparameters

Opties om data te filteren, sorteren of selecteren

Select:
- Kies specifieke velden
- $select=id,displayName
Filter:
- Data filteren
- $filter=startswith(displayName, 'John')
Top:
- Aantal resultaten beperken
- $top=5

Queryparameters - Select

Queryparameters - Filter

Queryparameters - Top

Headers

Dragen metadata in HTTP-requests en responses

Twee typen headers: standaard & API-specifiek

Headers

Standaard: Algemeen voor alle requests
- Authorization: Bearer {access_token}
- Content-Type: application/json

API-specifiek: Verschilt per API
- Retry-After: 30
- Location: https://graph.microsoft.com/operationStatus

Laten we oefenen!

Azure-beveiliging implementeren voor developers

Preparing Video For Download...