CFCA SSL 证书 Apache 部署实战:证书链、国密双算法与 398 天有效期配置指南
问题背景与根因:为什么 CFCA 证书在 Apache 上“浏览器正常、程序报错”
CFCA(中国金融认证中心)签发的 SSL 证书支持国密 SM2 与国际 RSA/ECC 双算法,常用于银行、政务、国企等有合规要求的站点。把证书部署到 Apache 时,最常见的现象是:浏览器访问 https://example.com 显示小锁正常,但 curl、Java、微信小程序、Android 客户端却报证书链错误。根因通常不是证书本身,而是 Apache 只加载了叶子证书,没有把 CFCA 中间证书一并下发。Apache 2.4.8+ 推荐把站点证书与中间证书合并成 fullchain 文件,写入 SSLCertificateFile;2.4.8 以下版本才使用 SSLCertificateChainFile 单独指定链文件。另一个高频根因是私钥与证书不匹配,常见于 CSR 生成后私钥被覆盖、或从旧服务器迁移时只拷了证书。第三是续期后没有 reload/restart,Apache 进程仍持有旧证书。第四是有效期规则变化:公有 CA 签发的 RSA/ECC 证书最长有效期 398 天(2020 年 9 月 1 日起生效),Let’s Encrypt 为 90 天,CFCA 国际算法证书同样受浏览器信任策略约束,必须建立到期监控与自动续期流程。第五是国密 SM2 场景:标准 Apache + 普通 OpenSSL 不支持 SM2 握手,需要 Tongsuo/BabaSSL 等支持国密的 Apache 分支或国密 SSL 模块,并同时配置签名证书与加密证书。先用 openssl s_client 看链,再查 Apache 错误日志,能快速定位。
部署前准备:核对 CFCA 下发的证书、私钥与 fullchain 合并
CFCA 通常下发站点证书(.crt/.pem)、中间证书/CA 链文件(ca_bundle.crt 或 chain.crt)、私钥(.key)。先列目录并校验证书主体、签发者、有效期与序列号:
ls -l /etc/ssl/cfca/
openssl x509 -in /etc/ssl/cfca/example.com.crt -noout -subject -issuer -dates -serial
openssl x509 -in /etc/ssl/cfca/example.com.crt -noout -text | grep -E 'Public Key Algorithm|Signature Algorithm'
openssl verify -CAfile /etc/ssl/cfca/ca_bundle.crt /etc/ssl/cfca/example.com.crt
合并 fullchain 时顺序不能反:站点证书在前,中间证书在后,根证书一般不需要放入(客户端自带根库)。合并后再次 verify:
cat /etc/ssl/cfca/example.com.crt /etc/ssl/cfca/ca_bundle.crt > /etc/ssl/cfca/example.com_fullchain.crt
openssl verify -CAfile /etc/ssl/cfca/ca_bundle.crt /etc/ssl/cfca/example.com_fullchain.crt
核对私钥匹配。RSA 用 modulus 的 MD5 比对;ECC 用公钥 DER 比对:
openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
openssl x509 -in example.com.crt -pubkey -noout | openssl pkey -pubin -outform der | openssl md5
openssl pkey -in example.com.key -pubout -outform der | openssl md5
国密 SM2 证书要确认算法字段:openssl x509 -in sm2.crt -noout -text | grep -E ‘SM2|sm2’,普通 OpenSSL 可能无法解析,需用国密版 openssl 或 gmssl。权限设置为私钥 600、属主 root,目录 755。若 CFCA 提供 pfx/p12,可先导出:openssl pkcs12 -in file.pfx -nodes -out all.pem,再拆分证书与私钥。准备阶段把 fullchain、私钥、链文件路径固定到 /etc/ssl/cfca/,后续 Apache 配置只引用这些路径,避免续期时改错文件。
Apache 完整实操步骤:启用模块、配置 VirtualHost、configtest 与 reload
Debian/Ubuntu 先启用模块并重启,让 ssl、headers、rewrite 生效:
a2enmod ssl headers rewrite
apachectl -M | grep -E 'ssl|headers|rewrite'
systemctl restart apache2
RHEL/CentOS/Rocky 安装 mod_ssl 并确认模块:
dnf install -y mod_ssl
httpd -M | grep -E 'ssl_module|headers_module'
systemctl restart httpd
编辑 443 虚拟主机,核心指令如下(Apache 2.4.8+):SSLEngine on;SSLCertificateFile 指向 fullchain;SSLCertificateKeyFile 指向私钥;旧版 Apache 2.4.8 以下额外写 SSLCertificateChainFile 指向中间证书,且 SSLCertificateFile 只放叶子证书。协议建议只开 TLSv1.2 与 TLSv1.3:SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1。HSTS 要等全站 HTTPS 稳定后再加,值用 max-age=31536000。OCSP stapling 可减少握手延迟:SSLUseStapling on 与 SSLStaplingCache shmcb:/var/run/ocsp(128000)。配置写入 /etc/apache2/sites-available/example-ssl.conf 或 /etc/httpd/conf.d/ssl.conf。
执行语法检查,通过后 reload 而不是 restart,减少连接中断:
apachectl configtest
# 输出 Syntax OK 后
systemctl reload apache2 # Debian/Ubuntu
systemctl reload httpd # RHEL/CentOS
如果 configtest 报 AH00526 或 SSLCertificateFile: file does not exist,先检查路径与 SELinux 上下文;RHEL 上可用 restorecon -Rv /etc/ssl/cfca/ 修复。续期后同样执行 configtest + reload,并用 openssl x509 -enddate 确认新到期时间。注意公有 CA 证书最长 398 天,建议在到期前 30 天完成续期,避免触发浏览器不受信。国密 SM2 场景不要直接套用上述标准 Apache 配置,需换用支持国密的 Apache 并加载国密套件。
配置示例:Apache 2.4 双算法与国密 SM2 场景
下面是一份可直接改域名使用的 Apache 2.4 配置,包含 80 跳转、TLS 1.2/1.3、HSTS、OCSP stapling 与日志:
<VirtualHost *:80>
ServerName example.com
ServerAlias www.example.com
Redirect permanent / https://example.com/
</VirtualHost>
<VirtualHost *:443>
ServerName example.com
ServerAlias www.example.com
SSLEngine on
SSLCertificateFile /etc/ssl/cfca/example.com_fullchain.crt
SSLCertificateKeyFile /etc/ssl/cfca/example.com.key
# Apache 2.4.8 以下才需要:
# SSLCertificateChainFile /etc/ssl/cfca/ca_bundle.crt
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384
SSLHonorCipherOrder off
Header always set Strict-Transport-Security "max-age=31536000; includeSubDomains"
SSLUseStapling on
SSLStaplingCache shmcb:/var/run/ocsp(128000)
ErrorLog /var/log/apache2/example_ssl_error.log
CustomLog /var/log/apache2/example_ssl_access.log combined
</VirtualHost>
若使用 ECC 证书,把 SSLCipherSuite 中的 ECDSA 套件放前;RSA 证书则保留 RSA 套件。SSLCertificateFile 必须指向 fullchain,否则 Java/curl 会报 unable to get local issuer certificate。国密 SM2 场景需要支持国密的 Apache(如 Tongsuo Apache)与国密 SSL 模块,配置思路是同时加载签名证书/私钥和加密证书/私钥,并启用 SM2 套件;不同分支指令名可能不同,常见仍以 SSLCertificateFile、SSLCertificateKeyFile 为基础,再增加加密证书指令。验证时用国密浏览器或 gmssl s_client,不能只用普通 Chrome。若站点同时服务国际与国密客户端,建议双端口或双 VirtualHost:443 走 RSA/ECC,另一个端口走 SM2,避免套件协商失败。配置改完必须 apachectl configtest,不能只看 systemctl status 的 active。
对比表格:Apache 版本、证书链配置与算法选择
不同 Apache 版本对证书链的写法不同,配错会直接导致“浏览器正常、程序报错”。下表按版本和算法给出选择:
| 场景 | Apache 版本 | SSLCertificateFile | 链文件配置 | 说明 |
|---|---|---|---|---|
| 推荐写法 | 2.4.8+ | fullchain(叶子+中间) | 不需要 SSLCertificateChainFile | 链随证书一起下发 |
| 旧版写法 | 2.4.8 以下 | 仅叶子证书 | SSLCertificateChainFile 指向中间证书 | 不能把中间证书塞进 SSLCertificateFile |
| 2.2 老环境 | 2.2.x | 叶子证书 | SSLCertificateChainFile | 建议升级,2.2 已停止维护 |
| 算法 | 典型密钥/证书 | 浏览器兼容 | 性能 | 适用 |
|---|---|---|---|---|
| RSA | 2048/3072 位 | 最广 | 握手较慢 | 通用站点、老客户端 |
| ECC | P-256/P-384 | 现代浏览器与移动端 | 握手快、证书小 | 移动端、API 网关 |
| SM2 | 国密双证书 | 需国密浏览器/模块 | 合规优先 | 金融、政务国密改造 |
有效期方面:公有 CA 的 RSA/ECC 证书最长 398 天,Let’s Encrypt 为 90 天;CFCA 国际算法证书同样受 398 天规则约束,国密证书按合规与合同约定执行。部署时不要再用“买多年证书一次装完”的旧思路,应把续期、reload、到期监控纳入流程。算法选择上,面向公众的站点优先 ECC + RSA 双证书或 ECC 单证书;需要国密合规的金融内网再上 SM2 双证书。Apache 2.4.8+ 统一用 fullchain 能减少一半链问题;老版本才保留 ChainFile。表格中的“链文件配置”是排查时的第一检查点。
常见错误排查:真实报错与修复命令
按报错定位比盲改配置快。以下为 Apache + CFCA 证书部署中的真实高频错误:
1. curl: (60) SSL certificate problem: unable to get local issuer certificate。说明服务端没下发中间证书。检查 SSLCertificateFile 是否指向 fullchain,执行 openssl s_client -connect example.com:443 -servername example.com -showcerts 看返回证书数量;只有一张就是链缺失。修复:cat 叶子+中间 > fullchain,reload。
2. Java 报 PKIX path building failed。与上一条同源,Java 信任库没有该中间证书。优先修服务端链,而不是往 JDK cacerts 里塞证书;临时可 keytool -importcert 导入中间证书验证。
3. AH02572: Failed to configure at least one certificate and key for example.com:443。路径错、权限不足或文件格式不对。用 ls -l 看私钥是否 600,apachectl configtest 看具体行;SELinux 环境执行 restorecon -Rv /etc/ssl/cfca/。
4. SSL_CTX_use_PrivateKey: key values mismatch。证书与私钥不匹配。用 modulus 比对:openssl x509 -noout -modulus -in cert | openssl md5 与 openssl rsa -noout -modulus -in key | openssl md5,两个 MD5 必须一致。
5. AH02032: Hostname … provided via SNI and hostname … provided via HTTP are different。ServerName 与请求 Host/SNI 不一致。检查 VirtualHost 的 ServerName、ServerAlias,以及 80 跳转是否写错域名。
6. ssl_error_rx_record_too_long。443 端口跑成了 HTTP,常见于只配了 Listen 443 没配 SSLEngine on,或反代把 HTTP 明文回源到 443。检查 Listen 443 与 VirtualHost 是否匹配。
7. certificate has expired。证书过期。用 openssl x509 -enddate -noout -in fullchain 看日期;续期后必须 reload。公有 CA 证书最长 398 天,设置 30 天预警。
8. sslv3 alert handshake failure / no shared cipher。国密场景常见:客户端不支持 SM2,或 Apache 未启用国密套件。用 gmssl s_client 验证,检查是否加载了国密模块与双证书。
效果验证:openssl、curl、浏览器与自动化检查
部署完成后至少做四层验证:证书链、协议套件、HTTP 安全头、客户端兼容性。先用 openssl 看服务端返回的证书链与到期时间:
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates
openssl s_client -connect example.com:443 -servername example.com -verify_return_error </dev/null
第一条应能看到 subject 为 example.com、issuer 为 CFCA 中间 CA,日期未过期;第二条若返回 Verify return code: 0 (ok) 说明链验证通过。再检查协议与套件:
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null | grep -E 'Protocol|Cipher'
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null
第二条应失败,说明 TLS 1.1 已禁用。用 curl 检查 HTTP 状态与 HSTS 头:
curl -vI https://example.com
curl -sI https://example.com | grep -i strict-transport-security
curl -sI https://example.com | grep -i 'HTTP/'
浏览器访问确认小锁,点开证书看“证书路径”是否包含中间 CA;再用 SSL Labs 或 testssl.sh 跑评分:testssl.sh –fast https://example.com。Java 客户端可用 keytool -printcert -sslserver example.com:443 验证链。OCSP stapling 用 openssl s_client -status 查看 OCSP Response Status 是否为 successful。国密站点用国密浏览器或 gmssl s_client -connect example.com:443 验证 SM2 套件。最后写一个到期监控脚本,每天检查 openssl x509 -checkend 2592000,剩余 30 天告警;续期后自动 apachectl configtest && systemctl reload。只有链、协议、头、客户端四项都通过,才算部署完成。
常见问题
多半是证书链不完整:Apache 只下发了叶子证书,没有带 CFCA 中间证书。把站点证书与中间证书按“叶子在前、中间在后”合并成 fullchain,写入 SSLCertificateFile,再 reload。用 openssl s_client -showcerts 应看到至少两张证书。
不需要。2.4.8+ 把中间证书合并进 SSLCertificateFile 的 fullchain 即可,再配 SSLCertificateChainFile 可能重复或冲突。只有 2.4.8 以下版本才用 SSLCertificateChainFile 单独指定链文件,且 SSLCertificateFile 只放叶子证书。
公有 CA 签发的 RSA/ECC 证书最长 398 天,Let’s Encrypt 为 90 天,CFCA 国际算法证书同样受浏览器信任策略约束。到期必须续期并 reload Apache,建议提前 30 天监控,不能再用多年证书一次部署的旧做法。
不能。标准 Apache + 普通 OpenSSL 不支持 SM2 握手,需要 Tongsuo/BabaSSL 等支持国密的 Apache 分支或国密 SSL 模块,并配置签名证书、加密证书及国密套件。验证要用国密浏览器或 gmssl,普通 Chrome 访问失败不一定是配置错误。
先确认配置指向的是新 fullchain 路径,再执行 apachectl configtest 和 systemctl reload。若仍不生效,检查是否有多个 VirtualHost 抢占 443、CDN/反代缓存,以及 Apache 是否以旧进程持有文件。用 openssl x509 -enddate 对比服务端返回的到期时间。
RSA 用 openssl x509 -noout -modulus -in cert | openssl md5 与 openssl rsa -noout -modulus -in key | openssl md5 比对,两个 MD5 必须一致;ECC 用 openssl pkey -pubout -outform der 分别从证书和私钥导出公钥后比对 MD5。不一致就重新签发或找回正确私钥。