独立发布者认证流程

此流程适用于独立发布者。 如果您具有连接器的基础服务,请转到经过验证的发布者认证流程

备注

本主题提供有关在 Azure 逻辑应用、Power Automate 和 Power Apps 中认证独立发布者连接器的信息。 在按照本文中的步骤操作之前,请先阅读进行连接器认证

确定要为独立发布者计划构建的自定义连接器后,按照以下步骤为取得认证作准备,并生成连接器文件提交给 Microsoft。 对于独立发布者连接器,提交流程是通过 GitHub 存储库完成的。

阅读清单

独立发布者连接器组使任何人都可以将连接器发布到 Microsoft 连接器的官方列表中。 此组要求参与者了解并同意其清单的内容。 如果您打算为这项工作做出贡献或参与其中,请阅读并理解本文档

准备并提交您的连接器进行认证

作为独立发布者认证连接器的过程很简单。 在 GitHub 存储库中提交连接器之前,请确保您执行了本节的步骤。

通过提交您的独立发布者连接器,您的姓名将作为官方发布者出现在我们的产品中,并且您的连接器将应用一个通用图标。

重要

如果您在考虑构建和发布 Microsoft 第一方服务的连接器,请发送电子邮件至 connectorpartnermgmtteam@service.microsoft.com,并附上对连接器及其终结点的说明。 我们将与您一起寻找发布选项。

  1. 在开始构建连接器之前,请与 Microsoft 共享您的连接器建议。 通过在 Power Platform 文档和 GitHub 存储库的拉取请求中搜索连接器来验证连接器是否还未构建。 下表根据连接的状态为您提供了可以对连接执行哪些操作的选项。

    如果您建议的连接器 选项
    在 Power Platform 上已经存。 您无法构建连接器。
    已经作为独立发布者连接器存在。 您可以向连接器添加更多功能。
    当前是拉取请求建议。 您可以联系独立发布者来在连接器上与他们协作。
    是拉取请求,不是建议。 等待连接器通过认证和部署,然后向该连接器文件添加更新。
  2. 在您确认连接器不在平台上后,在 GitHub 存储库上共享您的连接器建议。 这样可以避免可能同样关注该连接器的同事进行重复的工作。 同时还可以为您制造一个在构建连接器时找到其他人一起协作的机会。

    要共享您的建议,请在 GitHub 存储库中提交拉取请求,并满足以下条件:

    • 拉取请求的标题使用“Proposal - <Connector Name> (Independent Publisher)”。 例如,Proposal - HubSpotCRM (Independent Publisher)。

    • 提交一个 readme.md 文件,其中尽可能多地包含您能够提供的全部详细信息,包括您的联系电子邮件(如果您愿意寻找协作者)。

    备注

    当您准备好在步骤 10 中提交所有文件进行认证时,请使用同一个拉取请求。

  3. 构建连接器。 有关如何构建连接器的说明,请转到从头开始创建自定义连接器

  4. 为您的连接器创建一个符合 Microsoft 要求的标题。 有关说明和示例,请转到为连接器提供标题

  5. 为连接器编写说明。 有关说明,请转到为连接器编写说明

  6. 定义摘要和说明。 有关说明,请转到定义操作和参数摘要及说明

  7. 定义确切操作响应。 有关说明,请转到定义确切操作响应

  8. 添加描述连接器及其终端服务的元数据。 要查看说明,请转到添加元数据

  9. 准备连接器项目。 有关说明,请转到准备连接器项目

  10. 提交连接器以进行部署。

    1. 将连接器项目提交到您在步骤 2 中创建的拉取请求,在拉取请求模板中填写清单,然后从拉取请求标题中删除“Proposal -”。

    2. Microsoft 认证工程师将在您最初提交请求后的 1-2 周内提供反馈。 如果反馈需要更新连接器,您需要提交对拉取请求的更新。 这还需要 1-2 周时间。 如果您需要解决 Swagger 错误,请转到修复 Swagger 验证者错误

      您将保留连接器的所有权,并可接受或拒绝对连接器所做的任何更改。

    3. Microsoft 将审批并合并拉取请求。

  11. 您的连接器将被提交进行认证。 在认证期间,预计会在 1-2 周内收到您的 Microsoft 联系人的回复。

  12. 等待部署。 在您的连接器经过验证并准备好进行生产部署后,我们会将其部署到所有生产区域。

    重要

    通常,部署连接器需要 15 个工作日。 无论您的连接器的大小或复杂程度如何,无论是新的还是更新,都需要这些时间。 为了保护完整性,连接器将接受相同的验证任务,以测试每个部署中跟踪的功能和内容。

    • 部署计划:我们的生产连接器部署计划从太平洋标准时间/太平洋夏令时周五早上开始。 当您准备好进行生产部署时,请至少提前 24 小时通知您的 Microsoft 联系人,以便我们将您的连接器包含在下一次计划部署中。

    • 区域部署:我们将通过电子邮件通知您连接器将部署到的区域的名称,因为部署到区域是分步完成的。 如果部署延迟或冻结,您将收到电子邮件通知。 详细信息:区域部署

    当您的连接器完成认证时,我们将在 Power Automate 博客上就连接器的市场营销商机与您联系。

  13. 随时更新连接器。 认证结束并发布连接器后,您可以随时向 GitHub 存储库中的连接器添加新操作和功能。 我们将根据需要重新认证您的连接器。

最佳提交实践

  • 每个拉取请求只能提交一个连接器。 这可以确保我们的验证过程顺利进行。

  • 连接器的拉取请求应遵循模式连接器名称(独立发布者)

  • 向支持电子邮件部分添加电子邮件。 以防我们需要与您联系。

  • 确保使用终端服务的隐私政策填写隐私政策参数。

  • 确保您的操作描述较为详细。 这可以确保用户能够了解您的操作。

  • 如果您的连接器使用 OAuth,请确保您在 readme.md 中提供有关如何创建应用的详细步骤。 否则将导致认证延迟。 有关要包括的文档的示例,请转到 Readme.md 示例

  • 请确保将响应架构添加到您的操作中,除非响应架构是动态的。 这将确保您的连接器会得到更多使用。

  • 查看提交之前的清单

Microsoft 保证

Microsoft 承诺做到以下保证事项:

  • 如果连接器有更新,我们会再次运行中断性变更工具和所有其他验证工具。

  • 如果连接器没有更新,我们保证它可以正常工作,除非有 API 更改或更新,或平台问题。

  • Microsoft 将在出现平台和安全问题时进行调查,并弃用损坏的独立发布者连接器。

下一步

在认证中测试连接器

提供反馈

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