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 endpoint pour tous les services

Microsoft Graph - Un seul endpoint 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és
    • Teams pour les réunions RH
    • OneDrive pour les bulletins de paie

  • Graph les connecte 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 endpoint 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

Versionnage : v1.0

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

  • APIs stables

  • APIs généralement disponibles
  • Pour les applications de production

Versionnage - v1.0

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

Versionnage : beta

beta

  • https://graph.microsoft.com/beta/groups
  • Fonctionnalités d'aperçu, expérimentales
  • Instable, peut changer
  • Tests uniquement, pas pour la production

`

Versionnage - Beta

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

Ressource

  • Les données spécifiques avec lesquelles vous interagissez.

  • Exemples :

    • Users : accéder aux informations des utilisateurs
      • /users, /me
    • Groups : travailler avec des groupes
      • /groups
    • Events : récupérer des événements d'agenda
      • /users/{userId}/events

Utilisateurs

Groupes

Événements

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

  • Select :

    • Choisir des champs spécifiques
    • $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 : standards et spécifiques à l'API

En-têtes

  • Standards : communs à toutes les requêtes
    • Authorization : Bearer {access_token}
    • Content-Type : application/json
  • Spécifiques à 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...