文档目录

问题说明

本文用于排查“ZSphere 自签证书有效期设置边界”类问题。

现象

  • 客户希望设置更长有效期自签证书。
  • 平台证书管理中当前只能按产品支持范围选择有效期。

适用环境

  • 产品:ZVF
  • 版本:4.x
  • 组件:ZSphere
  • 涉及对象:证书管理
  • 场景:安全与证书类问题,需结合当前版本、部署形态、存储类型和操作时间线确认。

可能原因

  • 产品当前证书管理能力限制自签证书最大有效期。
  • 合规要求与产品默认能力存在差异。
  • 手工替换证书可能导致 UI/API/迁移工具信任链异常。

排查步骤

按顺序执行以下检查,并记录受影响对象、发生时间、完整报错和当前状态。

  1. 确认当前证书类型、自签或外部 CA,以及客户合规要求。
  2. 优先使用系统管理 -> 证书管理中的受管入口生成或导入证书。
  3. 如需超过产品支持有效期,先确认版本能力或需求边界,不建议直接手工替换。
  4. 替换证书后验证 UI、API、迁移工具和浏览器信任状态。

处理方法

  1. 优先通过系统管理中的证书管理入口生成或导入符合当前有效期要求的证书。
  2. 对于超出产品支持边界的有效期需求,使用外部 CA 证书或联系 ZStack 官方技术支持确认支持方式,不直接手工替换系统证书。

验证方法

  • 证书颁发者、有效期和域名与预期一致。
  • UI、API、迁移工具和浏览器可以正常建立受信任连接。
ZSphere 自签证书有效期设置边界 | 故障排查 · KB | ZStack 资源中心