自定义连接器生命周期概述
在开始创建自定义连接器之前,需要了解自定义连接器生命周期中涉及的每个步骤的所有详细信息。 下图显示了创建和使用自定义连接器时涉及的所有任务。
生成和保护 API
自定义连接器是 REST API 的包装器,它允许基础服务与 Power Apps、Power Automate 或 Azure 逻辑应用进行通信。 在开始创建自定义连接器之前,请确保具有功能完备的 API。
只要 API 可用作 REST API 或 SOAP API,就能对它使用任何语言和平台。 以下是一些示例:
公开提供的 API,例如 NOAA、美国人口普查 API 或欧盟开放数据门户。
创建并部署到任何云托管提供商(例如 Azure、Heroku 或 Google Cloud)的 API。
专用 API(仅对您的网络可见),通过本地数据网关提供连接性。
已部署到您的网络的自定义业务线 API。 如果可以通过公共 Internet 访问 API,则可以连接到该 API;或者,可以通过网关(目前已在 Power Automate 和 Power Apps 中提供)连接到 API。
对于 Microsoft 技术,建议使用以下平台之一:
为了保护 API 和连接器,可以使用以下标准身份验证方法之一(建议使用 Microsoft Entra ID):
适用于特定服务的 OAuth 2.0,例如 Microsoft Entra ID、Dropbox、GitHub 和 Salesforce
可以在 Azure 门户中为 API 设置 Microsoft Entra ID 身份验证,这样便无需通过代码来实现身份验证。 如果需要,还可利用 API 代码要求并强制执行身份验证。 有关适用于自定义连接器的 Microsoft Entra ID 的详细信息,请参阅使用 Microsoft Entra ID 保护 API 和连接器。
描述 API 并定义自定义连接器
拥有 API 后,下一步要考虑的是如何描述 API 的接口及其操作,以便 Power Apps、Power Automate 和 Azure 逻辑应用可以与 API 通信。 确定如何描述 API 后,可以创建连接器,然后将其注册到相应的服务。
使用以下方法之一来描述 API:
OpenAPI 定义(以前称为 Swagger 文件)。 有关详细信息,请参阅基于 OpenAPI 创建自定义连接器和什么是 Swagger。
还可以使用 Power Apps 和 Power Automate 中的自定义连接器向导,以空白自定义连接开始。 有关详细信息,请参阅从头开始创建自定义连接器。
OpenAPI 定义使用不同的格式,但都与语言无关、计算机可读的文档,用于描述 API 的操作和参数。 根据 API 所用的语言和平台,可以使用各种工具生成这些文档。 在后台,Power Apps、Power Automate 和逻辑应用使用 OpenAPI 定义连接器。
使用自定义连接器
可采用与使用内置连接器相同的方式使用自定义连接器。 创建到 API 的连接,并像调用内置连接器的操作一样调用该 API 提供的任何操作。
在 Power Apps 或 Power Automate 中创建的连接器可用于这两种服务,但在 Azure 逻辑应用中创建的连接器不能直接用于其他服务。 但是,可以使用创建 Azure 逻辑应用连接器时所用的相同 OpenAPI 定义轻松重新创建该连接器。
有关如何使用在 Power Apps、Power Automate 和 Azure 逻辑应用中创建的自定义连接器的详细信息:
共享自定义连接器
可以与组织中的其他用户共享连接器,共享方式与在 Power Apps、Power Automate 和逻辑应用中共享资源的方式相同。 共享是可选的,但在一些应用场景中您可能需要与其他用户共享连接器。 有关详细信息,请参阅在组织中共享自定义连接器。
认证自定义连接器
如果要在 Power Apps、Power Automate 和逻辑应用中与所有用户共享连接器,可以提交连接器进行 Microsoft 认证。 在此流程期间,Microsoft 会审核连接器、检查技术和内容合规性以及验证功能。 有关详细信息,请参阅提交连接器进行 Microsoft 认证。