Работа с API соединителей Microsoft Graph

  • Статья

Соединители Microsoft Graph добавляют внешние данные в Microsoft Graph и улучшают интеллектуальные возможности Microsoft 365. Для интеграции со службами, которые недоступны в роли соединителей, созданных корпорацией Майкрософт, необходимо создать настраиваемый соединитель. Для создания настраиваемых соединителей вы используете REST API соединителей Microsoft Graph. Элементы, которые поглощаются через подключения, созданные с помощью API, потребляют квоту элементов. Дополнительные сведения о том, как определить, сколько у вас есть квоты на элементы и приобретение дополнительной квоты, см. в разделе Требования к лицензированию и цены.

Изображение внешних данных, исходящих из разных соединителей Microsoft Graph

Используйте API Microsoft Graph, чтобы выполнять следующие задачи:

  1. Создание подключений к внешним данным и управление ими.
  2. Определите и зарегистрируйте схему внешних типов данных.
  3. Запись элементов внешних данных в Microsoft Graph.
  4. Синхронизация внешних групп.

Создание подключений к внешним данным и управление ими

Ресурс externalConnection (API внешнего подключения) — это логический контейнер для внешних данных, которым вы можете управлять как единым блоком.

Подробнее см. в статье Создание, обновление и удаление подключений в Microsoft Graph.

Определение и регистрация схем внешних типов данных

Подключение schema (API схемы) определяет, как содержимое используется в различных возможностях Microsoft 365. Схема представляет собой простой список всех свойств, которые вы планируете добавить в соединение, вместе с их атрибутами, метками и псевдонимами. Перед добавлением элементов в Microsoft Graph вы должны зарегистрировать схему.

Подробнее см. в статье Регистрация и обновление схемы для подключения Microsoft Graph.

Запись элементов внешних данных в Microsoft Graph

Элементы, добавленные приложением в службу "Поиск (Майкрософт)", представлены ресурсом externalItem (API внешнего элемента) в Microsoft Graph.

Подробнее см. в статье Создание, обновление и удаление элементов, добавленных вашим приложением с помощью соединителей Microsoft Graph.

Синхронизация внешних групп

Элементы во внешней службе могут быть предоставлены или запрещены в доступе через ACL для различных типов групп, не Microsoft Entra. Например, элементы Salesforce могут иметь наборы разрешений и профили, а элементы ServiceNow могут иметь локальные группы. При записи этих элементов в Microsoft Graph необходимо соблюдать эти ACL.

Вы можете использовать API внешней группы для установки разрешений для внешних элементов, загружаемых в Microsoft Graph. ExternalGroup представляет не Microsoft Entra групповую или групповую конструкцию (например, подразделения, команды и т. д.) и определяет разрешения на содержимое во внешнем источнике данных.

Дополнительные сведения см. в статье Использование внешних групп для управления разрешениями на доступ к источникам данных соединителей Microsoft Graph.

Следующее действие

Создание пользовательского соединителя