Utiliser l’API de connecteurs Microsoft Graph

Les connecteurs Microsoft Graph regroupent des données externes dans Microsoft Graph et améliorent les expériences intelligentes de Microsoft 365. Vous pouvez créer un connecteur personnalisé pour l’intégrer aux services qui ne sont pas disponibles en tant que connecteurs conçus par Microsoft. Pour créer des connecteurs personnalisés, vous utilisez l’API REST des connecteurs Microsoft Graph. Les éléments ingérés via des connexions créées avec les API consomment votre quota d’éléments. Pour en savoir plus sur la façon de déterminer le quota d’éléments dont vous disposez et l’achat d’un quota supplémentaire, consultez Exigences de licence et tarification.

Image montrant les données externes provenant de différents types de connecteurs pour Microsoft Graph

Vous pouvez utiliser l’API de connecteurs Microsoft Graph pour :

  1. Création et gérer des connexions de données externes.
  2. Définissez et inscrivez le schéma des types de données externes.
  3. Insérer des éléments de données externes dans Microsoft Graph.
  4. Synchroniser des externes.

Création et gérer des connexions de données externes

La ressource externalConnection (API de connexion externe) est un conteneur logique pour vos données externes que vous pouvez gérer en tant qu’unité unique.

Pour en savoir plus, consultez Créer, mettre à jour et supprimer des connexions dans Microsoft Graph.

Définir et inscrire le schéma des types de données externes

Le schéma de connexion (API de schéma) détermine la façon dont votre contenu sera utilisé dans plusieurs expériences Microsoft 365. Le schéma est une liste plate de toutes les propriétés que vous envisagez d’ajouter à la connexion, ainsi que les attributs, les étiquettes et les alias. Vous devez inscrire le schéma avant d’insérer des éléments dans Microsoft Graph.

Pour plus d’informations, consultez Inscrire et mettre à jour le schéma pour la connexion Microsoft Graph.

Insérer des éléments de données externes dans Microsoft Graph

Les éléments ajoutés par votre application au service Recherche Microsoft sont représentés par la ressource externalItem (API d’élément externe) dans Microsoft Graph.

Pour en savoir plus, consultez Créer, mettre à jour et supprimer des éléments ajoutés par votre application via les connecteurs Microsoft Graph.

Synchroniser des groupes externes

L’accès aux éléments du service externe peut être accordé ou refusé via ACL à différents types de groupes non Microsoft Entra. Par exemple, les éléments Salesforce peuvent avoir des jeux d’autorisations et des profils, tandis que les éléments ServiceNow peuvent avoir des groupes locaux. Lorsque vous insérez ces éléments dans Microsoft Graph, vous devez respecter ces ACLs.

Vous pouvez utiliser l’API des groupes externes pour définir des autorisations sur des éléments externes ingérés dans Microsoft Graph. Un externalGroup représente une construction de groupe ou sous forme de groupe non Microsoft Entra (par exemple, les unités d’entreprise, les équipes, etc.) et détermine les autorisations sur le contenu dans votre source de données externe.

Pour plus d’informations, consultez Utiliser des groupes externes pour gérer les autorisations sur les sources de données des connecteurs Microsoft Graph.

Étape suivante