Freigeben über

Übersicht über das Sdk für Microsoft Graph-Connectors

  • Artikel

Das Microsoft Graph Connectors SDK vereinfacht den Prozess der Erstellung qualitativ hochwertiger, effizienter und resilienter Connectors für Datenquellen, die keinen vordefinierten Connector haben, die aber in Microsoft Graph indiziert werden sollen.

Das SDK enthält die Framework- und Vertragskomponenten, die Sie beim Schreiben des Codes und der Tools zum Testen Ihres Codes unterstützen.

Mit dem Connectors SDK können Sie benutzerdefinierte Microsoft Graph-Connectors direkt in der integrierten Entwicklungsumgebung (IDE) von Visual Studio erstellen. Es bietet alles, was Sie zum Erstellen, Debuggen und Bereitstellen Ihres benutzerdefinierten Connectors benötigen.

Elemente, die über mit dem SDK erstellte Verbindungen erfasst werden, nutzen Ihr Elementkontingent. Weitere Informationen zum Ermitteln des Kontingents für Artikel und zum Erwerb eines weiteren Kontingents finden Sie unter Lizenzierungsanforderungen und Preise.

Komponenten

Das Connectors SDK enthält die folgenden Komponenten:

  • Benutzerdefinierte Connectorvorlage: Wenn Sie Ihren benutzerdefinierten Connector in C# entwickeln möchten, können Sie die Vorlage aus Visual Studio Marketplace herunterladen und schnell loslegen. Sie können ihren benutzerdefinierten Connector auch in einer der Sprachen in dieser Liste entwickeln.

  • Verträge: Verträge sind gRPC-Protokollpufferdateien , die die Verträge für die Interaktion zwischen der Microsoft-Plattform (Microsoft Graph-Connector-Agent) und Ihrem benutzerdefinierten Connectorcode enthalten.

  • Microsoft Graph-Connector-Agent: Eine einfache Softwarekomponente, die Connectorfunktionen und -koordinaten zwischen dem Microsoft 365 Admin Center und Ihrem benutzerdefinierten Connectorcode verwaltet.

    Laden Sie die neueste Version des Connector-Agents herunter, und führen Sie die Installationskonfiguration Assistent aus. Weitere Informationen finden Sie unter Microsoft Graph-Connector-Agent.

  • Connectors SDK-Testhilfsprogramm: Enthält vordefinierte Testszenarien, mit denen Sie Ihren benutzerdefinierten Connectorcode testen und mit der Connector-Agent-Plattform kommunizieren können.

Funktionen des Microsoft Graph-Connector-Agents

Der Connector-Agent basiert auf derselben stabilen Connectorplattform, die zum Ausführen der integrierten Microsoft-Connectors verwendet wird.

Es umfasst die folgenden Funktionen:

  • Abrufen von Daten vom Connector: Der Agent kann eine Verbindung mit Ihrem benutzerdefinierten Connector herstellen, um Daten aus der Quelle mithilfe der vom Connector implementierten Logik abzurufen.

  • Microsoft 365 Admin Center Integration: Mit dem Agent können Sie Ihre benutzerdefinierten Connectors über die Microsoft 365 Admin Center konfigurieren, verwalten und überwachen.

  • Durchforstungsplanung und -verwaltung: Der Agent kann die Datenquelle durch vollständige Durchforstungen und inkrementelle Durchforstungen durchforsten. Vollständige Durchforstungen (listenbasiert oder Microsoft Graph-basiert) durchlaufen ihre gesamten Daten in regelmäßigen Abständen in einem von Ihnen definierten Intervall. Inkrementelle Durchforstungen sind häufiger und durchforsten die Datenquelle aus dem vorherigen Zeitstempel/Prüfpunkt in einem von Ihnen definierten Intervall.

  • Lösch-, Differenz- und Zykluserkennung: Der Agent kann Elemente erkennen, die aus Ihrer Datenquelle gelöscht wurden, basierend auf den Elementen, die von Ihrem Connector während regelmäßiger vollständiger Durchforstungen gesendet werden. Der Agent kümmert sich dann auch um das Löschen des Elements aus dem Microsoft-Index.

    Der Agent erkennt auch Elemente, die sich seit der letzten Durchforstung geändert haben, indem er einen Hash des Elements berechnet und mit dem Hash des zuvor gesehenen Elements vergleicht. Um Durchforstungen zu beschleunigen, sendet der Agent die daten, die nur dann indiziert werden sollen, wenn sich das Element ändert.

    Der Agent erkennt außerdem doppelte Elemente, die aus Datenquellen mit verknüpften Elementen (z. B. Websites) stammen, und überspringt das Durchforsten dieser Elemente.

  • Identitätszuordnung: Der Connector-Agent ermöglicht das Stempeln von Access Control Listen (ACLs) für Ihre Daten, um die Sicherheitskürzung zu ermöglichen. Sie können die Sicherheitskürzung basierend auf Microsoft Entra ID oder ACLs aus Ihrer Datenquelle aktivieren.

  • Microsoft Graph-Erfassung: Der Agent erfasst die Daten in Microsoft Graph, nachdem er sie von Ihrem benutzerdefinierten Connector empfangen hat.

Hinweis

Die folgenden Funktionen sind derzeit nicht verfügbar:

  • Graphbasierter Datenquellendurchlauf während Durchforstungen; Beispiel: Durchlaufen von Ordnerstrukturen.
  • Die Möglichkeit, Suchberechtigungen basierend auf der Zugriffssteuerung aus Ihrer Datenquelle zu verwalten.

Sie können in C# mit unseren Beispielconnectors oder in anderen unterstützten Sprachen beginnen, indem Sie die Verträge auf der Seite Microsoft Graph Connectors SDK in GitHub verwenden.

Nächste Schritte