自定义连接器概述

虽然 Azure 逻辑应用Microsoft Power Automate提供了 1,000 多个 Microsoft Power Apps 连接器 来连接到 Microsoft 和经过验证的服务，但 你可能希望与不作为预生成连接器提供的服务进行通信。 自定义连接器可以解决这个问题，因为它可以让您创建（甚至共享）具有自己的触发器和操作的连接器。

生命周期

1. 构建 API

自定义连接器是一个 REST API 包装器，允许逻辑应用、Power Automate 或 Power Apps 与 REST 或 SOAP API 通信。 这些 API 可以是：

• 公共（在公共互联网上可见），例如 Spotify、 Slack、 Rackspace 或您管理的 API。
• 专用（仅对您的网络可见）。

逻辑应用还支持 SOAP API。

对于您计划创建和管理的公共 API，请考虑使用以下 Microsoft Azure 产品之一：

• Azure 函数
• Azure Web 应用
• Azure API 应用程序

对于私有 API，Microsoft 通过 本地数据网关提供本地数据连接。

2. 保护 API

为您的 API 和连接器使用以下标准身份验证方法之一（Microsoft Entra 建议使用 ID ）：

• 通用 OAuth 2.0
• OAuth 2.0 适用于特定服务，包括 Microsoft Entra ID、Dropbox、GitHub 和 SalesForce
• 基本身份验证
• API 密钥

您可以在 Azure 门户中为您的 API 设置 Microsoft Entra ID 身份验证，因此不必实施身份验证。 或者，您也可以在 API 代码中要求并执行身份验证。 有关 Microsoft Entra 自定义连接器的 ID 的更多信息，请参阅 使用 Microsoft Entra ID 保护您的 API 和连接器。

2.1. OAuth 2.0

使用 OAuth 2.0 进行身份验证的新创建的自定义连接器会自动具有每个连接器的重定向 URI。 必须在 2024 年 2 月 17 日之前更新现有 OAuth 2.0 连接器才能使用每个连接器的重定向 URI。

• 如果您使用 Web 界面创建了自定义连接器，请编辑自定义连接器，转到安全 选项卡 并选中 Update to unique redirect URL ，then save 复选框以启用每个连接器重定向 URI。
• 如果您使用命令行界面（CLI）工具创建了具有 多重身份验证的自定义连接器，则需要使用 CLI 工具更新连接器以进行设置。 "redirectMode": "GlobalPerConnector"
• 通过 Security（安全 ） 选项卡或 CLI 工具中的设置将自定义连接器更新为使用每个连接器的重定向 URI 后，请从 OAuth 2.0 应用程序中删除全局重定向 URI。 您应该将新生成的唯一重定向 URL OAuth 添加到您的 2.0 应用程序中。
• 从 2024 年 2 月 17 日开始，我们将对现有 OAuth 2.0 自定义连接器强制实施此更新。 任何未更新为使用每个连接器重定向 URI 的自定义连接器都将停止用于新连接，并向用户显示错误消息。
• 要找出哪些自定义连接器需要更新才能迁移到每个连接器重定向 URL，您可以创建一个流，该流使用 管理员连接器的 Get Custom Connectors as Admin Power Apps 作并解析其结果。 本文后面附加的流使用相同方法获取所有自定义连接器。 然后，它会对 connection 参数的属性应用筛选条件，以筛选出非 Oauth 自定义连接器，然后应用另一个筛选条件，以仅选择不使用每个连接器唯一重定向 URL 的连接器。 最后，它将所选自定义连接器放入在流开始时初始化的数组变量中，并生成一个 HTML 表，显示这些连接器的名称和创建者。 您可以通过导入 此解决方案将此流导入到您的环境中。 您可以进一步扩展该流，以电子邮件形式将 HTML 表发送给自己。 或者，您可以扩展它以直接向连接器创建者发送电子邮件，并向他们提供需要更新的连接器的名称。

3. 说明 API 并定义自定义连接器

有了具有通过身份验证的访问权限的 API 之后，接下来要做的是说明您的 API 以便逻辑应用、Power Automate 或 Power Apps 可以与您的 API 进行通信。 以下方法均支持：

• 一个 OpenAPI 定义（以前称为 Swagger 文件）

  • 从 OpenAPI 定义创建自定义连接器
  • OpenAPI 文档

• Postman 集合

  • 创建 Postman 集合
  • 从 Postman 集合创建自定义连接器
  • Postman 文档

• 使用自定义连接器门户从头开始（仅 Power Automate 和 Power Apps）

  • 从头开始创建自定义连接器

虽然 OpenAPI 定义和 Postman 集合使用的格式不同，但两者都是与语言无关的机器可读文档，其中描述了 API。 根据 API 所用的语言和平台，还可以使用各种工具生成这些文档。 在后台，逻辑应用、Power Automate 和 Power Apps 使用 OpenAPI 来定义连接器。

4. 在逻辑应用、Power Automate 或 Power Apps 应用中使用您的连接器

自定义连接器的使用方式与预生成连接器的使用方式相同。 请先创建与 API 的连接，以使用该连接调用在自定义连接器中公开的任何操作。

在 中创建的 Power Automate 连接器在 中 Power Apps可用，在 中创建的 Power Apps 连接器在 中可用 Power Automate。 对于在逻辑应用中创建的连接器，此可用性并非如此。 但是，您可以重用 OpenAPI 定义或 Postman 集合在任何这些服务中重新创建连接器。 有关详细信息，请参阅相应教程：

• 使用流中的自定义连接器
• 从应用程序使用自定义连接器
• 使用逻辑应用中的自定义连接器

5. 共享连接器

您可以使用在逻辑应用、Power Automate 或 Power Apps 中共享资源的方式与组织中的用户共享连接器。 共享是可选的，但有时您可能需要与其他用户共享您的连接器。

有关详细信息，请参阅 在组织中共享自定义连接器。

6. 验证连接器

若要与逻辑应用、Power Automate 和 Power Apps 的所有用户共享连接器，可提交连接器进行 Microsoft 认证。 Microsoft 审查连接器、检查技术和内容合规性，并验证功能。

有关更多信息，请参阅 提交连接器进行 Microsoft 认证。

虚拟网络支持

在 Power Platform 链接到虚拟网络的环境中使用连接器时，存在限制：

• 使用自定义代码时，在自定义连接器 中编写代码中解释了限制。

• 在将环境关联到虚拟网络之前创建的自定义连接器需要重新保存。

• 不支持返回不回调到自定义连接器的位置标头的触发器。

提供反馈

我们非常感谢大家提出有关连接器平台问题或新功能想法的反馈。 若要提供反馈，请转到 提交问题或获取有关连接器 的帮助 ，然后选择您的反馈类型。