Introduktion till Microsoft Graph

Implementera Azure-säkerhet för utvecklare

Anushika Agarwal

Cloud Data Engineer

Vad är Microsoft Graph?

  • Enhetligt API för åtkomst till Microsoft 365-data

  • En endpoint för alla tjänster

Microsoft Graph – en endpoint för alla tjänster

Implementera Azure-säkerhet för utvecklare

Exempel: PeopleSphere med Microsoft Graph

  • PeopleSphere använder:

    • Outlook för ledighetsansökningar
    • Teams för HR-möten
    • OneDrive för lönespecifikationer

  • Graph kopplar samman dem alla

Hur PeopleSphere använder Microsoft Graph

Implementera Azure-säkerhet för utvecklare

Anatomi för ett Graph API-anrop

Enhetligt API: En endpoint för åtkomst till Microsoft Cloud-tjänsternas resurser Microsoft Graph API-förfrågan

Implementera Azure-säkerhet för utvecklare

Förfrågans delar

  • Förfrågningskomponenter:

    • Metod: GET, POST, PATCH, m.fl.

    • Version: v1.0, beta

    • Resurs: users, groups, m.fl.

    • Frågeparametrar: $select, $filter

    • Headers: Authorization, Content-Type

Microsoft Graph API-förfrågan

Implementera Azure-säkerhet för utvecklare

Metoder

  • Metoder som stöds:

    • GET: Hämta data

    • POST: Skapa ny data

    • PUT: Ersätt data helt

    • PATCH: Uppdatera befintlig data

    • DELETE: Ta bort data

Implementera Azure-säkerhet för utvecklare

Versionshantering: v1.0

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

  • Stabila API:er

  • Allmänt tillgängliga API:er
  • Används för produktionsappar

Versionshantering – v1.0

Implementera Azure-säkerhet för utvecklare

Versionshantering: beta

beta

  • https://graph.microsoft.com/beta/groups
  • Förhandsgranskning, experimentella funktioner
  • Instabil, kan sluta fungera
  • Endast för testning, inte produktion

`

Versionshantering – Beta

Implementera Azure-säkerhet för utvecklare

Resurs

  • Den specifika data du interagerar med.

  • Exempel:

    • Users: Åtkomst till användarinformation
      • /users, /me
    • Groups: Arbeta med grupper
      • /groups
    • Events: Hämta kalenderhändelser
      • /users/{userId}/events

Användare

Grupper

Händelser

Implementera Azure-säkerhet för utvecklare

Frågeparametrar

  • Alternativ för att filtrera, sortera eller välja specifik data

  • Select:

    • Välj specifika fält
    • $select=id,displayName

  • Filter:

    • Filtrera data
    • $filter=startswith(displayName, 'John')

  • Top:

    • Begränsa antalet resultat
    • $top=5

Frågeparametrar – Select

  Frågeparametrar – Filter

  Frågeparametrar – Top

Implementera Azure-säkerhet för utvecklare

Headers

Bär metadata i HTTP-förfrågningar och svar

Två typer av headers: Standard och API-specifika

Headers

  • Standard: Gemensamma för alla förfrågningar
    • Authorization: Bearer {access_token}
    • Content-Type: application/json
  • API-specifika: Varierar beroende på API
    • Retry-After: 30
    • Location: https://graph.microsoft.com/operationStatus
Implementera Azure-säkerhet för utvecklare

Nu kör vi en övning!

Implementera Azure-säkerhet för utvecklare

Preparing Video For Download...