Introduzione a Microsoft Graph

Implementare Azure Security per sviluppatori

Anushika Agarwal

Cloud Data Engineer

Che cos'è Microsoft Graph?

  • API unificata per accedere ai dati Microsoft 365

  • Un solo endpoint per tutti i servizi

Microsoft Graph - Un endpoint per tutti i servizi

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 completamente

    • PATCH: Aggiorna dati esistenti

    • DELETE: Elimina dati

Implementare Azure Security per sviluppatori

Versioning: v1.0

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

  • API stabili

  • API generalmente disponibili
  • Per app in produzione

Versioning - v1.0

Implementare Azure Security per sviluppatori

Versioning: 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.

  • Esempio:

    • Users: accedi alle info sugli utenti
      • /users, /me
    • Groups: lavora con i gruppi
      • /groups
    • Events: recupera eventi del 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

Esercitiamoci!

Implementare Azure Security per sviluppatori

Preparing Video For Download...