Поделиться через

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

  • Статья

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

Снимок экрана, показывающий, как пользовательские коннекторы связывают 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 перенаправления для каждого коннектора.
  • Если вы создали свои пользовательские коннекторы с мультиаутентификацией с помощью инструмента интерфейса командной строки (CLI), вам необходимо обновить свой коннектор с помощью инструмента CLI, чтобы задать "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, отправьте этот соединитель на сертификацию в Майкрософт. Майкрософт проверяет соединитель на соответствие техническим требованиям и требованиям к содержимому, а также на работоспособность.

Для получения дополнительной информации см. раздел Отправка ваших коннекторов на сертификацию Microsoft.

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

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

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

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

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

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

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