Настраиваемые соединители

  • Статья

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

Screenshot of custom connectors - overview.

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

Screenshot of custom connectors - lifecycle.

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

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

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

Для общедоступных 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 перенаправления для конкретного соединителя(либо с помощью флажка на вкладке "Безопасность", либо с помощью интерфейса командной строки), следует удалить глобальный URI перенаправления из ваших приложений OAuth 2.0 и добавить в приложения OAuth 2.0 вновь сгенерированный уникальный URL-адрес перенаправления.
  • Это обновление станет обязательным для существующих соединителей 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, чтобы воссоздать соединитель в любой из этих служб. Дополнительные сведения см. в соответствующем руководстве:

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

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

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

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

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

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

Учебник

В руководстве используется API-интерфейс текстовой аналитики Cognitive Services. Microsoft уже предоставляет соединитель для этого API. Это хороший пример для обучения жизненному циклу настраиваемого соединителя и тому, как настраиваемые соединители могут поддерживать уникальные сценарии.

Сценарий

Создаваемый вами соединитель будет выполнять определение тональности с помощью API "Анализ текста". В ходе анализа соединитель принимает вводимый текст и возвращает показатель его тональности (от 0,000 до 1,000).

Предварительные условия

  • Одна из следующих подписок:

  • Базовое понимание того, как создавать приложения Logic Apps, потоки Power Automate или Power Apps.

  • Ключ API для API "Текстовая аналитика" в Cognitive Services.

Получение ключа API

API-интерфейс текстовой аналитики использует Ключ API для аутентификации пользователей. Когда пользователь создает соединение с API через пользовательский соединитель, пользователь указывает значение этого ключа. Чтобы получить ключ API:

Запуск руководства

Расширенное руководство

Учебные пособия и видео в этом разделе дадут вам необходимое понимание того, как использовать соединители Power Platform как часть ваших реализаций.

Учебники

Следующие учебные пособия предоставляют более подробную информацию для конкретных сценариев настраиваемых соединителей:

Video

В следующем 45-минутном видеоролике показано, как работают соединители Power Platform. В нем также показано, как создавать простые и расширенные настраиваемые соединители.

См. также

Список всех соединителей

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

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