Arbeiten mit der Microsoft Graph Connectors-API

Microsoft Graph-Konnektoren bieten eine intuitive Möglichkeit, externe Daten in Microsoft Graph einzubinden und intelligente Microsoft 365-Erlebnisse zu verbessern. Möglicherweise möchten Sie einen benutzerdefinierten Connector erstellen, um ihn in Dienste zu integrieren, die nicht als Connectors von Microsoft verfügbar sind. Um benutzerdefinierte Konnektoren zu erstellen, verwenden Sie die REST-API für Microsoft Graph Connectors. Elemente, die über mit den APIs erstellte Verbindungen erfasst werden, nutzen Ihr Elementkontingent. Weitere Informationen zum Ermitteln des Artikelkontingents und zum Erwerb eines zusätzlichen Kontingents finden Sie unter Lizenzierungsanforderungen und Preise.

Abbildung der externen Daten, die über verschiedene Arten von Connectors zu Microsoft Graph gelangen

Sie können die Microsoft Graph-Connectors-API für Folgendes verwenden:

  1. Erstellen und Verwalten externer Datenverbindungen.
  2. Definieren und registrieren Sie das Schema der externen Datentypen.
  3. Erfassen externer Datenelemente in Microsoft Graph.
  4. Synchronisieren externer Gruppen.

Erstellen und Verwalten externer Datenverbindungen

Die externalConnection-Ressource (externe Verbindungs-API) ist ein logischer Container für Ihre externen Daten, den Sie als eine Einheit verwalten können.

Weitere Informationen finden Sie unter Erstellen, Aktualisieren und Löschen von Verbindungen in Microsoft Graph.

Definieren und Registrieren des Schemas der externen Datentypen

Das Verbindungsschema (Schema API) bestimmt, wie Ihre Inhalte in verschiedenen Microsoft 365-Umgebungen verwendet werden. Das Schema ist eine flache Liste aller Eigenschaften, die Sie der Verbindung zusammen mit ihren Attributen, Bezeichnungen und Aliasen hinzufügen möchten. Sie müssen das Schema registrieren, bevor Sie Elemente in Microsoft Graph erfassen können.

Weitere Informationen finden Sie unter Registrieren und Aktualisieren des Schemas für die Microsoft Graph-Verbindung.

Erfassen externer Datenelemente in Microsoft Graph

Die von Ihrer Anwendung zum Microsoft Search-Dienst hinzugefügten Elemente werden durch die externalItem-Ressource (API für externe Elemente) in Microsoft Graph dargestellt.

Weitere Informationen finden Sie unter Erstellen, Aktualisieren und Löschen von Elementen, die von Ihrer Anwendung über Microsoft Graph Connectors hinzugefügt wurden.

Externe Gruppen synchronisieren

Elementen im externen Dienst kann der Zugriff über die Zugriffssteuerungsliste für verschiedene Typen von Nicht-Microsoft Entra-Gruppen gewährt oder verweigert werden. Salesforce-Elemente können zum Beispiel Berechtigungssätze und Profile haben, während ServiceNow-Elemente lokale Gruppen haben können. Beim Erfassen dieser Elemente in Microsoft Graph müssen diese ACLs berücksichtigt werden.

Sie können die API für externe Gruppen verwenden, um Berechtigungen für externe Elemente festzulegen, die in Microsoft Graph erfasst werden. Eine externalGroup stellt ein nicht Microsoft Entra Gruppen- oder gruppenähnliches Konstrukt (z. B. Geschäftseinheiten, Teams usw.) dar und bestimmt Berechtigungen für den Inhalt in Ihrer externen Datenquelle.

Weitere Informationen finden Sie unter Verwenden externer Gruppen zum Verwalten von Berechtigungen für Microsoft Graph Connectors-Datenquellen.

Nächster Schritt