跳到主要内容
IIS

SSL.com 证书 IIS 部署实战:PFX 导入、443 绑定与证书链排查全流程

问题背景与根因:IIS 部署 SSL 证书为什么会失败

IIS 不直接读取 .pem 文件,而是通过 HTTP.sys 从 Windows 证书存储(Cert:LocalMachineMy)加载证书并完成 TLS 握手。这个架构决定了三类高频故障:容器格式、私钥绑定、证书链完整性。

格式问题:IIS 只接受 PFX(PKCS#12)容器,单独的 .crt、.pem、.cer 无法导入,必须先打包,且 PFX 内要同时包含叶子证书、中间证书和私钥。

私钥问题:打包时漏掉 -inkey,或导入时未写入计算机账户(而非当前用户账户),IIS 的绑定下拉框里该证书会灰显,点选后提示找不到私钥。

证书链问题:PFX 只含叶子证书时,浏览器会自动下载中间证书补齐,但 curl、Java、微信小程序、Android OkHttp 不会补链,于是出现“浏览器锁图标正常、接口调用全挂”的经典现象。

有效期:CA/B 论坛与 Apple 政策要求公开信任的 TLS 证书最长 398 天(2020-09-01 起强制),Let’s Encrypt 为 90 天。续期后证书指纹(Thumbprint)变化,必须重新绑定而不是覆盖文件。

协议与 SNI:Windows Server 2012 R2 及以后默认已启用 TLS 1.2,无需再“手动开启”;真正要做的是禁用 TLS 1.0/1.1。同一 IP 的 443 端口承载多站点时必须勾选 SNI,否则会出现 A 站点拿到 B 站点证书的串证现象。

第一步:准备证书文件并打包成 PFX

SSL.com 签发完成后通常提供三类文件:example.com.crt(叶子证书)、example.com.ca-bundle 或 intermediate.crt(中间证书)、以及你自己在生成 CSR 时保留的 example.com.key(CA 永远不会提供私钥)。如果下单时选择了 PKCS#12 格式,CA 会直接给出 .pfx,可跳过打包步骤。

先校验私钥与证书是否配对。RSA 证书比对模数,ECC 证书没有 modulus 字段,必须比对公钥指纹——不少旧教程在这里写错,导致 ECDSA 证书排查走偏:

# RSA 证书
openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa  -noout -modulus -in example.com.key | openssl md5

# ECC 证书(ECDSA)
openssl x509 -noout -pubkey -in example.com.crt | openssl md5
openssl pkey -in example.com.key -pubout | openssl md5

# 检查有效期与主题,确认 notAfter - notBefore 不超过 398 天
openssl x509 -in example.com.crt -noout -subject -issuer -dates

打包 PFX,关键参数是 -certfile,它负责把中间证书塞进容器:

openssl pkcs12 -export -out example.com.pfx 
  -inkey example.com.key 
  -in example.com.crt 
  -certfile intermediate.crt 
  -name example.com 
  -passout pass:St0ngP@ss

参数含义:-name 是友好名称,IIS 证书列表里显示的就是它;-passout 避免交互输入密码,便于脚本化;OpenSSL 3.x 默认使用 AES-256-CBC + PBKDF2,Windows Server 2012 R2 及以上可正常导入,更老的系统需要追加 -legacy 或 -certpbe PBE-SHA1-3DES。如果私钥带口令,先解密:openssl pkey -in enc.key -out example.com.key。

最后校验 PFX 内容,输出中应出现 2~3 个 subject= 行,只有一个说明中间证书没打进去:

openssl pkcs12 -in example.com.pfx -info -nokeys -passin pass:St0ngP@ss

第二步:导入 PFX 并完成 443 端口绑定

导入方式有三种,效果等价,区别在于是否可脚本化。方式一,IIS 管理器:inetmgr → 左侧选中服务器节点 → 中间面板双击“服务器证书” → 右侧“导入” → 选择 example.com.pfx → 输入密码。若后续需要备份导出,勾选“允许导出证书”;生产环境更安全的做法是不勾选。

方式二,certutil(推荐,权限明确):

certutil -f -p St0ngP@ss -importPFX C:certsexample.com.pfx NoExport

NoExport 表示私钥不可再导出,防止私钥被复制带走;省略该参数则私钥可导出。

方式三,PowerShell(适合批量与 CI):

$pw = ConvertTo-SecureString -String 'St0ngP@ss' -AsPlainText -Force
Import-PfxCertificate -FilePath C:certsexample.com.pfx `
  -CertStoreLocation Cert:LocalMachineMy -Password $pw

# 确认私钥已就位、指纹与到期时间
Get-ChildItem Cert:LocalMachineMy |
  Where-Object { $_.Subject -match 'example.com' } |
  Format-List Subject, Thumbprint, NotAfter, HasPrivateKey

必须导入到 LocalMachineMy,导入到 CurrentUserMy 会导致 IIS 看不到证书。HasPrivateKey 为 True 才能绑定。

然后绑定站点:IIS 中选中站点 → 右侧“绑定” → 添加 → 类型选 https → 端口 443 → 主机名填 example.com → SSL 证书选择刚导入的条目。同一 IP 承载多个 HTTPS 站点时,勾选“需要服务器名称指示(SNI)”。命令行核对与绑定:

netsh http show sslcert ipport=0.0.0.0:443

netsh http add sslcert ipport=0.0.0.0:443 certhash=ABCDEF0123456789ABCDEF0123456789ABCDEF01 appid={4dc3e181-e14b-4a21-b022-59fc669b0914} certstorename=MY

# SNI 场景
netsh http add sslcert hostnameport=example.com:443 certhash=ABCDEF... appid={4dc3e181-e14b-4a21-b022-59fc669b0914}

如果 IIS 管理器里已经建过绑定,再执行 add 会报“Cannot create a file when that file already exists(错误 183)”,此时用 netsh http update sslcert ipport=0.0.0.0:443 certhash=新指纹 appid={4dc3e181-e14b-4a21-b022-59fc669b0914} 覆盖即可,这也是证书续期后的标准动作。

第三步:配置示例——强制 HTTPS、HSTS 与协议加固

站点根目录的 web.config 增加 HTTPS 重定向与 HSTS 头(需先安装“URL 重写”模块,否则 rewrite 节点会触发 500.19 配置错误):

<?xml version='1.0' encoding='UTF-8'?>
<configuration>
  <system.webServer>
    <rewrite>
      <rules>
        <rule name='Force HTTPS' stopProcessing='true'>
          <match url='(.*)' />
          <conditions>
            <add input='{HTTPS}' pattern='^OFF$' />
          </conditions>
          <action type='Redirect' url='https://{HTTP_HOST}/{R:1}' redirectType='Permanent' />
        </rule>
      </rules>
    </rewrite>
    <httpProtocol>
      <customHeaders>
        <add name='Strict-Transport-Security' value='max-age=31536000; includeSubDomains' />
      </customHeaders>
    </httpProtocol>
  </system.webServer>
</configuration>

协议加固用 PowerShell 写 Schannel 注册表。注意:Windows Server 2012 R2 以后 TLS 1.2 已默认启用,本节重点是关闭 TLS 1.0/1.1:

$p = 'HKLM:SYSTEMCurrentControlSetControlSecurityProvidersSCHANNELProtocols'
foreach ($v in 'TLS 1.0','TLS 1.1') {
  New-Item -Path "$p$vServer" -Force | Out-Null
  New-ItemProperty -Path "$p$vServer" -Name 'Enabled' -Value 0 -PropertyType DWord -Force | Out-Null
  New-ItemProperty -Path "$p$vServer" -Name 'DisabledByDefault' -Value 1 -PropertyType DWord -Force | Out-Null
}
New-Item -Path "$pTLS 1.2Server" -Force | Out-Null
New-ItemProperty -Path "$pTLS 1.2Server" -Name 'Enabled' -Value 1 -PropertyType DWord -Force | Out-Null
New-ItemProperty -Path "$pTLS 1.2Server" -Name 'DisabledByDefault' -Value 0 -PropertyType DWord -Force | Out-Null

Schannel 的变更必须重启操作系统才生效,iisreset 不够。Windows Server 2022 可通过注册表 HKLM:SYSTEMCurrentControlSetControlSecurityProvidersSCHANNELProtocolsTLS 1.3Server 启用 TLS 1.3。改完后用 openssl s_client -connect example.com:443 -servername example.com -tls1_1 验证旧协议确实被拒。

第四步:格式、导入方式与验证工具对比

选错文件格式是新手最常见的返工点,下表按“IIS 能否直接使用”排序:

格式 扩展名 内容 IIS 可直接使用 典型用途
PKCS#12 .pfx / .p12 叶子证书 + 中间证书 + 私钥 是 IIS 导入、Windows 证书存储
PEM .pem / .crt Base64 文本,单证书或链 否,需转 PFX Nginx、Apache
PKCS#7 .p7b 证书 + 中间证书,无私钥 否 仅用于补链
DER .cer / .der 二进制单证书 否 导入 Java truststore

导入方式对比:

方式 命令/入口 适用场景 注意事项
IIS 管理器 服务器证书 → 导入 单台服务器、偶发操作 可勾选“允许导出证书”
certutil certutil -f -p 密码 -importPFX 路径 NoExport 批量、脚本化 需管理员权限
PowerShell Import-PfxCertificate 自动化、CI/CD 必须指定 LocalMachineMy
MMC certlm.msc 排查、删除过期证书 手工操作易误删

验证工具的能力边界差异很大,尤其要避免“本机浏览器正常即认为部署成功”:

工具 命令 能验证什么 局限
浏览器 访问 https://example.com 锁图标、有效期、主体名 自动补链,会掩盖链缺失
openssl s_client -connect 域名:443 -servername 域名 -showcerts 链完整性、协议版本、SNI 不加 -servername 会拿到默认站点证书
curl curl -vI https://example.com 端到端握手与系统 CA 校验 依赖本地 CA 包版本
netsh netsh http show sslcert 实际绑定的指纹与端口 不校验证书链
SSL Labs 在线检测 协议、套件、链、评级 需公网可达,测试有缓存

第五步:常见错误排查(真实报错与修复)

1. curl: (60) SSL certificate problem: unable to get local issuer certificate,或 openssl s_client 返回 Verify return code: 20 (unable to get local issuer certificate)。根因是 PFX 内缺中间证书。修复:用 -certfile intermediate.crt 重新打包导入,再执行 netsh http update sslcert 重新绑定。

2. Java 报 javax.net.ssl.SSLHandshakeException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target。同一根因,Java 不做 AIA 补链。先用 openssl s_client -showcerts 确认返回 2~3 张证书,再补链。

3. 微信小程序 request:fail ssl hand shake error。除链不完整外,还要确认证书为受信任 CA 签发、域名与证书主体一致、TLS 版本不低于 1.2,且未使用自签名证书。

4. IIS 导入 PFX 报 A specified logon session does not exist. It may already have been terminated. (0x80070520)。多发生在把 PFX 导入到用户账户,或用带保护的口令串。改用 certutil -f -p 密码 -importPFX 路径 NoExport 导入到计算机账户即可。

5. 绑定证书时报 The certificate is not valid for the requested usage 或 Cannot find the certificate。前者说明证书的增强型密钥用法不含服务器身份验证(1.3.6.1.5.5.7.3.1),或误把中间证书当叶子证书绑定;后者通常是 Thumbprint 写错或证书不在 MY 存储。

6. 站点返回 ERR_SSL_PROTOCOL_ERROR / ERR_CONNECTION_RESET。多见于已禁用 TLS 1.0 而客户端过旧,或密码套件顺序被组策略覆盖。用 openssl s_client -tls1_2 与 -tls1_1 分别测试,定位是协议还是套件问题。

7. 续期后浏览器仍显示旧证书。新证书 Thumbprint 变了,但 IIS 绑定仍指向旧证书。执行 netsh http update sslcert ipport=0.0.0.0:443 certhash=新指纹 appid={4dc3e181-e14b-4a21-b022-59fc669b0914},然后清理 Cert:LocalMachineMy 中的过期证书,避免下次选错。

第六步:效果验证与上线检查清单

本机验证通过不代表外部可用,按下面的顺序做端到端确认。首先验证证书链与协议,注意必须带 -servername,否则在多站点环境下会命中默认站点:

echo | openssl s_client -connect example.com:443 -servername example.com -showcerts 2>/dev/null | grep -c 'BEGIN CERTIFICATE'
# 期望输出 2 或 3

echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | grep 'Verify return code'
# 期望 Verify return code: 0 (ok)

openssl s_client -connect example.com:443 -servername example.com -tls1_1
# 期望握手失败,证明旧协议已禁用

然后用 curl 做端到端校验,输出中出现 SSL certificate verify ok 即通过:

curl -vI https://example.com 2>&1 | grep -E 'SSL certificate verify|expire date|subject:'

Windows 侧核对绑定与实际指纹是否一致,避免“以为绑了新的、其实还是旧的”:

netsh http show sslcert ipport=0.0.0.0:443
(Get-ChildItem Cert:LocalMachineMy).Where({ $_.Thumbprint -eq 'ABCDEF0123...' }) | Select Subject, NotAfter, HasPrivateKey
Test-NetConnection -ComputerName example.com -Port 443

最后用一台不在本域、未安装内部根证书的机器访问站点,或直接跑 SSL Labs 检测。评级达到 A 及以上、证书链显示“Chain issues: None”、有效期剩余天数正常,才算真正完成部署。若内网机器访问正常而公网异常,优先怀疑防火墙未放行 443、或站点绑定的是内部主机名。

常见问题

灰色代表私钥未写入证书存储。用 certutil -f -p 密码 -importPFX 路径 NoExport 重新导入到计算机账户的个人存储,再用 Get-ChildItem Cert:LocalMachineMy 确认 HasPrivateKey 为 True。若仍为 False,多半是打包 PFX 时漏了 -inkey 参数,需要重新导出。

这是证书链不完整的典型表现。浏览器会依据 AIA 扩展自动下载中间证书补齐,curl、Java、微信小程序不会。用 openssl pkcs12 -info -nokeys 检查 PFX 内是否含中间证书,重新用 -certfile intermediate.crt 打包并导入,再用 openssl s_client -showcerts 确认返回 2~3 张证书。

续期后 Thumbprint 会变化,IIS 绑定仍指向旧证书。先导入新 PFX,再在 IIS 绑定中重新选择新证书,或执行 netsh http update sslcert ipport=0.0.0.0:443 certhash=新指纹 appid={4dc3e181-e14b-4a21-b022-59fc669b0914},随后清理 Cert:LocalMachineMy 中的过期证书并重启站点。

可以,IIS 只认 PFX,不关心签发机构。用 win-acme 或 Certify The Web 申请并自动导入到 LocalMachineMy,配置计划任务在到期前 30 天续期,续期后自动执行 netsh http update sslcert 更新绑定。90 天有效期意味着必须自动化,手工续期极易遗漏。

需要启用 SNI。在 IIS 绑定窗口勾选“需要服务器名称指示”,各站点绑定同一 IP:443 但填写不同主机名,HTTP.sys 会按 SNI 分发证书。命令行对应 netsh http add sslcert hostnameport=example.com:443 certhash=… appid={…}。Windows Server 2012 及以上支持,极老客户端不兼容。

已导入的证书可继续使用,但无法再导出备份。若导入时标记为可导出,可从 Cert:LocalMachineMy 用 certutil -exportPFX 配合新密码重新导出;若私钥不可导出且无备份,只能重新生成 CSR 向 CA 重签,通常需要重新完成域名验证。

内容审核

长期从事 SSL/TLS 证书部署与 HTTPS 运维,负责本站证书选型、安装配置与故障排查内容的编写与审核。