Introduzione a Microsoft Graph

Implementare Azure Security per sviluppatori

Anushika Agarwal

Cloud Data Engineer

Cos’è Microsoft Graph?

  • API unificata per accedere ai dati di Microsoft 365

  • Un endpoint per tutti i servizi

Microsoft Graph - One endpoint for all services

Implementare Azure Security per sviluppatori

Esempio: PeopleSphere con Microsoft Graph

  • PeopleSphere usa:

    • Outlook per le richieste di ferie
    • Teams per le riunioni HR
    • OneDrive per i cedolini

  • Graph li collega tutti

Come PeopleSphere usa Microsoft Graph

Implementare Azure Security per sviluppatori

Anatomia di una chiamata Graph API

API unificata: Un endpoint per accedere alle risorse dei servizi Microsoft Cloud Richiesta Microsoft Graph API

Implementare Azure Security per sviluppatori

Scomporre la richiesta

  • Componenti della richiesta:

    • Metodo: GET, POST, PATCH, ecc.

    • Versione: v1.0, beta

    • Risorsa: users, groups, ecc.

    • Parametri di query: $select, $filter

    • Header: Authorization, Content-Type

Richiesta Microsoft Graph API

Implementare Azure Security per sviluppatori

Metodi

  • Metodi supportati:

    • GET: Recupera dati

    • POST: Crea nuovi dati

    • PUT: Sostituisce del tutto i dati

    • PATCH: Aggiorna dati esistenti

    • DELETE: Elimina dati

Implementare Azure Security per sviluppatori

Versioni: v1.0

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

  • API stabili

  • API generalmente disponibili
  • Per app di produzione

Versioning - v1.0

Implementare Azure Security per sviluppatori

Versioni: beta

beta

  • https://graph.microsoft.com/beta/groups
  • Funzionalità in anteprima, sperimentali
  • Instabili, possono rompersi
  • Solo per test, non produzione

`

Versioning - Beta

Implementare Azure Security per sviluppatori

Risorsa

  • I dati specifici con cui interagisci.

  • Esempi:

    • Users: Accedi alle info sugli utenti
      • /users, /me
    • Groups: Lavora con i gruppi
      • /groups
    • Events: Recupera eventi calendario
      • /users/{userId}/events

Utenti

Gruppi

Eventi

Implementare Azure Security per sviluppatori

Parametri di query

  • Opzioni per filtrare, ordinare o selezionare dati specifici

  • Select:

    • Scegli campi specifici
    • $select=id,displayName

  • Filter:

    • Filtra i dati
    • $filter=startswith(displayName, 'John')

  • Top:

    • Limita il numero di risultati
    • $top=5

Parametri di query - Select

  Parametri di query - Filter

  Parametri di query - Top

Implementare Azure Security per sviluppatori

Header

Trasportano metadati nelle richieste e risposte HTTP

Due tipi di header: standard e specifici dell’API

Header

  • Standard: Comuni a tutte le richieste
    • Authorization: Bearer {access_token}
    • Content-Type: application/json
  • Specifici dell’API: Variano per API
    • Retry-After: 30
    • Location: https://graph.microsoft.com/operationStatus
Implementare Azure Security per sviluppatori

Ayo berlatih!

Implementare Azure Security per sviluppatori

Preparing Video For Download...