CFCA SSL 证书 Apache 部署实战:证书链、国密/国际算法与排错验证
问题背景与根因:CFCA 证书部署到 Apache 为什么容易出问题
CFCA(中国金融认证中心)证书支持国密 SM2 与国际 RSA/ECC 双算法,常用于银行、政务、国企及国密改造项目。把 CFCA SSL 证书部署到 Apache 时,问题通常不在证书本身,而在证书链、Apache 版本差异和算法支持。公开信任的 TLS 证书最长有效期已按 CA/B Forum 规则缩短为 398 天,Let’s Encrypt 仍为 90 天,续期后必须 reload Apache 并确认加载的是新文件。Apache 2.4.8+ 推荐把站点证书与中间证书合并为 fullchain,由 SSLCertificateFile 一次加载;Apache 2.2/2.4.8 以下才需要 SSLCertificateChainFile。只部署叶子证书会出现 curl: (60) unable to get local issuer certificate、Java PKIX path building failed、小程序/Android 校验失败。另一个根因是算法:普通 Apache + OpenSSL 不直接支持 SM2 国密握手,需要国密模块或国密网关;国际 RSA/ECC 证书才能被公共浏览器直接信任。还有私钥权限、SELinux 上下文、SNI 多域名 ServerName 不匹配、HSTS 误加 includeSubDomains 等。先确认 Apache 版本、证书算法和证书链,再改配置,能避免大部分返工。
准备证书文件:PEM、fullchain、私钥与算法确认
把 CFCA 下发的文件整理到 /etc/ssl/example.com/,常见包括站点证书 example.com.crt、中间证书 intermediate.crt、私钥 example.com.key。Apache 使用 PEM 格式,可用 openssl x509 -in example.com.crt -noout -subject -issuer -dates -ext subjectAltName 检查 CN/SAN 和有效期;用 openssl pkey -in example.com.key -check 检查私钥。国际 RSA/ECC 证书用普通 OpenSSL 即可;SM2 证书需国密版 OpenSSL(如 Tongsuo)和国密 Apache 模块,普通 openssl s_client 不能完整验证国密握手。拼接 fullchain 时顺序必须是站点证书在前、中间证书在后,不要放根证书:cat example.com.crt intermediate.crt > example.com_fullchain.crt。检查链:openssl crl2pkcs7 -nocrl -certfile example.com_fullchain.crt | openssl pkcs7 -print_certs -noout。核对证书与私钥:openssl x509 -in example.com.crt -noout -pubkey | openssl md5 与 openssl pkey -in example.com.key -pubout | openssl md5 应一致。权限设为 chmod 600 example.com.key,chown root:root,SELinux 环境执行 restorecon -Rv /etc/ssl/example.com。若用旧版 Apache,再单独保留 chain 文件;2.4.8+ 只需 fullchain。
Apache 完整实操步骤:启用模块、放置文件、configtest、reload
Debian/Ubuntu 先执行 a2enmod ssl headers,再 systemctl restart apache2;RHEL/CentOS 执行 yum install mod_ssl 或 dnf install mod_ssl,服务名是 httpd。确认版本:apache2 -v 或 httpd -v。把 fullchain 和 key 放到 /etc/ssl/example.com/,不要放在 Web 根目录。编辑站点配置:Debian 用 /etc/apache2/sites-available/example-ssl.conf,启用 a2ensite example-ssl;RHEL 用 /etc/httpd/conf.d/ssl.conf。改完先执行 apachectl configtest 或 httpd -t,必须看到 Syntax OK;若报 AH00526 先修配置。然后 systemctl reload apache2 或 systemctl reload httpd,reload 不中断连接;只有模块变化才 restart。检查监听:ss -lntp | grep :443。防火墙放行 443:firewall-cmd –add-service=https –permanent && firewall-cmd –reload,或 ufw allow 443/tcp。若启用了 HSTS,先确认全站 HTTPS 和子域都可用,否则不要加 includeSubDomains。OCSP stapling 需要完整链和可解析 DNS,配置后看 error_log 是否出现 AH02217。最后用 curl 和 openssl 验证,而不是只看浏览器小锁。
VirtualHost 配置示例:2.4.8+ fullchain 与旧版 ChainFile
Apache 2.4.8+ 推荐配置如下,SSLCertificateFile 直接指向 fullchain,SSLCertificateChainFile 不再需要:
<VirtualHost *:443>
ServerName example.com
ServerAlias www.example.com
DocumentRoot /var/www/html
SSLEngine on
SSLCertificateFile /etc/ssl/example.com/example.com_fullchain.crt
SSLCertificateKeyFile /etc/ssl/example.com/example.com.key
SSLProtocol -all +TLSv1.2 +TLSv1.3
SSLCipherSuite HIGH:!aNULL:!MD5:!3DES
SSLHonorCipherOrder on
Header always set Strict-Transport-Security "max-age=31536000; includeSubDomains"
SSLUseStapling on
SSLStaplingCache "shmcb:/var/run/ocsp(128000)"
</VirtualHost>
Apache 2.2/2.4.8 以下改为:SSLCertificateFile 指向站点证书,SSLCertificateKeyFile 指向私钥,SSLCertificateChainFile 指向中间证书。注意 fullchain 顺序不能反,根证书不要放入。HSTS 的 includeSubDomains 只有所有子域都支持 HTTPS 才加;首次上线可先用 max-age=300 测试。SSLStaplingCache 的路径需 Apache 可写,RHEL 可放 /var/run/httpd/ocsp。多域名 SNI 场景每个 VirtualHost 配 ServerName 和对应证书,避免 AH02032。配置后执行 apachectl configtest,再 reload。
CFCA 证书链与算法对比表格:SM2/RSA/ECC、有效期与 Apache 支持
选型时先看客户端。公共浏览器、curl、Java、小程序通常走国际 RSA/ECC 信任链;国密 SM2 需要国密浏览器、国密网关或金融专网环境,普通 Apache 需加国密模块。公开信任 TLS 证书最长有效期 398 天,Let’s Encrypt 90 天,CFCA 具体有效期以签发为准,但续期窗口建议提前 30 天。下表用于快速判断:
| 项目 | Apache 2.4.8+ | Apache 2.2/2.4.8 以下 |
|---|---|---|
| 证书文件 | SSLCertificateFile 指向 fullchain(叶子+中间) | SSLCertificateFile 指向叶子证书 |
| 中间证书 | 合并进 fullchain,不再写 ChainFile | SSLCertificateChainFile 指向 chain |
| 根证书 | 不要放入 fullchain | 不要放入 chain |
| 验证 | openssl s_client -showcerts 至少看到 2 张 | apachectl configtest 后 reload |
| 算法 | 适用场景 | Apache 支持 | 有效期提示 |
|---|---|---|---|
| SM2 国密 | 金融合规、国密改造、国密浏览器/网关 | 需国密模块或国密网关,普通 Apache 不直接支持 | 以 CA 签发为准,不能按公共浏览器直接验证 |
| RSA 2048/3072 | 公共浏览器、Java、curl、小程序 | 原生支持 | 公开信任 TLS 最长 398 天 |
| ECC P-256 | 现代浏览器、移动端,握手更快 | Apache 2.4.8+ 与较新 OpenSSL | 公开信任 TLS 最长 398 天 |
| Let’s Encrypt | 测试、一般站点、自动化续期 | 原生支持 | 90 天,建议自动续期 |
如果项目要求国密合规,不要直接把 SM2 证书配到普通 Apache 上期待 Chrome 信任;应确认客户端和网关能力。国际证书则重点检查 fullchain 和 SAN 是否覆盖域名。
常见错误排查:真实报错与修复命令
1)curl: (60) SSL certificate problem: unable to get local issuer certificate。说明中间证书缺失或 fullchain 顺序错。执行 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 查看返回证书数量,至少应有站点证书和中间证书;重新 cat 叶子+中间,reload。2)Java 报 PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target。同样是链不完整,补 fullchain;Java 客户端还需更新 truststore。3)Apache error_log 出现 [ssl:error] AH02032: Hostname … provided via SNI and hostname … provided via HTTP are different。检查 VirtualHost 的 ServerName/ServerAlias 与请求域名是否一致,多域名要分 VirtualHost。4)[ssl:warn] AH01906: RSA server certificate is a CA certificate (BasicConstraints: CA == TRUE !?)。误把中间证书或根证书当站点证书,SSLCertificateFile 第一张必须是叶子证书。5)AH02217: ssl_stapling_init_cert: can’t retrieve issuer certificate!。OCSP stapling 找不到签发者,确认 fullchain 含中间证书、DNS 可解析,或临时 SSLUseStapling off 排查。6)证书与私钥不匹配:openssl x509 -in cert -noout -pubkey | openssl md5 与 openssl pkey -in key -pubout | openssl md5 不一致,重新配对 CSR 和私钥。7)续期后浏览器仍显示旧证书:systemctl reload apache2,再用 openssl s_client 查看 serial/dates,确认配置路径指向新文件。
效果验证与自动化续期:curl、openssl、HSTS、OCSP
部署后先做本地检查:apachectl configtest 输出 Syntax OK;ss -lntp | grep :443 确认监听;curl -I https://example.com 返回 200/301 且无证书错误;curl -v –cacert /etc/ssl/example.com/example.com_fullchain.crt https://example.com 验证指定链。用 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 检查链;用 openssl s_client -connect example.com:443 -servername example.com -status </dev/null | openssl x509 -noout -serial -dates -subject -issuer 查看当前证书序列号和有效期;OCSP 正常时能看到 OCSP Response Status: successful (0x0)。检查 HSTS:curl -sI https://example.com | grep -i strict-transport-security。续期方面,公开信任证书最长 398 天,Let’s Encrypt 90 天,CFCA 证书按签发周期提前 30 天续期。自动化可用 certbot renew –dry-run 验证 ACME;CFCA 手动证书则把新 fullchain 覆盖旧文件,先备份,再 apachectl configtest,最后 systemctl reload apache2。reload 后用 openssl s_client 再取 serial 和 notAfter,确认不是旧证书。若用负载均衡,所有节点都要同步证书和链,否则部分请求仍报错。
常见问题
公开信任 TLS 证书最长 398 天,Let’s Encrypt 为 90 天,CFCA 具体以签发为准。建议提前 30 天续期,更新 fullchain 后执行 apachectl configtest 并 reload Apache。
不需要。2.4.8 起推荐把叶子证书和中间证书合并到 fullchain,由 SSLCertificateFile 加载;旧版才用 SSLCertificateChainFile,根证书不要放。
优先查证书链,补中间证书并保证叶子在前、中间在后,用 openssl s_client -showcerts 验证至少两张证书;Java 客户端还要更新 truststore。
不能直接。普通 Apache+OpenSSL 不支持 SM2 握手,需要国密模块或国密网关;公共浏览器信任场景应选 RSA/ECC 国际证书。
确认配置指向新文件,执行 apachectl configtest 后 reload,用 openssl s_client 查看 serial 和 notAfter;负载均衡多节点要全部同步证书。
只有所有子域都启用 HTTPS 才加,否则子域会无法访问;首次可先用 max-age=300 测试,再逐步增加。