服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务，不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动，严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外，不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- 旧SOAR API及其API Keys可用至2027年3月31日，之后停止工作；应提前完成脚本和集成迁移。
- webhook也需在3月31日前迁移；其既有API key认证保持不变，不能套用普通API的OAuth迁移。
- IAM权限迁移和旧Remote Agent仍对应2026年11月30日，不能把所有任务一起延期。
- Stage 2以前必须完成Stage 1；Chronicle使用区域端点，身份还需匹配平台角色与环境权限。
哪些期限延后，哪些还在11月？
Google Cloud 10月12日发布说明确认，SOAR API迁移至 Chronicle API 的期限由2026年11月30日延至2027年3月31日。同条公告出现在 Google SecOps 与 SOAR 两个产品分类下，属于一次期限调整，不是两项发布。
当前迁移总览仍要求在2026年11月30日前完成Stage 2的IAM角色转换，并说明旧Remote Agents在该日后不再工作。API与API Keys则可用至2027年3月31日，webhook的旧域名也对应3月31日。日历里应保留两个期限。
这些说明适用于 Google SecOps 统一客户与SOAR独立客户的对应迁移，不能泛化为所有Google Cloud API。官方给的是截止日期，没有公布统一停用小时或时区；不要自行填成美国或北京时间午夜，也不要压到最后一天执行。
先确认Stage 1，再拆成四份清单
Stage 1先迁移基础设施，独立SOAR客户还涉及登录认证迁移；Stage 2才包括IAM、API、webhook和Remote Agent认证。总览明确要求先完成Stage 1，不能因为API期限延后就跳过这个前置阶段。
在SOAR Settings > License Management中，系统版本号后显示Google.com用于确认Stage 1。显示Google.com与CloudIAM Enabled则用于确认SOAR权限已迁移至IAM；这两个标识不证明所有脚本和webhook已经改完。
假设团队同时维护一个自定义API脚本、一个webhook和两台Remote Agent。应把API调用、webhook地址、IAM绑定与Agent认证分别登记负责人、原方式、目标方式和验收结果。这是排期示例，并非本站执行过的客户迁移。
脚本迁移需要改URL，也需要改身份与数据
API指南覆盖通过集成、自定义脚本或自定义动作调用SOAR API的情况。先依据官方端点映射逐一找到新方法，并对照字段及数据模型变化；新API采用资源层级，不应把迁移简化成替换一个域名。
Chronicle只支持区域服务端点。按实例实际位置填写service_endpoint、project_id、location和instance_id，并核对所需方法的v1alpha、v1beta或v1版本。官方列有US、EU与其他区域地址；海外团队不能默认统一使用美国示例。
普通旧API的token认证迁向OAuth 2.0及Google Cloud IAM权限。若使用服务账号或工作负载身份，还需在SOAR Settings > Advanced > Group Mapping中关联身份、SOC角色和环境；拿到token并不等于有目标操作权限。
先在staging integration验证适用的自定义或商业集成修改，再部署生产。检查每个已迁移功能的响应、字段、权限和实际结果，而不是只看HTTP成功；自建应用则按自己的隔离验证流程处理。
webhook与Remote Agent不要照抄同一套认证
webhook需要在2027年3月31日前更新客户端目标地址，从siemplify-soar.com迁至对应googleapis.com端点，并按新请求格式处理。总览说明其认证保持不变，继续使用创建webhook时的API key；普通API的OAuth规则不能直接套在这里。
Remote Agent迁移针对认证基础设施，不要求因此替换Agent实例或主机，但需要按对应指南升级版本和认证方式。当前指南要求最低2.6.2，并为每台Agent分配独立服务账号，避免共用账号耗尽个体配额。
Agent指南还提供无密钥的Workload Identity Federation方向。若现有方案需要JSON密钥文件，它仍属于敏感凭据，应按组织的密钥管理要求保护。不要把实际key、webhook私有URL或实例凭据贴进公共示例。
IAM迁移后，哪些旧配置暂时要保留？
权限迁移需要Google Cloud控制台与SOAR使用对应身份，并先核对Cloud Identity或Workforce Identity Federation的组映射。统一客户还需满足SIEM侧IAM前置条件；具体授权角色以官方指南和组织的访问策略为准。
10月12日更新的总览要求迁移后由IAM管理权限，不再修改旧Permissions页，并为旧API兼容保留Group Mapping的Permission Group赋值。不要因为已经切到IAM，就把仍被兼容路径依赖的映射删除。
这里存在文档日期差异：10月9日的IAM指南仍写旧列在11月30日移除，10月12日总览则写3月31日。两页都要求不要删除赋值。排期采用最新总览，同时请Google代表确认实例实际行为，避免据旧日期自行清理。
今天怎样调整计划最有用？
先把IAM与Remote Agent的11月事项留在原计划，单独更新API和webhook的3月期限。为测试、回退与观察预留时间；延期增加的是迁移窗口，不代表你的集成已经兼容新API。
随后按端点、身份和数据模型核对清单，记录区域、实际权限与验证结果。Stage 1仍待处理时，先看产品通知并联系Google代表；总览对不同客户类型列有不同停机安排，不能把整个迁移宣传为统一零停机。
此次公告没有宣布费用调整或改变地区资格。实际合同、服务可用性和实施窗口仍需按账户事实确认；本文核对的是公开迁移说明，没有执行账户迁移或测出成功率。
资料来源
常见问题
API调用返回200，算迁移完成吗？
还不够。要覆盖每个使用中的方法、字段与身份权限，并确认业务结果、webhook接收及Agent连通等独立环节。单个成功响应不能代表全部工作流都正常。
看不到IAM迁移脚本怎么办？
最新总览提示，这可能是Stage 1尚未完成。先核License Management标识和自己的迁移通知，再联系Google代表确认；不要借API延期跳过前置阶段。
3月以后旧API的审计日志会不会自动消失？
总览说明3月31日前的旧API调用仍可在SOAR审计日志中访问，但这不是所有账户统一保留时长的承诺。日志收集、保留配置及合同条件仍需单独核对。