HighBond API 域名变更常见问题
Diligent One 正在将所有 HighBond API 流量从 highbond.com 迁移至 Diligent One 平台 域名 diligentoneplatform.com。
对于商业区域的客户，使用旧版 highbond.com 域名的 HighBond API 端点当前计划的截止日期为 2026 年 12 月 16 日，具体以最终确认为准。
对于在 机器人 应用程序内运行的脚本，您无需执行任何操作。Diligent One 将自动把针对 highbond.com 的引用更新为对应的 diligentoneplatform.com 引用。
请确保已更新 机器人代理 服务器的防火墙规则、允许列表和网络配置，以允许访问适用的 Diligent One 平台 主机。您还应更新直接调用 HighBond API 端点的任何外部脚本或应用程序，使其改用 Diligent One 平台 域名，以确保旧域名停用后仍能保持连接。
1.改变的是什么？
当前使用 highbond.com 主机的 HighBond API 请求将迁移至对应的 diligentoneplatform.com 主机。
例如：
https://apis-us.highbond.com/v1/orgs/11594/robots
将变为：
https://apis-us.diligentoneplatform.com/v1/orgs/11594/robots
变更的仅为主机名。区域、API 版本、组织 ID、端点路径、查询字符串、请求方法、请求标头、有效负载及身份验证均保持不变。
2.我是否需要编辑 ACL 机器人脚本？
您不必仅因主机名变更而编辑机器人源脚本。Diligent One 将自动检测 ACL 机器人脚本中的 highbond.com API 引用，并将其更新为对应的 diligentoneplatform.com 引用。
更新后的脚本将另存为新版本并为该机器人激活。
您应该：
验证您的关键 ACL 机器人作业。
排查可能阻止新域名的任何网络控制措施。
使用更新后的脚本版本作为后续编辑脚本的起点。
请避免基于仍引用 highbond.com 域名的旧版脚本进行激活或编辑，因为在实施 API 迁移后，这些引用可能会失效。
3.我是否需要编辑 HighBond 机器人脚本？
您不必仅因主机名变更而编辑机器人源脚本。。Diligent One 将自动检测 HighBond 机器人脚本中的 highbond.com API 引用，并将其更新为对应的 diligentoneplatform.com 引用。
更新后的脚本将另存为新版本并为该机器人激活。
您应该：
测试您的关键作业。
排查任何严格的代理、防火墙、TLS 检查、专用连接或域名允许列表规则。
使用自动更新后的脚本版本作为后续编辑脚本的起点。
请避免基于仍引用 highbond.com 域名的旧版脚本进行激活或编辑，因为在实施迁移后，这些引用可能会失效。
4.我是否需要编辑工作流机器人脚本？
您不必仅因主机名变更而编辑机器人源脚本。。Diligent One 将自动检测工作流机器人脚本中的 highbond.com API 引用，并将其更新为对应的 diligentoneplatform.com 引用。
更新后的脚本将另存为新版本并为该机器人激活。
您应该：
测试您的关键作业。
排查任何严格的代理、防火墙、TLS 检查、专用连接或域名允许列表规则。
使用自动更新后的脚本版本作为后续编辑脚本的起点。
请避免基于仍引用 highbond.com 域名的旧版脚本激活或编辑，因为在实施迁移后，这些引用可能会失效。
5.Diligent One 是否会更改我的机器人源代码？
Diligent 将系统检测 ACL、HighBond 和工作流机器人脚本中的 highbond.com API 引用，并将其更新为对应的 diligentoneplatform.com 引用。
更新后的脚本将另存为新版本并为该机器人激活。您无需自行编辑脚本。
您现有的脚本版本将保持可用。
6.我是否需要新的 API 令牌或密码？
仅因 API 主机名变更，无需使用新的令牌。现有的身份验证、密码定义及请求凭据均将继续有效。
您仍应测试身份验证，并确认您的网络控制措施允许向新的 API 主机发出请求。
7.迁移中包含哪些 API 命令？
文档中说明的迁移范围包括由 Analytics 使用的 API 命令族，以及可在 机器人 中运行的 ACL 脚本：
HB_API_GET
HB_API_POST
HB_API_PUT
HB_API_PATCH
HB_API_DELETE
请单独验证任何直接 HTTP 调用或自定义 API 包装程序，因为这些均在文档所载的自动机器人脚本更新范围之外。
8.我需要在 机器人 外部更新哪些内容？
机器人脚本的自动更新不会更新贵组织的网络控制措施或外部集成。
请确保更新在 机器人 执行路径之外调用 HighBond API 的集成，包括：
ACL 桌面脚本
外部调度程序
自定义应用程序
中间件或集成平台
直接 API 客户端与脚本
防火墙、代理、TLS 检查、专用连接以及域名允许列表配置
对于严格的允许列表，请使用适用于贵组织和区域的 Diligent One 平台 主机名。根据您的安全策略，端口 443 上的通配符（如 *.diligentoneplatform.com）可能适用于某些环境。
9.为什么防火墙、代理、TLS 检查、专用连接及允许列表的更新至关重要？
机器人脚本的自动更新会更改脚本中的 API 主机名，但不会更改贵组织的网络控制措施。
如果未放行新的 Diligent One 平台 主机名，即使脚本已成功更新，机器人请求仍可能会失败。
迁移之前，请确认您的 机器人 所使用的每条网络路径均可通过端口 443 上的 HTTPS 访问适用的 Diligent One 平台 API 和机器人主机。
审核及更新：
出站防火墙规则
代理配置及身份验证
TLS 检查策略和证书处理
专用连接路由
域名和 URL 允许列表
请从每个适用的执行路径验证这些设置，包括云端和本地部署的代理，以及每个受支持的商业 API 区域。
如果您的安全策略不允许使用通配符，请放行适用于贵组织及区域的具体 Diligent One 平台 主机名。
10.我现在该如何操作？
请参考以下核对清单为迁移做好准备：
清点调用 HighBond API 的 ACL、HighBond 和工作流机器人。
识别在机器人执行路径之外运行的 API 调用。
更新直接集成以使用 Diligent One Platform API 主机。
排查防火墙、代理、TLS 检查、专用连接以及域名允许列表规则。
在已确认的截止日期之前运行并验证关键机器人作业。
确认计划任务、重试机制、关联的机器人、身份验证、响应处理以及审计历史记录行为均能按预期继续正常运行。
11.我的数据或环境会发生变化吗？
域名迁移会更改用于访问服务和 API 的 URL。预计您的数据和底层环境不会因主机名迁移而发生任何变更。
12.这是否适用于所有区域？
当前计划的截止日期适用于商业区域。
GovCloud 和 FedRAMP 环境遵循单独的时间表，未经 Diligent One 确认，不得采用商业区域的截止日期。
13.这是否会影响 ACL Analytics 激活？
ACL Analytics 激活是独立于机器人 API 调用之外的考量事项。
某些较旧的 ACL Analytics 版本具有单独的域名和激活时间表，可能需要升级或采用替代激活方式（例如令牌激活或离线激活）。
请联系 Diligent 支持 或您的 Diligent 代表，以获取针对您的 ACL Analytics 版本和托管环境的专属指导。
14.我是否需要更新书签或登录设置？
本常见问题解答着重于机器人和 API 行为。
作为更广泛的域名迁移的一部分，您还应当：
更新相关书签。
审阅您的 Diligent One 平台 SSO 配置。
确保用户可以访问 Diligent One 平台 域名。
15.我是否需要提前提交支持工单？
无需仅为跟踪此迁移而创建支持工单。
如果出现以下情况，请联系 Diligent 支持：
机器人运行失败。
请求未按预期进行转换。
旧主机被跳过。
身份验证失败。
您的环境存在网络或兼容性异常。
16.重要时间安排说明
2026 年 12 月 16 日的商业区域 API 截止日期以及自动机器人脚本更新行为均基于当前规划的迁移指南。
Diligent 将在发布最终客户公告之前，确认最终日期、受支持的机器人范围以及任何例外情况。
