Обзор пользовательских соединителей

Хотя в Azure Logic Apps, Microsoft Power Automate и Microsoft Power Apps предлагается более 1000 соединителей для подключения к службам Microsoft и проверенным службам, и Microsoft Copilot Studio может использовать эти готовые соединители, но вы можете захотеть реализовать обмен данными со службами, которые недоступны в качестве готовых соединителей. В этом помогут пользовательские соединители. Вы можете создавать (и даже совместно использовать) соединители с собственными триггерами и действиями.

Пользовательский соединитель является оберткой вокруг REST API, которая позволяет Logic Apps, Power Automate, Power Apps или Copilot Studio обмениваться данными с этим API-интерфейсом REST или SOAP. Эти API-интерфейсы могут быть следующими:

• Общедоступный (видимый в общедоступном Интернете), такой как Spotify, Slack, Rackspace или API-интерфейс, которым вы управляете.
• Частный (виден только вашей сети).

Logic Apps также поддерживает API-интерфейсы SOAP.

Для общедоступных API, которые вы планируете создавать и управлять ими, рассмотрите возможность использования одного из следующих продуктов Microsoft Azure:

• Функции Azure
• Веб-приложения Azure
• Приложения Azure API

Для частных API-интерфейсов Microsoft предлагает локальное подключение к данным через локальный шлюз данных.

Используйте один из следующих стандартных методов аутентификации для своих API-интерфейсов и соединителей (рекомендуется использовать Microsoft Entra ID):

• Универсальный OAuth 2.0
• OAuth 2.0 для определенных служб, включая Microsoft Entra ID, Dropbox, GitHub и SalesForce
• Обычная проверка подлинности
• Ключ API

Вы можете настроить аутентификацию Microsoft Entra ID для своего API на портале Azure и не реализовывать аутентификацию самостоятельно. Или вы можете потребовать и принудительно применить аутентификацию в коде вашего API. Дополнительные сведения о Microsoft Entra ID для пользовательских соединителей см. в статье Защита API и соединителя с помощью Microsoft Entra ID.

Вновь созданные пользовательские соединители, использующие OAuth 2.0 для автоматической аутентификации, имеют URI перенаправления для каждого соединителя. Существующие соединители OAuth 2.0 необходимо обновить для использования URI перенаправления для каждого соединителя до 17 февраля 2024 г.

• Если вы создавали свои пользовательские соединители с помощью веб-интерфейса, отредактируйте их: перейдите на вкладку Безопасность и установите флажок Обновить для использования уникального URL-адреса перенаправления, а затем сохраните, чтобы включить URI перенаправления для конкретного соединителя.
• Если вы создавали свои пользовательские соединители с использованием множественной аутентификации с помощью интерфейса командной строки, вам нужно обновить соединитель с помощью интерфейса командной строки для задания параметра "redirectMode": "GlobalPerConnector".
• После обновления пользовательских соединителей для использования URI перенаправления для каждого соединителя с помощью параметра на вкладке Безопасность или в средстве интерфейса командной строки удалите глобальный URI перенаправления из приложений OAuth 2.0. Вы должны добавить только что созданный уникальный URL-адрес перенаправления в приложения OAuth 2.0.
• Это обновление будет применяться к существующим пользовательским соединителям OAuth 2.0 начиная с 17 февраля 2024 г. Любой пользовательский соединитель, не обновленный для использования URI перенаправления для каждого соединителя, перестает работать для новых подключений и отображает сообщение об ошибке для пользователя.
• Чтобы узнать, какие пользовательские соединители нуждаются в обновлении для перехода на URL-адрес перенаправления для каждого соединителя, можно создать поток, который использует действие Получить пользовательские соединители в качестве администратора в Power Apps для соединителя администратора и проанализировать его результат. Поток, приведенный ниже в этой статье, извлекает все пользовательские соединители, используя один и тот же метод. Затем он применяет условие фильтра к свойству параметра подключения, чтобы отфильтровать пользовательские соединители, не относящиеся к OAUTH, а затем еще один фильтр, чтобы выбрать только те соединители, которые не используют уникальный URL-адрес перенаправления для каждого соединителя. Наконец, он помещает выбранные пользовательские соединители в переменную массива, инициализированную в начале потока, и генерирует HTML-таблицу, показывающую имена и создателей этих соединителей. Вы можете импортировать этот поток в свою среду, импортировав это решение. Вы можете расширить поток и отправить таблицу HTML по электронной почте самому себе. Либо вы можете расширить его, чтобы отправлять электронные письма непосредственно создателям соединителя и сообщать им имена соединителей, которые необходимо обновить.

Когда у вас есть API-интерфейс с аутентифицированным доступом, далее нужно описать API-интерфейс, чтобы Logic Apps, Power Automate, Power Apps или Copilot Studio могли обмениваться данными с вашим API-интерфейсом. Поддерживаются следующие подходы:

• Определение OpenAPI (ранее известное как файл Swagger)

  • Создание пользовательского соединителя из определения OpenAPI
  • Документация по OpenAPI

• Коллекция Postman

  • Создание коллекции Postman
  • Создание пользовательского соединителя из коллекции Postman
  • Документация Postman

• Начало с нуля, используя пользовательский соединитель портала (только Power Automate и Power Apps)

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

Определения OpenAPI и коллекции Postman имеют различный формат, но являются независимыми от языка документами, пригодными для машинного чтения, которые описывают ваш API. Эти документы можно создать с помощью разных инструментов с учетом языка и платформы, используемых API. За кулисами Logic Apps, Power Automate, Power Apps и Copilot Studio используют OpenAPI для определения соединителей.

Пользовательские соединители используются так же, как и готовые. Вам нужно создать подключение к API, чтобы использовать это подключение, чтобы вызывать любые операции, которые были предоставлены в пользовательском соединителе.

Соединители, созданные в Power Automate, доступны в Power Apps и Copilot Studio, а соединители, созданные в Power Apps, доступны в Power Automate и Copilot Studio. Эта доступность не относится к соединителям, созданным в Logic Apps. Однако вы можете повторно использовать определение OpenAPI или коллекцию Postman, чтобы воссоздать соединитель в любой из этих служб. Дополнительные сведения см. в соответствующем руководстве:

• Применение пользовательского соединителя из потока
• Использование пользовательского соединителя из приложения
• Использование пользовательского соединителя из приложения логики
• Использование действий соединителей в Copilot Studio

Вы можете поделиться своим соединителем с пользователями в вашей организации так же, как вы делитесь ресурсами в Logic Apps, Power Automate, Power Apps или Copilot Studio. Общий доступ не является обязательным, но у вас могут быть сценарии, в которых вы хотите поделиться своими соединителями с другими пользователями.

Дополнительные сведения см. в статье Совместное использование пользовательских соединителей в организации.

Если вы хотите предоставить доступ к соединителю всем пользователям Logic Apps, Power Automate, Power Apps и Copilot Studio, нужно отправить этот соединитель на сертификацию в Microsoft. Майкрософт проверяет соединитель на соответствие техническим требованиям и требованиям к содержимому, а также на работоспособность.

Когда соединитель используется в среде Power Platform, связанной с виртуальной сетью, применяются ограничения:

• При использовании пользовательского кода ограничения описаны в разделе Запись кода в пользовательском соединителе.

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

• Триггеры, возвращающие заголовок местоположения, которые не выполняют обратный вызов в пользовательский соединитель, не поддерживаются.

Мы очень ценим отзывы о проблемах с нашей платформой соединителей и новые идеи о функциях. Чтобы оставить отзыв, выберите пункт Сообщить о проблемах или получить помощь с соединителями и выберите тип отзыва.