使用Microsoft客户协议批量证明工具

相应的角色:管理员代理 | 销售代理

适用的云:全局

Microsoft 客户协议批量证明工具让合作伙伴能够代表其客户确认接受Microsoft 客户协议。 此工具旨在帮助拥有众多客户并符合Microsoft客户协议更新工作范围的合作伙伴。

批量证明工具具有多个功能:

  • 使用开源 .NET SDK 的开源 .NET 控制台工具 (7.0)
  • 支持逗号分隔(.csv)文件格式,用于设置批量证明
  • 无需更改代码,并且可以使用 .NET 命令
  • 代码是可扩展的,可以增强为合作伙伴认为适合
  • 广泛的日志记录可帮助排查问题

此工具适用于通过 CSP 计划交易的直接计费合作伙伴和间接提供商。

先决条件

  • 合作伙伴帐户必须启用多重身份验证(MFA),因为客户工作区 API 强制实施 MFA。 可以按照合作伙伴租户的“管理 MFA”中的说明添加 MFA。

  • 确保已在主机上安装 .NET 7.0 SDK

  • 在合作伙伴中心配置本机应用程序:

    1. 在合作伙伴中心,选择“设置”(齿轮图标)>。

      合作伙伴中心设置菜单的屏幕截图,其中突出显示了“帐户设置”。

    2. 选择“应用管理”页。

    3. 选择“ + 添加新的本机应用”。 会为你创建一个新应用程序。 复制应用程序 ID 并使其方便。

      “应用管理”页的屏幕截图,其中突出显示了“添加新的本机应用”。

      现在,应该能够在 Azure Entra ID >应用注册下的Azure 门户中看到新创建的应用程序。

      “应用注册”页的屏幕截图,其中突出显示了合作伙伴中心本机应用。

    4. 使用“身份验证”选项卡为移动和桌面应用程序添加平台

      “身份验证”页的屏幕截图,其中突出显示了“配置平台”浮出控件,并突出显示了移动和桌面应用程序。

    5. http://localhost为应用程序配置和其他重定向 URI。

      “配置桌面 + 设备”页的屏幕截图,其中显示了重定向 URI。

    6. 保存后,验证重定向 URI 是否列在移动和桌面应用程序平台下,并在隐式授予和混合流选择该 ID 令牌

    若要了解详细信息,请参阅 合作伙伴中心身份验证

运行Microsoft 客户协议批量证明工具

  1. 转到 GitHub 上的合作伙伴中心 DotNet 示例,然后选择“代码,将文件提取到本地文件夹中。 在提取的文件夹中是一个名为 Microsoft Customer AgreementRefreshBulkAttestationCLITool 的子文件夹。 现在,你已准备好运行该工具。

  2. 打开命令提示符并导航到提取文件的文件夹。

  3. 运行以下命令:dotnet run。 如有必要,请等待生成完成。

  4. 提供应用程序 ID 和用户主体名称(UPN)。 使用你创建的本机应用程序 ID 和 UPN。

  5. 使用 MFA 登录到帐户。

  6. 该工具显示了以下各节中所述的以下选项:

    用于提取或更新客户协议记录的批量证明工具选项的屏幕截图。

完成身份验证

启动该工具后,它会尝试以无提示方式提取身份验证令牌。 如果失败,交互式模式会触发,浏览器窗口将打开并要求你登录。 使用登录合作伙伴中心时使用的相同凭据。

身份验证成功后,将显示以下消息。 关闭浏览器窗口并返回到控制台应用程序。

浏览器 localhost 窗口的屏幕截图,其中包含一条消息,指出关闭浏览器选项卡是可以的。

了解受支持的方案

使用该工具之前,请注意:

该工具支持两种方案: 提取客户协议记录更新客户协议记录

提取客户协议记录

此操作使用合作伙伴中心 API 提取合作伙伴租户Microsoft 客户协议刷新范围内的所有客户协议记录。 然后,该工具会将记录保存到所选路径中的 CSV 文件(CustomerAgreementRecords.csv)。

如果刷新了客户协议(通过批量工具、合作伙伴中心门户或创建协议 API),则不会在提取作中返回该记录,并且不包含在 CSV 文件中。 CSV 文件中返回的所有记录都是可操作的,必须更新。

运行提取操作的示例:

批量证明工具的屏幕截图,其中显示了从合作伙伴中心提取了 14 条客户协议记录的消息。

返回的字段的一部分包括最后一个合作伙伴确认协议的客户联系人详细信息。 如果存在先前的证明(合作伙伴代表客户确认的协议),则客户联系人详细信息将显示在以下字段中。 否则,它们是空白的。 为方便起见,为方便起见,如果接受代理在刷新验收时相同,则应更新这些详细信息,否则应进行更新以准确反映验收详细信息。 合作伙伴确认接受Microsoft客户协议后,将使用提供的电子邮件向客户发送电子邮件通知。

CSV 文件包含以下字段:

  • 客户租户 ID:客户的租户/Microsoft ID
  • 客户联系人详细信息:
    • FirstName:客户组织中最后一个合作伙伴确认协议中接受代理的名字
    • LastName:客户组织中最后一个合作伙伴确认协议中接受代理的姓氏
    • 电子邮件:客户组织中接受代理的电子邮件地址(最后一个合作伙伴确认的协议)
    • PhoneNumber:客户组织中接受代理的最后一个合作伙伴确认协议的电话号码
    • LastAgreementDate:最后一个合作伙伴确认协议的日期时间
  • 合作伙伴证明已完成:表示批量工具是否更新客户协议记录的一个布尔值。 此字段默认设置为 False ,应设置为 True 要更新的所有记录。
  • 客户帐户链接:用于在合作伙伴中心显示客户帐户页面的直接链接的非作字段。 该工具将填充此字段,但不可用于任何操作,不应对其进行修改。

示例 CSV 文件:

CSV 文件的示例输出的屏幕截图。

提示

在触发第一次更新操作前,建议将返回的客户协议记录副本保存到其他位置以便自己留存。 成功更新客户协议记录后,它们将被视为已解决,并且将来不会返回。

更新客户协议记录

此操作使用合作伙伴中心 API 从提取操作创建的 CSV 文件中更新客户协议记录。

在更新客户协议记录之前,请确保客户与客户组织中的接受代理的联系人详细信息准确且 up-to日期。 为此,请更新 CSV 文件中的以下字段:

  • 名字
  • 姓氏
  • 电子邮件
  • PhoneNumber (可选)

协议日期/时间会自动填充在合作伙伴中心。

若要标记要更新的客户协议记录,请将 CSV 文件中记录的 “合作伙伴证明已完成 ”字段设置为 True。 该工具仅处理此字段设置为 True 的记录。

更新从提取操作返回的前 2 个客户的 CSV 文件的示例:

CSV 文件的示例输出的屏幕截图,其中合作伙伴证明已完成为 True。

标记要更新的客户协议记录后,保存并关闭 CSV 文件,并从工具菜单中触发更新操作。 该工具会提示你提供 CSV 文件的路径。 成功分析记录后,该工具会显示找到的可操作记录数,并开始调度更新操作。

对于大量的协议,更新可能需要一些时间,因为每个调度调用更新的最大协议为 500。 一旦到达合作伙伴中心,更新操作就会异步进行。 当工具完成更新操作以及客户协议记录在合作伙伴中心更新时,可能会有延迟。

运行更新操作的示例:

批量证明工具的屏幕截图,其中包含一条消息,指出它处理了两条可操作记录,并完成了该操作。