Бөлісу құралы:

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

  • Мақала

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

Снимок экрана, показывающий, как пользовательские коннекторы связывают API текстовой аналитики с приложениями.

Жизненный цикл

Скриншот жизненного цикла пользовательских коннекторов, состоящего из пяти этапов.

1. Создание своего API-интерфейса

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

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

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

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

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

2. Защита своего API-интерфейса

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

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

2.1. OAuth 2.0

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

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

3. Описание API и определение пользовательского соединителя

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

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

4. Использование соединителя в приложении Logic Apps, Power Automate или Power Apps

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

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

Совет

Если вы обновляете (удаляете, добавляете или изменяете) поле в API, выполните следующие действия:

  1. Повторно опубликуйте коннектор, чтобы он использовал обновленный Swagger для API.
  2. Удалите все соединения / источник данных в любом приложении, которое использует этот соединитель.
  3. Повторно добавьте соединение / источник данных для этого коннектора в приложения.

5. Предоставление общего доступа к соединителю

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

Подробнее читайте в статье Обмен пользовательскими коннекторами в вашей организации.

6. Сертификация соединителя

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

Дополнительные сведения см. в статье об отправке пользовательских соединителей на сертификацию Майкрософт.

Поддержка виртуальной сети

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

  • При использовании пользовательского кода ограничения объясняются в разделе Написание кода в пользовательском соединителе.

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

Предоставление отзывов

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