Создание пользовательского коннектора: подключаем собственный API к Power Automate

Пользовательский коннектор в Power Automate — это самостоятельно созданная обертка вокруг REST- или SOAP-API, которую вы используете, если ни один из более чем 1000 готовых коннекторов не подходит для вашей системы. Вы создаете его на основе определения OpenAPI, коллекции Postman или непосредственно в портале коннекторов, защищаете доступ с помощью стандартного метода аутентификации, такого как Microsoft Entra ID или OAuth 2.0, и для этого вам нужна как минимум лицензия Power Automate Premium или Process, поскольку бесплатный уровень допускает только стандартные коннекторы. Актуально на: август 2026 года.

Что такое пользовательский коннектор?

Пользовательский коннектор технически представляет собой обертку вокруг REST-API, а в Logic Apps также вокруг SOAP-API, которая позволяет Power Automate, Power Apps или Copilot Studio взаимодействовать с системой, для которой нет готового коннектора. API может быть общедоступным в интернете, например самостоятельно размещенный REST-интерфейс, или находиться в частной собственной сети — для частных API Microsoft предоставляет для этого локальный шлюз данных (on-premises data gateway). Подробности об общей концепции описаны в обзоре пользовательских коннекторов от Microsoft.

Как именно создать коннектор?

У вас есть три способа определить коннектор: с помощью определения OpenAPI (ранее файл Swagger), с помощью импортированной коллекции Postman, или создав его полностью с нуля в мастере коннекторов. По данным Microsoft, последний способ доступен только в Power Automate и Power Apps, но не в Logic Apps, тогда как определение OpenAPI или Postman можно повторно использовать и там, чтобы создать коннектор отдельно заново. В решениях (Solutions) вы создаете его через "Создать > Автоматизация > Пользовательский коннектор".

Как защитить соединение с API?

Для аутентификации доступно несколько стандартных методов, при этом рекомендуется Microsoft Entra ID: универсальный OAuth 2.0, специфичный для сервиса OAuth 2.0, например для Dropbox или GitHub, базовая аутентификация или ключ API. Важный момент для существующих коннекторов: вновь созданные коннекторы OAuth 2.0 автоматически получают собственный URI перенаправления для каждого коннектора, более старые коннекторы нужно было перевести на это с 17 февраля 2024 года, иначе новые подключения больше не работают. Если вы используете более старый коннектор, стоит проверить настройки безопасности на предмет того, включен ли уже уникальный URL перенаправления.

Какая лицензия для этого нужна?

Чтобы вообще иметь возможность использовать пользовательский коннектор, вам нужна как минимум лицензия Power Automate Premium или лицензия Process, бесплатная лицензия Power Automate Free, по данным Microsoft, явно ограничена стандартными коннекторами. Лицензии Premium, Process и Hosted Process каждая полностью включает право на использование пользовательских коннекторов, отдельной дополнительной платы за каждый отдельный коннектор не существует. При принятии решения о том, какой уровень лицензии целесообразен для вашей компании, мы в NordFlux оказываем поддержку в рамках консультации по лицензированию Power Automate.

Как поделиться коннектором в команде и что действует для Logic Apps?

Вы предоставляете доступ к коннектору внутри своей организации, аналогично другим ресурсам в Power Automate, Power Apps или Copilot Studio, это необязательно, но целесообразно, если его должны использовать несколько коллег. Коннектор, созданный в Power Automate, автоматически становится доступен также в Power Apps и Copilot Studio, и наоборот, но это не распространяется автоматически на Logic Apps. Если коннектор должен стать видимым для всех пользователей Power Automate, Power Apps, Logic Apps и Copilot Studio, вам необходимо дополнительно отправить его на сертификацию Microsoft. Согласно обзору сертификации коннекторов сертификация бесплатна для обоих типов издателей, но требует поддерживаемого метода аутентификации (OAuth 2.0, анонимная аутентификация, ключ API или базовая аутентификация), назначенного контакта поддержки и рекомендует доступность не менее 99,9 процента.

Часто задаваемые вопросы о пользовательских коннекторах в Power Automate

Нужны ли мне навыки программирования для пользовательского коннектора?

Для самого простого пути через мастер коннекторов достаточно базовых знаний о структуре целевого API, классическое программирование не является строго обязательным. Однако как только вы самостоятельно пишете определение OpenAPI или реализуете более сложную аутентификацию, такую как Microsoft Entra ID, в коде собственного API, технические знания становятся заметно более полезными.

Стоит ли пользовательский коннектор дополнительно к лицензии?

Нет, по данным Microsoft, использование пользовательских коннекторов уже включено в лицензии Premium, Process и Hosted Process, документация не упоминает отдельную плату за коннектор. Затраты фактически возникают из-за того, что без этих уровней лицензии вы вообще не можете использовать пользовательский коннектор, поскольку лицензия Free их исключает.

Могу ли я использовать пользовательский коннектор также в Power Apps?

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

Что происходит, если изменяется базовый API?

Если поле в API изменяется, вам необходимо повторно опубликовать коннектор, чтобы обновленный Swagger был применен, а затем удалить и заново добавить затронутые подключения во всех приложениях. Без этого шага приложения и потоки продолжают работать со старым определением коннектора и могут давать сбой при расхождении полей.