跳转到主内容
Procore

重置服务账户的客户端密钥

传统服务账户的停用

所有传统服务账户都将在2024 年 12 月 31 日停用。

传统服务账户已于 2021 年 12 月 9 日弃用。 从 2024 年 10 月 1 日开始,我们将不再允许创建新的传统服务账户。 现有的传统服务账户将继续运作到 2024 年 12 月 31 日。

根据此时间线,目前使用传统服务账户的数据连接应用程序的开发人员需要更新他们的应用程序以使用开发人员托管服务账户,并且客户需要在停用日期之前安装这些更新后的应用程序。 所有在停用日期前未迁移的数据连接应用程序将停止运行。 Procore App Marketplace 上列出的任何未使用受支持的Procore API访问方法的应用程序,都将在停用日期前被移除。 有关其他信息,请参阅迁移数据连接应用程序以使用 DMSA

目标

使用公司管理员工具重置服务账户的客户端密钥。

背景

服务账户允许你支持需要IETF OAuth 2.0 框架规范中定义的客户端凭证授予流的集成。在这种情况下,应用程序需要一种方法能在任何特定 Procore 用户的环境之外恢复 OAuth 2.0 访问令牌。OAuth 2.0 为此提供了客户端凭证授权类型。新建服务账户时会生成唯一的 client_id 和 client_secret。有关在应用程序中实施客户端凭证授权流的信息,请参阅我们的开发人员门户上的OAuth 2.0 使用客户端凭证

需要考虑的事项

  • 所需用户权限:
    • 公司管理员工具的“管理员”级别权限。
  • 访问注意事项
    • 新服务账户包括:
      • client_id 服务账户标识符。
      • client_secret。密钥是将由服务账户使用的随机生成代码。仅在创建账户时对你可见。你可能需要记下 client_secret,然后将其保存到安全位置以备将来参考。
        重要提示!如果由于任何原因丢失 client_secret,Procore 建议新建服务账户
      • 默认情况下,新服务账户在创建时是没有权限(“无”)的。要更改权限设置,请参阅配置服务账户权限
  • 重要的公司目录注意事项:
    • 创建服务账户后,不得更改公司目录中的关联电子邮件地址。如果修改服务账户的电子邮件地址,服务账户将失效。
    • 不能将服务账户联系人添加到多个公司目录(仅限创建它的目录),否则它将停止工作。

步骤

 重要提示
请注意,重置客户端密钥将重置所选服务账户的所有权限和项目成员资格。
  1. 导航到公司级别管理员工具。
  2. 在“公司设置”下,点击服务账户
  3. 找到要为其重置客户端密钥的服务账户,然后点击查看
  4. 点击重置密钥以重置所选服务账户的客户端密钥。

reset-client-secret.png

  1. 点击继续以确认操作。

reset-client-secret-continue.png