认证自定义连接器

已完成

要使自定义连接器作为经过认证的连接器对逻辑应用、Power Automate 和 Power Apps 中的所有用户可用,请将连接器提交给 Microsoft 进行认证。 Microsoft 将审核连接器,如果该连接器符合认证条件,它将批准该连接器进行发布。 在发布连接器后,它将加入公开可用连接器的完整列表

在认证过程中,Microsoft 将检查每个步骤,包括一些高级步骤。 后期更新也会应用相同的步骤,但根据更新的范围,可能会更快完成这些步骤。

包括计划、开发、创建开源项目、提交、认证、测试、部署和支持步骤的认证流程图。

计划

计划是认证过程中的第一步,因为您会开始设想连接器的外观。 构建其他人能使用的连接器之前,应做好相应的计划。

第一步是验证是否已有连接器,如果连接器已存在,您应该考虑将您建议的更改贡献给现有连接器,因为 Microsoft 不会为同一 API 认证多个连接器。

您应考虑以下几个重要的计划因素:

  • 确定初始提供的触发器和操作。 您无需包含您的所有 API,但初始的一组触发器和操作应是十分有用的。 如果过于限制初始版本中提供的内容,用户会因缺少常见方案的功能而感到沮丧。 请考虑编写或草绘一个或多个可在 Microsoft Power Automate 中使用您的连接器创建的工作流。 本方法有助于确定要包括在连接器中的 API。

  • 评估 API 可能需要进行哪些更改以支持触发器,或者以其他方式改善功能以提供用户更易使用的连接器。

  • 考虑如何处理身份验证,衡量当前 API 身份验证方式和自定义连接器支持的功能并进行必要的调整。

  • 考虑如果 API 使用 API 密钥,要使用连接器的用户如何获取密钥。

  • 查看连接器策略模板,确定实现模板是否有助于连接器的使用。

  • 查看支持的 OpenAPI 扩展,了解其适用性。 例如,经过认证的连接器通常可实现测试连接。 此外,如果参数包含可选的值列表,则使用动态值扩展可能会很有帮助。

对于新连接器的认证,您不必等到完成连接器开发后再注册认证。 有关详细信息,请参阅已验证发布者认证流程独立发布者认证流程。 您可能会收到来自 Microsoft 代表的沟通消息,Microsoft 代表将帮助您更好地了解自定义连接器、向您说明开发进度以及指导您完成认证流程。

要更新经过认证的连接器,在计划时,最重要的是不要影响现有用户的连接。 本问题将在后面的单元中详细讨论。

开发

在开发步骤中,主要关注点在于为您的自定义连接器准备好 API 及定义,以便提交。 在继续下一步之前,应确保已整理好自定义连接器定义并正确完成所有要发布的命名。

创建开源项目

本介绍单元涵盖了如何创建开源连接器的简要概览。 您可将已验证发布者的认证连接器放在 certified-connectors 文件夹中,将独立发布者连接器放在 independent-publisher-connectors 文件夹中。 在提交拉取请求之前,请确保执行以下任务:

  • 编辑连接器文件以添加所需的特定元数据。 连接器文件必须包含描述连接器及其终端服务的特定元数据。

  • 对下载的连接器运行 paconn 验证命令,然后解决错误。

要运行验证,请使用以下命令:

paconn validate --api-def [Location of apiDefinition.swagger.json]

通过验证后,可以将拉取请求提交到 GitHub 存储库的 dev 分支。 本操作将启动自动化流程,该流程将对拉取请求进行初始验证,并确保您已签订正确的贡献协议。 完成自动验证后,会将请求分配给 Microsoft 进行初始审核。 如果审核者发现需要更正的问题,他们将输入有关此拉取请求的注释,并要求您解决这些问题,然后重新提交拉取请求。 所有问题都解决后,拉取请求将合并到存储库中。

独立发布者提交

如果您要发布独立发布者连接器,下一步是将连接器项目提交到您在提交连接器方案时创建的拉取请求,填写拉取请求模板中的检查清单,并删除拉取请求标题中的“Proposal -”。 Microsoft 认证工程师将在您提出最初请求后的 1-2 周内进行反馈。 如果反馈要求对连接器进行更新,您需要针对拉取请求提交更新。 如果

已验证发布者提交

下一步是根据 Microsoft 联系人的要求,在 ISV Studio 中提交您的连接器以进行认证。 ISV Studio 是管理后续认证流程的门户,它将为您提供连接器部署后的运行状况。

在提交到 ISV Studio 进行认证的过程中,您应准备好提供:

  • 连接器测试信息,例如 API 密钥、其他身份验证详细信息,或任何有助于测试员使用连接器的详细信息。

  • Intro.md 文件,其中包含要在连接器公共文档中提供的信息。 您可以在提交到 ISV Studio 文档中找到模板。

随着认证过程的进行,您将在门户中了解更新,并收到来自主要联系人的电子邮件。 如果遇到问题,应先解决问题,然后才能继续认证。 在连接器通过认证后,会计划将其部署到“预览”区域以进行测试。

测试

在认证过程中,连接器会部署到“预览”区域以完成测试。 现在,在将连接器部署到全球所有区域之前,您有机会确保部署的连接器能够正常工作。 确保在 Power Apps、Power Automate 和逻辑应用中测试连接器的所有功能。

有关详细信息,请参阅有关在认证中测试连接器的说明

部署

测试完成后,将连接器部署到所有公共区域。 本过程预计需要 7 到 10 个工作日,因为 Microsoft 会逐步部署到其世界各个区域。 每完成一个区域的部署,您都会收到通知。

支持

现在,连接器已公开发布,您可以从 ISV Studio 监视已验证发布者连接器的性能。 确保支持人员了解如何将连接器与 Power Apps 或 Power Automate 结合使用,以确保他们能够为遇到问题的用户提供支持。