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-gegevens

  • Eén endpoint voor alle services

Microsoft Graph - One endpoint for all services

Azure-beveiliging implementeren voor developers

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

Azure-beveiliging implementeren voor developers

Anatomie van een Graph API-aanroep

Geünificeerde API: één endpoint voor toegang tot Microsoft Cloud-serviceresources Microsoft Graph API Request

Azure-beveiliging implementeren voor developers

Het request ontleden

  • Onderdelen van een request:

    • Methode: GET, POST, PATCH, enz.

    • Versie: v1.0, beta

    • Resource: users, groups, enz.

    • Queryparameters: $select, $filter

    • Headers: Authorization, Content-Type

Microsoft Graph API Request

Azure-beveiliging implementeren voor developers

Methoden

  • Ondersteunde methoden:

    • GET: Gegevens ophalen

    • POST: Nieuwe gegevens maken

    • PUT: Gegevens volledig vervangen

    • PATCH: Bestaande gegevens bijwerken

    • DELETE: Gegevens verwijderen

Azure-beveiliging implementeren voor developers

Versiebeheer: v1.0

  • https://graph.microsoft.com/v1.0/groups

  • Stabiele API's

  • Algemeen beschikbare API's
  • Voor productie-apps

Versioning - v1.0

Azure-beveiliging implementeren voor developers

Versiebeheer: beta

beta

  • https://graph.microsoft.com/beta/groups
  • Preview, experimentele functies
  • Onstabiel, kan breken
  • Alleen voor testen, niet voor productie

`

Versioning - Beta

Azure-beveiliging implementeren voor developers

Resource

  • De specifieke gegevens waarmee je werkt.

  • Voorbeeld:

    • Users: Toegang tot gebruikersinformatie
      • /users, /me
    • Groups: Werken met groepen
      • /groups
    • Events: Agenda-afspraken ophalen
      • /users/{userId}/events

Gebruikers

Groepen

Afspraken

Azure-beveiliging implementeren voor developers

Queryparameters

  • Opties om specifieke gegevens te filteren, sorteren of selecteren

  • Select:

    • Bepaalde velden kiezen
    • $select=id,displayName
  • Filter:

    • Gegevens filteren
    • $filter=startswith(displayName, 'John')
  • Top:

    • Aantal resultaten beperken
    • $top=5

Query Parameters - Select

  Query Parameters - Filter

  Query Parameters - Top

Azure-beveiliging implementeren voor developers

Headers

Draag metadata mee in HTTP-requests en responses

Twee soorten headers: standaard en 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
Azure-beveiliging implementeren voor developers

Laten we oefenen!

Azure-beveiliging implementeren voor developers

Preparing Video For Download...