简介

已完成

本模块将探讨自定义连接器,并说明如何通过 Microsoft Power Apps、Microsoft Power Automate 和 Microsoft Azure 逻辑应用来配置和使用它们。

在本模块中,您将:

  • 了解自定义连接器的作用。

  • 构建连接器并在 Power Automate 流中使用。

连接器支持应用和流开发者通过以下方式更轻松地连接云中的其他应用、数据和设备:

  • 连接是以一致、可重复的方式完成的,该方法可由开发者发现。

  • 连接器有一些操作,开发者在执行操作时可以控制这些操作。

  • 连接器可以具有触发器,以允许在发生触发事件时启动自动化。

图示:API 位于中间,周围环绕着连接器以及 Power Automate、Power Apps 和逻辑应用。

连接器是围绕 API 的代理或包装器,允许 Power Automate、Power Apps 以及逻辑应用与基础服务进行通信。 许多连接器已预定义且可供使用,无需您定义任何内容。 这些内置连接器定义包括来自 Microsoft 的服务和其他服务。 当您要使用的服务或 API 没有预生成的连接器时,您可以创建您自己的自定义连接器。 如果预生成的连接器未公开您需要的来自 API 的所有触发器和操作,则除了已提供的连接器外,您还可以生成自定义连接器,以满足这些额外要求。 定义自定义连接器后,当您在该环境中构建应用和流时,该连接器将可供使用,与内置连接器相似。

高级流程是标识或生成 API、描述 API、使用连接器以及认证开源。

标识或生成 API

您的第一个任务是检查连接器引用,以确定是否存在适合 API/服务的连接器。 如果不存在合适的连接器,则您可以自行生成自定义连接器。 您可以定义自定义连接器,以描述任何公共的 REST API(在 Internet 上提供)或专用的 REST API(仅在内部网络上提供)。 专用 API 需要通过本地数据网关才能访问内部资源。

如果不存在兼容的 API,开发人员可以通过使用能够托管 REST API 的任意所选技术(包括 Microsoft Azure FunctionsAzure 应用服务)来生成 API。 您还可以使用 Azure API 管理来提高 API 的可管理和治理。

描述 API

为了使 Power Apps 和 Power Automate 能够发现来自 API 的哪些触发器和操作可用,您必须在创建自定义连接器时标识它们。 要完成本任务,您可以在制作者门户中手动编辑连接器定义,或以支持的格式导入定义。 此流畅包括确定 API 的身份验证要求。

使用连接器

在环境中创建自定义连接器后,可以如同内置连接器一样,按照相同的方式使用自定义连接器。 除了创建连接器时所使用的环境外,这些连接器还可以在其他环境中使用。 连接器定义需要从创建连接器的环境导出,然后导入到需要它的任意环境中。 您还可以与其他人共享连接器,以允许他们像其他共享资源一样使用该连接器。

将连接器作为开源进行认证和共享

由于自定义连接器仅在存在其定义的环境中可用,因此无法供其他 Microsoft 客户使用。 通过将自定义连接器定义作为开源共享,您可以在 GitHub 上提供该连接器,供其他客户将其导入到他们的环境中。 通过认证您的连接器,您可以将您创建的自定义连接器作为所有客户环境中的预生成连接器提供。 如要认证连接器,您必须拥有 API 或具有 API 所有者提供的发布连接器的显式权限。

有关详细信息,请参阅认证流程

这是该流程中的可选步骤,仅当您要共享连接器并将其列为已认证时,才是必需步骤。 面向内部的连接器不需要完成本认证流程。

描述连接器

要定义连接器的操作和触发器,您需要对连接器进行描述。 要定义自定义连接器,可以仅描述您需要的 API 触发器和操作。 例如,如果 API 有 100 个操作和 10 个触发器可供使用,则您可以使用单个操作生成自定义连接器。 如果您的需求将来发生变化,您还可以进行更多描述。

在描述 API 时,您将至少使用以下一种方法。 如果选择导入 OpenAPI 定义,您仍然可以在门户中手动操作连接器的定义。

  • 在门户中手动创建 - 使用本方法时,您将使用 API 文档以及输入和输出示例,然后定义每个操作和触发器。 本方法适用于您没有权限导入定义的简单 API。 您还可以使用本方法在导入定义后优化定义。

  • 导入 OpenAPI 定义 - OpenAPI 是一个描述 REST 的规范,通过有效映射与 API 关联的所有资源和操作,简化开发和使用 API 的任务。 许多服务/API 都会发布 OpenAPI 定义,您可以导入该定义以在自定义连接器中描述 API。 当前支持导入版本 2.0,但不支持版本 3.0。 如果 API 发布者提供了 OpenAPI 定义,或者您正在开发 API,则本方法有助于您发布 API。

  • 从 GitHub 导入 - 从 Power Platform 连接器存储库导入连接器。 如果存储库中有已经发布的连接器,并且您想要导入它进行修改,或将其用作自定义连接器时,则此方法最为合适。

  • 从 Azure 导出 - 如果您的 API 是作为 Azure 应用服务、Microsoft Azure Functions 构建的,或者由 Microsoft Azure API 管理进行管理,那么您可以从这些服务中导出 API,它将自动创建初始自定义连接器定义。

使用经过身份验证的 API

自定义连接器体系结构支持使用经过身份验证的 API。 定义自定义连接器时,您将确定它应如何对 API 进行身份验证。 身份验证选项支持匿名、受密码保护、OAuth 2.0 和 API 密钥访问。

  • 不进行身份验证 - 本选择适用于允许匿名访问的 API,如果您不配置特定的身份验证类型,则默认使用该选项。

  • 基本身份验证 - 本选择适用于每次请求都需要发送用户名和密码的 API。

  • OAuth 2.0 - OAuth 2.0 是行业标准授权协议。 可以为使用 OAuth 2.0 的任何 API 配置此选项。 预生成的配置可供您从 Microsoft 服务(例如 Microsoft Entra ID、GitHub 和 Azure DevOps)中进行选择。 类似的预生成配置可用于其他服务,如 Dropbox、Slack、Stripe 等。 预生成的配置简化了配置标识提供程序时所需提供的信息。

  • API 密钥 - API 密钥是客户端在进行 API 调用时提供的令牌。 API 发布者通常会提供该密钥,并且该密钥必须包含在自定义连接器每次发出的请求中。

自定义连接器有助于使应用和流创建者更轻松地使用 API/服务。 大多数情况下,创建者可以在不使用连接器的情况下直接调用 API,但是,他们必须知道如何撰写请求并解释结果,然后处理身份验证。 每次应用或流使用自定义连接器时,都必须完成该流程。

此外,对于一个创建者来说,要实现通过事件启动自定义连接器(包括启动流的触发器)的能力,有时并不容易。 自定义连接器可帮助您更轻松地发现在构建使用连接器的应用或流时,如何使用操作及其结果。

下一单元介绍如何生成自定义连接器。