Feinian Ids Platform Docs main platform-pre-change-checklist.md

变更前检查清单 SOP

适用场景

适用于平台配置变更、发布上线、认证策略调整、联邦或 SCIM 治理项调整、租户禁用恢复等高风险动作前的统一预检。

前置条件

  • 已明确变更目标、影响范围和执行窗口
  • 已准备回滚或兜底方案
  • 已知道本次变更影响哪些协议、租户或平台入口

操作入口

  • /health/live
  • /health/ready
  • GET /api/system/ops_summary
  • GET /api/system/ops_health_detail
  • 系统后台 Operations
  • 系统后台 Audit
  • 系统后台 Tenants
  • 系统后台 Federation

执行步骤

  1. 先确认本次变更影响的是平台整体、某类协议能力,还是某批租户或治理对象。
  2. 在变更前访问 /health/live/health/readyOperations,确认当前平台没有明显阻断异常。
  3. Audit 查看近期是否已有相关高风险动作、持续失败或未收敛的问题,避免在异常基线上继续叠加变更。
  4. 对受影响的对象做专项预检,例如租户状态、联邦 provider 状态、SCIM token 状态、SAML 证书状态或活动 token 风险。
  5. 明确回滚条件、验收链路和观察窗口,再进入正式执行。

验收结果

  • 当前平台基线状态明确
  • 影响对象、风险点和阻塞项已被识别
  • 回滚条件和变更后验收路径已明确

结果记录建议

  • 记录变更内容、执行窗口、责任人和回滚责任人
  • 记录变更前健康状态、当前提醒和近期异常摘要
  • 记录受影响租户、协议和后续验收清单

异常分流

升级 / 回滚条件

  • 若变更前已存在高风险异常或关键健康项失败,应暂停变更并升级评估
  • 若受影响对象过多但回滚路径不明确,不应直接进入执行窗口

关联文档