Introduction à Microsoft Graph

Mettre en œuvre la sécurité Azure pour les développeurs

Anushika Agarwal

Cloud Data Engineer

Qu'est-ce que Microsoft Graph?

  • API unifiée pour accéder aux données Microsoft 365

  • Un seul point de terminaison pour tous les services

Microsoft Graph - Un seul point de terminaison pour tous les services

Mettre en œuvre la sécurité Azure pour les développeurs

Exemple : PeopleSphere avec Microsoft Graph

  • PeopleSphere utilise :

    • Outlook pour les demandes de congé
    • Teams pour les réunions RH
    • OneDrive pour les relevés de paie

  • Graph les relie tous

Comment PeopleSphere utilise Microsoft Graph

Mettre en œuvre la sécurité Azure pour les développeurs

Anatomie d'un appel Graph API

API unifiée : un point de terminaison pour accéder aux ressources des services Microsoft Cloud Requête Microsoft Graph API

Mettre en œuvre la sécurité Azure pour les développeurs

Décomposer la requête

  • Composants de la requête :

    • Méthode : GET, POST, PATCH, etc.

    • Version : v1.0, beta

    • Ressource : users, groups, etc.

    • Paramètres de requête : $select, $filter

    • En-têtes : Authorization, Content-Type

Requête Microsoft Graph API

Mettre en œuvre la sécurité Azure pour les développeurs

Méthodes

  • Méthodes prises en charge :

    • GET : Récupérer des données

    • POST : Créer des données

    • PUT : Remplacer complètement

    • PATCH : Mettre à jour

    • DELETE : Supprimer

Mettre en œuvre la sécurité Azure pour les développeurs

Gestion des versions : v1.0

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

  • API stables

  • API généralement disponibles
  • Pour les applications en production

Gestion des versions - v1.0

Mettre en œuvre la sécurité Azure pour les développeurs

Gestion des versions : beta

beta

  • https://graph.microsoft.com/beta/groups
  • Fonctionnalités d'aperçu, expérimentales
  • Instables, peuvent changer
  • Essais seulement, pas pour la production

`

Gestion des versions - Beta

Mettre en œuvre la sécurité Azure pour les développeurs

Ressource

  • Les données précises avec lesquelles vous interagissez.

  • Exemple :

    • Users : Accéder aux infos sur les utilisateurs
      • /users, /me
    • Groups : Gérer les groupes
      • /groups
    • Events : Récupérer des événements de calendrier
      • /users/{userId}/events

Users

Groups

Events

Mettre en œuvre la sécurité Azure pour les développeurs

Paramètres de requête

  • Options pour filtrer, trier ou sélectionner des données précises

  • Select :

    • Choisir des champs précis
    • $select=id,displayName

  • Filter :

    • Filtrer les données
    • $filter=startswith(displayName, 'John')

  • Top :

    • Limiter le nombre de résultats
    • $top=5

Paramètres de requête - Select

  Paramètres de requête - Filter

  Paramètres de requête - Top

Mettre en œuvre la sécurité Azure pour les développeurs

En-têtes

Transmettre des métadonnées dans les requêtes et réponses HTTP

Deux types d'en-têtes : standard et propres à l'API

En-têtes

  • Standard : communs à toutes les requêtes
    • Authorization : Bearer {access_token}
    • Content-Type : application/json
  • Propres à l'API : varient selon l'API
    • Retry-After : 30
    • Location : https://graph.microsoft.com/operationStatus
Mettre en œuvre la sécurité Azure pour les développeurs

Passons à la pratique !

Mettre en œuvre la sécurité Azure pour les développeurs

Preparing Video For Download...