Sailing - SD-WAN | 更加可靠的互联网接入方案返回首页

Cisco SD-WAN 证书怎么配置?控制器与 WAN Edge 认证排查

更新于 2026-11-10 · sailingnet.shop

简答:如果你正在处理 SD-WAN 设备无法上线,先不要重置 RSA 或批量重签证书:先确认这是 Cisco Catalyst SD-WAN 环境,再依次检查组织名、系统时间、根 CA、设备授权列表和控制连接。本文以 Cisco Catalyst SD-WAN 为例,旧版 vManage、vBond、vSmart 与新版 SD-WAN Manager、SD-WAN Validator、SD-WAN Controller 的菜单和命令不能直接混用。

定义:SD-WAN 证书配置,是为控制组件和 WAN Edge 设备建立可验证身份、信任链及加密控制连接的过程。

三步速查:设备认证失败先查什么

本文编译整理自 Cisco 官方文档,正文中的命令、菜单和版本说明仅针对 Cisco Catalyst SD-WAN 资料核验。其他厂商可能也有控制器证书和设备证书,但字段、授权流程与命令未核实,不能直接套用。

先查对象入口或命令结果如何判断
设备证书与根证书show sdwan certificate installed
show sdwan certificate root-ca-cert
确认设备证书已安装、根 CA 链存在;企业 CA 场景还要确认信任来源正确。
本地身份与时间show sdwan control local-properties
show ntp associations
核对组织名、证书状态、有效期、Validator 地址和时间同步状态。
控制连接show sdwan control connections
show sdwan control connection-history
区分证书校验失败、授权失败、DNS或路由问题,以及 DTLS/TLS 路径故障。
管理器任务与证书操作SD-WAN Manager 工具栏的 Tasks 图标查看 CSR、安装、续期等任务的成功或失败详情。

上述检查顺序来自 Cisco 的证书管理和控制连接排障资料。设备侧命令在 Cisco IOS XE Catalyst SD-WAN 设备上核验过;控制组件或其他设备形态的命令名称可能不同,应以目标版本文档为准。参考:Cisco Catalyst SD-WAN Certificate Management、Cisco 控制和数据平面故障排查。

先分清四类材料:证书不等于授权

  • 控制组件证书:用于 SD-WAN Manager、SD-WAN Validator 和 SD-WAN Controller 证明身份并参与控制连接。
  • WAN Edge 设备证书:用于分支硬件设备、软件设备或云端设备建立身份。硬件和虚拟设备的证书获取方式可能不同。
  • 根 CA 或证书链:用于验证对端证书。企业 CA 场景下,设备需要安装能够验证控制组件证书的根证书或完整链。
  • 授权序列号列表:用于判断 WAN Edge 是否被允许加入覆盖网络。证书有效不代表设备已经获得授权。
  • 组织名:Cisco 部署指南说明,组织名需要在 SD-WAN Manager 中配置后才能生成 CSR,并会在控制组件认证过程中被检查。

组织名与证书字段不能简单等同为“所有证书的 O 字段”。Cisco 的部署指南说明,企业 CA 签发控制组件证书时,CSR 中的 Organizational Unit 会匹配 SD-WAN 覆盖网络组织名;CA 签发时不应擅自覆盖 CSR 已有字段。根 CA 自身的 Organization Name 则不要求与覆盖网络组织名相同。参考:Cisco Catalyst SD-WAN 控制组件证书与授权序列号列表部署指南。

版本与入口对照:不要把 17.x、20.18.1 和 26.x 混在一起

资料或版本范围可核验变化适用边界
Cisco IOS XE Catalyst SD-WAN 17.x证书管理章节覆盖 WAN Edge 证书状态、控制组件 CSR、安装签发证书、RSA 密钥对重置和证书活动日志。这是 IOS XE Catalyst SD-WAN 设备与 SD-WAN Manager 的入门和操作资料,不表示所有控制组件版本都使用同一菜单。
SD-WAN Manager 20.16.x旧流程可从 Configuration > Certificates 进入 Controllers 或 WAN Edge List,生成或续订 CSR。官方页面明确说明,部分旧流程在 20.18.1 或 20.18.x 起被新的 Control Components Certificate Management 或 WAN Edges Certificate Management 工作流替代。
SD-WAN Manager 20.18.1官方证书管理页面将旧 CSR 流程标为已替换;该版本还引入 Cisco PKI 作为虚拟路由器的默认证书方法,并说明升级后既有证书可能继续保留,续期时行为可能变化。这是 SD-WAN Manager 版本信息,不应写成 IOS XE 设备版本;实际菜单仍需结合部署版本确认。
Cisco IOS XE 17.18.1a 与 SD-Routing 26.x 资料官方 26.x 页面将 Enterprise Certificate Settings、EST 和 SCEP 列为 Cisco IOS XE 17.18.1a 引入的证书管理功能,并列出支持的平台。该功能适用于页面列出的 SD-Routing 平台;不能据此断言所有 Cisco SD-WAN 设备或所有 17.18.x 小版本都具备相同行为。
控制组件 20.16.1、20.15.217.x 证书管理页面说明,相关控制组件版本支持 2048 至 4096 位 RSA 密钥;低于对应版本降级前需核对 4096 位证书限制。这是控制组件版本关系,不是通用的设备软件兼容性承诺。

官方资料还说明,17.13.1a 起部分界面中的 Controllers 标签改称 Control Components。版本升级或界面找不到旧按钮时,应先核对目标版本文档,而不是直接判断功能被删除。参考:Cisco IOS XE Catalyst SD-WAN 17.x Certificate Management、Certificate Management for SD-Routing Devices。

控制器证书配置:适用条件、入口、动作与回滚

  1. 适用条件:适用于已经部署 Cisco SD-WAN Manager、Validator 和 Controller,并准备使用 Cisco PKI、企业 CA 或当前版本支持的企业证书方式的环境。先记录 Manager、控制组件和设备版本。
  2. 入口:旧版资料使用 Configuration > Certificates,再进入 Controllers 或 Control Components;20.18.1 及相关版本应优先查找 Control Components Certificate Management 工作流。
  3. 动作:确认 Administration > Settings 中的 Organization Name,再生成控制组件 CSR。企业 CA 签发时保留 CSR 中由平台生成的关键字段,签发后导入完整证书链并安装。
  4. 预期结果:SD-WAN Manager 证书页面显示安装或有效状态;设备侧 show sdwan control local-properties 能看到正确的组织名、根证书链状态、证书有效期和 Validator 地址。
  5. 失败分支:CSR 无法生成时,先查组织名、权限和控制组件状态;证书安装失败时,核对证书是否对应原 CSR、链是否完整、系统时间是否正确;安装成功但不上线时,转到授权、DNS、路由和控制连接历史。
  6. 风险:不要在没有备份和维护窗口时执行 Reset RSA、批量失效证书或同时替换全部控制组件证书。Cisco 文档说明,Reset RSA 会生成新的公钥和私钥。
  7. 回滚:保存旧证书状态、CSR、根 CA 链、授权列表和控制连接输出;先在单个控制组件或非生产设备验证,再扩大范围。

SD-WAN Manager 还可以在 Tasks 图标中查看证书操作任务的成功和失败详情。若通过手工方式安装证书,官方资料提示管理器可能不会为证书过期生成相同的告警,因此需要保留人工检查流程。参考:Cisco Certificate Management 操作章节。

端口、NTP 和网络前提:只在特定流程下检查

NETCONF 和 SSH 不是所有证书场景的“万能必需端口”,而是 Cisco 控制组件初始部署或证书安装流程中的特定前提。Cisco 部署指南说明:当控制组件之间尚未建立 DTLS/TLS 连接时,VPN 0 隧道需要允许 NETCONF 和 SSH;SD-WAN Manager 使用 NETCONF TCP 830 与控制组件通信,并通过 SSH 相关的 SCP 方式加载证书,TCP 22 也需要按流程放行。

  1. 确认适用条件:先判断是否是新控制组件部署、尚未建立 DTLS/TLS,或正在执行需要 Manager 连接控制组件的证书安装流程。
  2. 确认入口:在控制组件上通过 SSH 或控制台查看运行配置,并检查 VPN 0 隧道服务。
  3. 确认动作:仅在确认适用时核对 allow-service sshd 和 allow-service netconf,并检查防火墙是否允许 TCP 22、TCP 830。
  4. 确认时间:在 Manager、Validator、Controller 和 WAN Edge 上检查 NTP。Cisco 资料使用 show ntp associations 查看时间同步状态。
  5. 失败分支:如果端口可达但控制连接仍失败,检查 DNS、VPN 0 路由、Validator 地址和控制连接历史;不要仅凭 TCP 830 可达就判定证书正确。
  6. 回滚:只恢复本次变更的服务放行或防火墙规则,保留原配置快照,避免为排查证书而长期扩大管理面暴露。

参考:Cisco 控制组件证书部署前提。

按错误现象排查:看到什么结果后走哪条分支

现象或错误方向先看什么下一步
证书过期、尚未生效或状态无效show sdwan control local-properties 中的证书状态和有效期;同时检查 NTP。先修正时间或确认目标证书,再安排续期;不要先重置 RSA。
根 CA 链状态异常show sdwan certificate root-ca-cert,必要时筛选 Issuer。确认设备是否信任签发对端证书的 CA;企业 CA 场景补齐正确链后重新验证。
组织名不匹配对照 Manager 的 Organization Name、设备本地输出和 CSR 中的相关组织字段。区分覆盖网络组织名、CSR 的 OU 和根 CA 自身字段,不要直接修改根证书的 Organization Name。
证书有效但设备未上线检查授权序列号列表、设备序列号和控制连接历史。若出现序列号未授权或 Board ID 未验证方向,先修正授权状态。
CRTVERFL 或类似证书验证失败查看设备根证书,并在控制组件侧查看 /var/log/tmplog/vdebug。判断是设备缺少对端 CA,还是控制组件拒绝了设备证书。
DCONFAIL、DHSTMO 或控制连接超时show sdwan control connection-history,结合两端路径和抓包。先排查丢包、路由、地址、端口和 DTLS/TLS 握手;不要把底层丢包直接当成证书故障。

Cisco 的排障文档列出了 CRTVERFL、CTORGNMMIS、CERTEXPRD、SERNTPRES、DCONFAIL 等错误方向,并说明控制连接历史中的本地错误、远程错误和重复计数应结合查看。对于控制组件侧日志,文档给出的示例位置是 /var/log/tmplog/vdebug;该路径和命令应按目标平台核对,不要视为所有形态通用。参考:Cisco 解决常见的 SD-WAN 控制和数据平面问题。

续期、替换和 Reset RSA:低风险顺序

  1. 先记录:保存软件版本、证书状态、有效期、CSR、根 CA 链、授权序列号列表和控制连接历史。
  2. 先确认续期方式:26.x 证书管理资料说明,EST 和 SCEP 可用于自动化注册与续期,但后续续期仍可能需要在证书过期告警后由管理员手动发起,不能假设所有续期都会无人工完成。
  3. 再做单台验证:先在单个设备或维护窗口测试新证书链和控制连接,确认 Validator 能识别新证书后再扩大范围。
  4. 最后考虑 Reset RSA:仅当确认需要生成新密钥对,或现有密钥与 CSR、证书不匹配时使用。Cisco 官方页面明确说明该操作会生成新的公钥和私钥。
  5. 回滚:如果新证书无法通过验证,停止批量操作,保留失败任务详情,恢复到尚未替换的设备或旧证书流程;是否能直接恢复旧证书,取决于具体版本、证书状态和密钥是否仍保留。

核验日期为 2026-11-10。由于 Cisco 的菜单和工作流会随 SD-WAN Manager、控制组件和 IOS XE 版本变化,生产环境应以目标版本官方页面和设备实际界面为准。

常见问题

SD-WAN 证书配置一定要使用企业 CA 吗?

不一定。Cisco 官方资料同时覆盖 Cisco PKI、企业 CA 和相关控制组件证书管理方式。应根据目标版本、部署模式和组织的证书管理要求选择,不能把企业 CA 视为所有环境的必选项。

证书有效,为什么 WAN Edge 还是无法上线?

证书有效只代表证书本身通过了部分检查。还要核对设备是否在授权序列号列表中、组织名和相关 CSR 字段是否匹配、根 CA 是否受信任,以及 NTP、DNS、VPN 0 路由和控制连接路径是否正常。

组织名就是证书里的 Organization Name 吗?

不能简单这样理解。Cisco 部署资料说明,覆盖网络组织名会参与认证,企业 CA 签发时 CSR 的 Organizational Unit 会匹配该组织名;但根 CA 自身的 Organization Name 不要求与覆盖网络组织名相同。应分别核对 Manager 配置、CSR 字段和 CA 链。

NETCONF TCP 830 和 SSH TCP 22 是所有证书场景都必须开放吗?

不是。Cisco 资料将其作为控制组件尚未建立 DTLS/TLS、需要由 SD-WAN Manager 生成 CSR 或加载证书时的部署前提。已建立连接或不同管理流程的环境,应按目标版本和拓扑核对端口,不要盲目扩大开放范围。

什么时候可以执行 Reset RSA?

只有在确认需要生成新的公私钥对,或现有密钥与 CSR、证书不匹配时才考虑。该操作会改变密钥材料,执行前应保存配置和证书状态,并安排维护窗口。

旧版 vManage、vBond、vSmart 和新版名称怎么对应?

新版资料通常使用 SD-WAN Manager、SD-WAN Validator 和 SD-WAN Controller;旧版资料仍可能使用 vManage、vBond 和 vSmart。角色大体对应,但菜单、证书工作流和命令仍需按目标软件版本重新核对。

相关阅读

参考资料

  1. Cisco Catalyst SD-WAN Getting Started Guide:Certificate Management
  2. Cisco Catalyst SD-WAN Control Components Certificates and Authorized Serial Number File Prescriptive Deployment Guide
  3. 解决常见的 SD-WAN 控制和数据平面问题
  4. Certificate Management for SD-Routing Devices