Работа с API соединителей Microsoft Graph
Соединители Microsoft Graph добавляют внешние данные в Microsoft Graph и улучшают интеллектуальные возможности Microsoft 365. Для интеграции со службами, которые недоступны в роли соединителей, созданных корпорацией Майкрософт, необходимо создать настраиваемый соединитель. Для создания настраиваемых соединителей вы используете REST API соединителей Microsoft Graph.
Используйте API Microsoft Graph, чтобы выполнять следующие задачи:
- Создание подключений к внешним данным и управление ими.
- Определите и зарегистрируйте схему внешних типов данных.
- Запись элементов внешних данных в Microsoft Graph.
- Синхронизация внешних групп.
Создание подключений к внешним данным и управление ими
Ресурс externalConnection (API внешнего подключения) — это логический контейнер для внешних данных, которым вы можете управлять как единым блоком.
Подробнее см. в статье Создание, обновление и удаление подключений в Microsoft Graph.
Определение и регистрация схем внешних типов данных
Подключение schema (API схемы) определяет, как содержимое используется в различных возможностях Microsoft 365. Схема представляет собой простой список всех свойств, которые вы планируете добавить в соединение, вместе с их атрибутами, метками и псевдонимами. Перед добавлением элементов в Microsoft Graph вы должны зарегистрировать схему.
Подробнее см. в статье Регистрация и обновление схемы для подключения Microsoft Graph.
Запись элементов внешних данных в Microsoft Graph
Элементы, добавленные приложением в службу "Поиск (Майкрософт)", представлены ресурсом externalItem (API внешнего элемента) в Microsoft Graph.
Подробнее см. в статье Создание, обновление и удаление элементов, добавленных вашим приложением с помощью соединителей Microsoft Graph.
Синхронизация внешних групп
Элементам во внешней службе может предоставляться или отказываться в доступе через ACL к различным типам групп, отличных от Azure Active Directory. Например, элементы Salesforce могут иметь наборы разрешений и профили, а элементы ServiceNow могут иметь локальные группы. При записи этих элементов в Microsoft Graph необходимо соблюдать эти ACL.
Вы можете использовать API внешней группы для установки разрешений для внешних элементов, загружаемых в Microsoft Graph. externalGroup представляет собой группу или подобную группе структуру, не относящуюся к Azure Active Directory (например, бизнес-подразделения, команды и т. д.), и определяет разрешения на содержимое во внешнем источнике данных.
Дополнительные сведения см. в статье Использование внешних групп для управления разрешениями на доступ к источникам данных соединителей Microsoft Graph.