Обзор пакета SDK для соединителей Microsoft Graph

Пакет SDK соединителей Microsoft Graph упрощает процесс создания высококачественных, эффективных и устойчивых соединителей в тех случаях, когда не удается найти готовый соединитель для источника данных, который требуется индексировать в Microsoft Graph.

Пакет SDK включает компоненты платформы и контракта, которые помогут вам написать код и средства для тестирования кода.

Пакет SDK соединителей позволяет создавать настраиваемые соединители Microsoft Graph непосредственно в интегрированной среде разработки Visual Studio. Он предоставляет все необходимое для сборки, отладки и развертывания пользовательского соединителя.

Компоненты

Пакет SDK для соединителей включает следующие компоненты:

  • Пользовательский шаблон соединителя. Если вы хотите разработать пользовательский соединитель на C#, вы можете скачать шаблон из Visual Studio Marketplace и быстро приступить к работе. Вы также можете разработать пользовательский соединитель на любом из языков в этом списке.

  • Контракты. Это файлы буфера протокола gRPC , которые содержат контракты для взаимодействия между платформой Майкрософт (агент соединителя Microsoft Graph) и пользовательским кодом соединителя.

  • Агент соединителя Microsoft Graph. Упрощенный программный компонент, который управляет возможностями соединителя и координирует работу между Центр администрирования Microsoft 365 и пользовательским кодом соединителя.

    Скачайте последнюю версию агента соединителя и запустите помощник по настройке установки. Дополнительные сведения см. в статье Агент соединителя Microsoft Graph.

  • Служебная программа тестирования пакета SDK для соединителей. Включает предварительно созданные тестовые сценарии, которые можно использовать для тестирования пользовательского кода соединителя и взаимодействия с платформой агента соединителя.

Возможности агента соединителя Microsoft Graph

Агент соединителя создан на той же надежной платформе соединителя, которая используется для запуска встроенных соединителей Майкрософт.

Она включает в себя следующие возможности:

  • Получение данных из соединителя. Агент может подключиться к пользовательскому соединителю для получения данных из источника с помощью логики, реализованной соединителем.

  • интеграция Центр администрирования Microsoft 365. Агент позволяет настраивать настраиваемые соединители, управлять ими и отслеживать их с помощью Центр администрирования Microsoft 365.

  • Планирование обхода контента и управление ими. Агент способен обхода данных с помощью полного и добавочного обхода контента. Полные обходы (на основе списка или Microsoft Graph) периодически проходят через все данные с определенным интервалом. Добавочное сканирование выполняется чаще, и они обходят источник данных из предыдущей метки времени или контрольной точки через определенный вами интервал.

  • Удаление, обнаружение различий и циклов. Агент может обнаруживать элементы, удаленные из источника данных, на основе элементов, отправляемых соединителем во время периодического полного обхода. Затем агент также выполняет удаление элемента из индекса Майкрософт.

    Агент также обнаруживает элементы, которые изменились с момента последнего обхода контента, вычисляя хэш элемента и сравнивая его с хэшем элемента, просмотренным ранее. Чтобы ускорить обход контента, агент отправляет данные для индексирования только при изменении элемента.

    Агент также обнаруживает повторяющиеся элементы, возникающие из источников данных со связанными элементами (например, веб-сайты), и пропускает обход этих элементов.

  • Сопоставление удостоверений. Агент соединителя включает метку списков контроль доступа (ACL) для данных, чтобы включить обрезку безопасности. Вы можете включить обрезку безопасности на основе Azure Active Directory (Azure AD) или списков ACL из источника данных.

  • Прием Microsoft Graph. Агент принимает данные в Microsoft Graph после их получения из пользовательского соединителя.

Примечание.

В настоящее время недоступны следующие возможности:

  • Обход источника данных на основе Microsoft Graph во время обхода контента; например, путем обхода структур папок.
  • Возможность управления разрешениями поиска на основе управления доступом из источника данных.

Вы можете приступить к работе в C# с нашим примером соединителя или на других поддерживаемых языках, используя контракты на странице пакета SDK соединителей Microsoft Graph в GitHub.

Дальнейшие действия