参考来源与致谢
- 引用来源:Replacing a vSphere 6.x /7.x Machine SSL certificate with a Custom Certificate Authority Signed Certificate (2112277)
- 原作者:原页面署名作者或发布机构(剪藏记录未保存可核验的个人署名)
- 感谢词:感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写,并非原文转载;如权利人需要更正署名或来源信息,请联系本站。
适用场景 #
企业内已有自建 CA(如 Microsoft CA 或内部 PKI),需要将 vCenter Server 的 Machine SSL 证书由 VMCA 自签替换为自定义 CA 签发,以统一信任链、满足合规审计或消除浏览器告警。适用于 vSphere 6.x 与 7.x 的 vCenter Server Appliance 及 Windows 版 vCenter Server。具体版本行为差异请查阅对应版本官方文档。
准备与风险 #
- 确认已获取自定义 CA 的签发能力,并准备好根证书与中间证书链文件。
- 确认 vCenter Server 的 PNID(Primary Network Identifier)与计划写入证书的 FQDN 一致。
- 准备可用的维护窗口,替换期间 vCenter 相关服务会重启,管理面短时不可用。
- 务必先做快照或完整备份,并在测试环境验证流程后再操作生产环境。
- 记录当前证书信息与配置,便于回退。
破坏性操作提醒:替换证书会触发服务重启与自动回滚机制。操作前必须完成备份,并确认可在失败时恢复快照。
处理步骤 #
1. 启动 Certificate Manager #
vCenter Server Appliance:
/usr/lib/vmware-vmca/bin/certificate-manager
Windows 版 vCenter Server:
C:Program FilesVMwarevCenter Servervmcadcertificate-manager
需以管理员身份运行;启用 UAC 时选择“以管理员身份运行”。
2. 选择替换选项 #
选择选项 1(Replace Machine SSL certificate with Custom Certificate),按提示输入 [管理员账号] 的密码。
3. 生成 CSR 与私钥 #
选择选项 1(Generate Certificate Signing Request(s) and Key(s) for Machine SSL certificate),指定保存 CSR 与私钥的目录。填写 CSR 字段时注意:
- Country:两位大写字母,如
[国家代码]。 - Name:vCenter Server 的 FQDN,将作为 SAN。
- Organization:
[组织名称]。 - OrgUnit:
[部门名称]。 - State:
[省/州]。 - Locality:
[城市]。 - IPAddress:可选,填写
[服务器地址]。 - Email:
[邮箱地址]。 - Hostname:vCenter Server 的 FQDN,可填多个,逗号分隔,如
[内部主机名],vcsa1,[服务器地址]。 - VMCA Name:带 VMCA 的 vCenter Server FQDN,通常为外部 PSC 或内嵌 PSC 的 FQDN。
确认 PNID 与 Hostname 一致。查询 PNID:
Appliance:
/usr/lib/vmware-vmafd/bin/vmafd-cli get-pnid --server-name localhost
Windows:
"C:Program FilesVMwarevCenter Servervmafdd" vmafd-cli.exe get-pnid --server-name localhost
生成文件通常为 vmca_issued_csr.csr 与 vmca_issued_key.key。
4. 由自定义 CA 签发 #
将 CSR 提交给内部 CA,签发 Machine SSL 证书,保存为 machine_name_ssl.cer。若使用中间 CA,证书文件应为完整链:服务器证书 + 中间证书 + 根证书。根证书链文件保存为 Root64.cer。
5. 导入证书 #
返回 Certificate Manager,选择选项 1(Continue to importing Custom certificate(s) and key(s) for Machine SSL certificate),依次提供:
- Machine SSL 证书完整路径,如
/tmp/ssl/machine_name_ssl.cer或C:sslmachine_name_ssl.cer。 - 私钥完整路径,如
/tmp/ssl/machine_name_ssl.key或C:sslmachine_name_ssl.key。 - 签名证书链完整路径,如
/tmp/ssl/Root64.cer或C:sslRoot64.cer。
若存在多级中间 CA,Root64.cer 应包含全部中间 CA 与根 CA 的链。
验证方法 #
- 使用浏览器访问 vCenter Server,确认证书颁发者与链正确、无告警。
- 登录 vSphere Client,检查系统健康与证书状态。
- 确认相关服务已正常启动,管理功能可用。
- 如条件允许,使用证书检查工具核对 SAN 与 FQDN 一致性。
回退建议 #
- 若导入失败并触发自动回滚,先确认服务状态与证书是否恢复原状。
- 若需手动回退,恢复操作前的快照或备份,并重新启动 vCenter 服务。
- 回退后再次核对 PNID、FQDN 与证书链,排查失败原因后再重试。
常见问题 #
- CSR 中 Hostname 与 PNID 不一致,导致证书不匹配。
- 证书链不完整,缺少中间证书,导致信任失败。
- 私钥与证书不配对,导入时报错。
- 使用中间 CA 时未按完整链格式准备文件,导入在 0% 失败并回滚。
- 文件上传权限或路径问题,需确认目标目录可读写。
以上为通用操作思路,具体命令、选项与版本支持范围请以对应版本官方文档为准。
