IIS SSL 证书配置全流程:PFX 导入、SNI 绑定与 0x80070520 排错
IIS SSL 证书配置的本质是把证书指纹绑定到 HTTP.sys 的 IP:端口 上,所以真正生效的位置是 netsh http show sslcert 的输出,而不是 IIS 管理器里的绑定列表。 Windows Server 2012(IIS 8.0)起才支持 SNI,绑定时需勾选“需要服务器名称指示”,对应 applicationHost.config 中 sslFlags=1;IIS 7.5 同一 IP:443 只能挂一张证书。 报错 0x80070520(A specified logon session does not exist)九成是私钥权限或证书被导入到用户存储,用 certlm.msc 重新导入到“本地计算机个人”并给应用池标识读私钥权限即可。 命令行配置一条等效命令:netsh http add sslcert ipport=0.0.0.0:443 certhash= appid={4dc3e181-e14b-4a21-b022-59fc669b0914} certstorename=MY。 验证只看三件事:openssl s_client 的 Verify return code 为 0、证书链返回 2 至 3 张、SSL Labs 评级达到 A 级。
IIS SSL 证书配置为什么总是失败?三个根本原因拆解
问:为什么我在 IIS 管理器里给站点加了 https 绑定,浏览器还是提示证书不对?
先纠正一个认知偏差:IIS 的 HTTPS 不是”绑在站点上”,而是绑在 HTTP.sys 的 IP:443 上。IIS 管理器里那一步只写入 C:WindowsSystem32inetsrvconfigapplicationHost.config 中 <binding protocol="https" bindingInformation="*:443:www.example.com" sslFlags="1" /> 的 bindingInformation 与 sslFlags,真正在握手时生效的证书哈希由 HTTP.sys 持有。两处不一致,就是绝大多数”配置了但不生效”的来源——比如直接拷贝 applicationHost.config、用 appcmd 批量导入站点,都不会同步 HTTP.sys。核对命令(适用于 IIS 7 及以上全部版本):
:: 查看 HTTP.sys 中 0.0.0.0:443 实际挂载的证书(SHA1 指纹、存储名、AppID)
netsh http show sslcert ipport=0.0.0.0:443
:: 输出关键行示例:
:: Certificate Hash : 8a3f1c...(应与站点证书指纹一致)
:: Application ID : {4dc3e181-e14b-4a21-b022-59fc669b0914} <- IIS 的固定 GUID
:: Certificate Store Name : MY
:: 若输出为空或哈希不符,绑定只写进了 config,未进 HTTP.sys
问:事件日志里 0x80070520 到底是谁的锅?
这个 HRESULT 对应 Win32 错误 1312(”指定的登录会话不存在”),几乎总是私钥 ACL 问题。PFX 导入”本地计算机个人”后,私钥实体文件落在 C:ProgramDataMicrosoftCryptoRSAMachineKeys(无扩展名),默认只授予导入者与 SYSTEM。当应用程序池用 IIS AppPoolMyAppPool(IIS 8.0 起的默认标识)或 NETWORK SERVICE 而缺少读权限时,握手阶段直接失败,IIS 访问日志里看不到任何 4xx/5xx,只有系统日志中 Schannel 事件 36871/36888。修复:
# 以管理员身份运行 PowerShell,定位私钥文件并授权
$cert = Get-ChildItem Cert:LocalMachineMy | Where-Object { $_.Subject -eq 'CN=www.example.com' }
$key = Join-Path $env:ProgramData "MicrosoftCryptoRSAMachineKeys$($cert.PrivateKey.CspKeyContainerInfo.UniqueKeyContainerName)"
icacls $key /grant "IIS AppPoolMyAppPool:(R)"
# NETWORK SERVICE 场景改为: icacls $key /grant "NETWORK SERVICE:(R)"
# 注意:不要对整个 MachineKeys 目录授予 Everyone 读权限
问:Chrome 显示正常,安卓和 Java 客户端却报错,为什么?
据 RFC 8446 §4.4.2 与 RFC 5246 §7.4.2,服务器只发送”站点证书 + 中间 CA”,不发送根证书。而 Import-PfxCertificate 只把叶证书放进 MY 存储,不会像图形界面勾选”自动选择证书存储”那样展开中间证书。缺中间 CA 时,Chrome 靠 AIA 扩展在线抓取仍能成功,curl、Java、Android 则直接失败,形成”我这好好的”的假象。
| 证书类型 | 应放入的存储 | 服务器是否发送 | 缺失时典型报错 |
|---|---|---|---|
| 站点(叶)证书 | 本地计算机个人 (MY) | 是 | 证书名称不匹配 / 不受信任 |
| 中间 CA | 本地计算机中间证书颁发机构 (CA) | 是,随握手下发 | curl: unable to find valid certification path;Java: PKIX path building failed |
| 根 CA | 本地计算机受信任的根证书颁发机构 (Root) | 否 | 一般无影响,客户端内置 |
:: 补齐中间证书与根证书(-f 表示强制覆盖)
certutil -addstore -f CA "C:certsintermediate.crt"
certutil -addstore -f Root "C:certsroot.crt"
:: 验证链是否完整,输出中不应出现 "证书链中的一个证书..." 提示
certutil -verify -urlfetch "C:certswww.cer"
问:同一台服务器要跑多个 HTTPS 站点,第二个绑定总是失败?
先看版本。IIS 7.5(Windows Server 2008 R2)不支持 SNI,同一 IP:443 只能存在一条 SSL 绑定;IIS 8.0(Windows Server 2012)起支持 SNI,但绑定时必须勾选”需要服务器名称指示”,对应 sslFlags=1,否则第二条 https 绑定会被 HTTP.sys 拒绝或覆盖前一条。sslFlags 取值:0=无、1=SNI、2=集中证书存储、3=SNI+集中证书存储。
| IIS 版本 | Windows 版本 | SNI | 同 IP:443 多证书 | 推荐 sslFlags |
|---|---|---|---|---|
| IIS 7.5 | Server 2008 R2 | 不支持 | 否,需独立 IP | 0 |
| IIS 8.0 | Server 2012 | 支持 | 是 | 1 |
| IIS 10 | Server 2016 / 2019 / 2022 | 支持 | 是 | 1(或 3 走集中证书存储) |
问:浏览器直接报 ERR_SSL_VERSION_OR_CIPHER_MISMATCH 是怎么回事?
Windows Server 2008 R2 出厂未默认启用 TLS 1.2,需先安装 KB3140245,再写注册表。据 Mozilla Server Side TLS 指南,2024 年后仅开 TLS 1.0 的站点在主流浏览器中会被直接拒绝。改完务必 iisreset 或重启,因为 SCHANNEL 设置只在服务启动时读取。
:: 启用 TLS 1.2 服务端(REG_DWORD:Enabled=1,DisabledByDefault=0)
reg add "HKLMSYSTEMCurrentControlSetControlSecurityProvidersSCHANNELProtocolsTLS 1.2Server" /v Enabled /t REG_DWORD /d 1 /f
reg add "HKLMSYSTEMCurrentControlSetControlSecurityProvidersSCHANNELProtocolsTLS 1.2Server" /v DisabledByDefault /t REG_DWORD /d 0 /f
:: 关闭 TLS 1.0 / 1.1(客户端侧同样建议一并禁用)
reg add "HKLMSYSTEMCurrentControlSetControlSecurityProvidersSCHANNELProtocolsTLS 1.0Server" /v Enabled /t REG_DWORD /d 0 /f
iisreset
把上面五步按顺序过一遍——先比对 HTTP.sys 与 config、再查私钥 ACL、补中间证书、确认 sslFlags 与 IIS 版本匹配、最后校准协议版本——iis ssl证书配置 的失败案例有九成可以在十分钟内定位。排查顺序之所以重要,是因为这些故障的现象高度重叠(都表现为”证书无效”),但验证命令各不相同,跳过任何一步都可能把时间浪费在错误的方向上。
IIS SSL 证书配置完整实操步骤:从 PFX 导入到 443 绑定(9 步)
很多人把 iis ssl证书配置 理解成”导入证书 + 点一下绑定”,结果在绑定下拉框里选不到证书,或者选完访问报 0x80070520。这 9 步按依赖顺序排列,跳过任何一步都会在后面以错误码的形式还回来。先看版本前提:
| 能力 | 最低 IIS 版本 | 对应系统 | 现场如何确认 |
|---|---|---|---|
| SNI(服务器名称指示) | IIS 8.0 | Windows Server 2012 / Windows 8 | 绑定对话框出现”需要服务器名称指示”复选框 |
| 中央证书存储(CCS) | IIS 8.5 | Windows Server 2012 R2 | 证书下拉框出现”中央证书存储”选项 |
| TLS 1.3 | IIS 10 | Windows Server 2022 | 存在 SCHANNELProtocolsTLS 1.3Server 子键 |
第 1 步 确认环境。先用 PowerShell 确认角色已装,再用 appcmd 看 443 是否已被旧站点占用——主机名冲突是多站点加证书时最常见的返工原因。
# Windows Server:确认 IIS 角色已安装(客户端系统改用 Get-WindowsOptionalFeature -Online -FeatureName IIS-WebServer)
Get-WindowsFeature Web-Server
# 列出全部站点与绑定,重点看 *:443: 后面跟的主机名有没有重复
& $env:windirsystem32inetsrvappcmd.exe list config -section:system.applicationHost/sites
第 2 步 生成 CSR。IIS 管理器 → 服务器节点 → 服务器证书 → 创建证书申请,密钥长度 2048(RSA)或 ECC P-256,通用名称填 www.example.com,并在”属性 → 使用者”里把 example.com 加进 SAN。等价的命令行写法(适合批量或脚本化):
; request.inf —— certreq 用 ECC P-256 + 双域名 SAN,注意 SAN 是必填项
[NewRequest]
Subject = "CN=www.example.com"
KeyAlgorithm = ECDSA_P256
KeyLength = 256
Exportable = TRUE
ProviderName = "Microsoft Software Key Storage Provider"
[Extensions]
2.5.29.17 = "{text}dns=www.example.com&dns=example.com"
certreq -new request.inf request.req # 生成的 request.req 即为 CSR,提交给 CA
第 3 步 完成签发与验证。DV 证书通常 10 分钟至 2 小时签发,OV 需 1 至 5 个工作日人工核验。据 Let’s Encrypt 文档,http-01 验证走 /.well-known/acme-challenge/,商业 CA 多用 /.well-known/pki-validation/。IIS 默认会拦截无扩展名文件,返回 404.3,需放行:
<!-- 站点根目录 web.config:让无扩展名的验证文件被静态返回 -->
<configuration>
<system.webServer>
<staticContent>
<mimeMap fileExtension="." mimeType="text/plain" />
</staticContent>
</system.webServer>
</configuration>
第 4 步 导入证书。收到 .pfx 时用 certlm.msc → 个人 → 所有任务 → 导入,务必选”本地计算机”而非”当前用户”,勾选”包括所有扩展属性”和”标记此密钥为可导出”。若 CA 给的是 .cer/.p7b,先把中间 CA 导入”中间证书颁发机构”存储。脚本等价写法:
# -ExportPolicy Exportable 对应"标记此密钥为可导出";不勾选会导致后续无法备份迁移
Import-PfxCertificate -FilePath C:certsexample.pfx `
-CertStoreLocation Cert:LocalMachineMy `
-Password (Read-Host -AsSecureString) `
-ExportPolicy Exportable
第 5 步 核对指纹。下面这条命令的输出是第 6 步的唯一输入,也是判断”是不是绑了旧证书”的依据:
Get-ChildItem Cert:LocalMachineMy | Select-Object Subject, Thumbprint, NotAfter
# Thumbprint 为 40 位十六进制,复制时去掉所有空格
第 6 步 建立 HTTPS 绑定。IIS 管理器 → 站点 → 绑定 → 添加:类型 https、端口 443、主机名 www.example.com、勾选”需要服务器名称指示”、SSL 证书选刚导入的那张。多站点时每个主机名单独一条绑定,不要复用。命令行方式:
# 先加站点绑定(SNI 由主机名体现),再把证书挂到 hostnameport 上
& $env:windirsystem32inetsrvappcmd.exe set site "MySite" /+bindings.[protocol='https',bindingInformation='*:443:www.example.com']
# appid 是 IIS 固定值;certhash 填第 5 步的指纹;certstorename=MY 即"个人"存储
netsh http add sslcert hostnameport=www.example.com:443 certhash=<40位指纹> appid="{4dc3e181-e14b-4a21-b022-59fc669b0914}" certstorename=MY
第 7 步 授权私钥。certlm.msc 中右键证书 → 所有任务 → 管理私钥,添加 IIS_IUSRS 或具体应用池标识 IIS AppPoolMyAppPool,权限只给”读取”。这一步漏掉,访问即报 0x80070520。下面的命令仅用于核对私钥容器位置,不要拿它去批量改 MachineKeys 目录 ACL:
$c = Get-Item Cert:LocalMachineMy<40位指纹>
$c.PrivateKey.CspKeyContainerInfo.UniqueKeyContainerName # 私钥容器文件名
第 8 步 协议加固(可选)。据 Mozilla SSL Configuration Generator 的建议,2024 年后新建站点不应再启用 TLS 1.0/1.1。修改后必须重启操作系统,只重启 IIS 不生效:
# 禁用 TLS 1.0 / 1.1 服务端;Server 子键缺失时需先创建
$base = 'HKLM:SYSTEMCurrentControlSetControlSecurityProvidersSCHANNELProtocols'
foreach ($p in 'TLS 1.0','TLS 1.1') {
New-Item -Path "$base$pServer" -Force | Out-Null
Set-ItemProperty -Path "$base$pServer" -Name Enabled -Value 0 -Type DWord
Set-ItemProperty -Path "$base$pServer" -Name DisabledByDefault -Value 1 -Type DWord
}
第 9 步 备份与留档。把配置、绑定关系、到期日一起存档,出故障时能直接对比:
Copy-Item $env:windirSystem32inetsrvconfigapplicationHost.config "D:backupapplicationHost-$(Get-Date -f yyyyMMdd).config"
netsh http show sslcert > D:backupsslcert-$(Get-Date -f yyyyMMdd).txt
有效期务必按 CA/Browser Forum Baseline Requirements 规划:2020 年 9 月 1 日起单张证书上限 398 天,2026 年 3 月 15 日起缩短到 200 天。也就是说,一次完整的 iis ssl证书配置 做完,30 天后就该把续期提醒设进日历;续期时优先复用同一私钥重新签发,指纹会变,第 6 步的 certhash 必须同步更新,否则 netsh 里留的还是旧指纹。
IIS SSL 证书配置的命令行写法:appcmd、netsh 与 PowerShell 参数示例
命令行比 IIS 管理器更可靠吗?在批量迁移、CI 流水线或远程 WinRM 会话里,图形界面根本点不到,而且管理器偶尔会把 SNI 复选框“吃掉”。据 Microsoft IIS 官方文档(IIS 8.0 Server Name Indication),SNI 绑定信息最终落在 applicationHost.config 的 sslFlags 属性上,命令行直接改这个属性反而最不容易出错。下面按“查看—新增—删除—批量”的顺序给出可直接复制的命令。
第一步永远是查看现有绑定,而不是急着 add。据 HTTP Server API 文档(netsh http 上下文),show sslcert 会输出 Certificate Hash、Application ID、Certificate Store Name、Verify Client Certificate Revocation 四行关键信息,前两项是回滚时的唯一凭据:
# 查看 0.0.0.0:443 上已注册的证书绑定,先留存 Certificate Hash
netsh http show sslcert ipport=0.0.0.0:443
# 新增绑定:certhash 为 40 位十六进制指纹(不含空格),appid 必须是 IIS 固定 GUID
# certstorename=MY 表示本地计算机个人 存储;改成 WebHosting 需配合 CCS
netsh http add sslcert ipport=0.0.0.0:443 ^
certhash=9f8e7d6c5b4a39281706f5e4d3c2b1a09f8e7d6c ^
appid={4dc3e181-e14b-4a21-b022-59fc669b0914} ^
certstorename=MY
appid 为什么不能随便填?IIS 管理器在枚举绑定时只认 {4dc3e181-e14b-4a21-b022-59fc669b0914} 这一个 GUID。你换成自定义 GUID,netsh 不报错、浏览器也能握手,但 IIS 管理器里该站点的“编辑绑定”会显示证书为空,后续想改回图形界面就卡死了。这是 iis ssl证书配置 中最常见的“隐性故障”。
删除时的“找不到元素”怎么办?若站点已启用 SNI,HTTP.sys 中的记录键是 hostnameport 而非 ipport,直接删 ipport=0.0.0.0:443 会返回 找不到元素(Element not found,错误 1168)。正确顺序是先在 IIS 侧移除绑定,或改用主机名键:
# 有 SNI 绑定时必须用 hostnameport 形式
netsh http delete sslcert hostnameport=www.example.com:443
# 无 SNI 的通配绑定时才用 ipport
netsh http delete sslcert ipport=0.0.0.0:443
appcmd 怎么一次建成带 SNI 的绑定?分两条命令:先加绑定,再改 sslFlags,最后 /commit:apphost 写入 applicationHost.config,否则只在内存生效、重启即丢。
# 1) 添加 HTTPS 绑定
appcmd.exe set site /site.name:"Default Web Site" ^
/+bindings.[protocol='https',bindingInformation='*:443:www.example.com']
# 2) 为该绑定开启 SNI(sslFlags:0=关闭 1=SNI 2=中央证书存储 3=SNI+CCS)
appcmd.exe set config -section:system.applicationHost/sites ^
"/[name='Default Web Site'].bindings.[protocol='https',bindingInformation='*:443:www.example.com'].sslFlags:1" ^
/commit:apphost
上百个站点怎么批量做?PowerShell 的 WebAdministration 模块(IIS 7 起内置)可循环执行,实测 100 个站点约 1–2 分钟,适合服务器迁移:
Import-Module WebAdministration
$sites = Import-Csv C:sites.csv # 列:SiteName,HostHeader,Thumbprint
foreach ($s in $sites) {
New-WebBinding -Name $s.SiteName -Protocol https -Port 443 `
-HostHeader $s.HostHeader -SslFlags 1
$b = Get-WebBinding -Name $s.SiteName -Protocol https -HostHeader $s.HostHeader
$b.AddSslCertificate($s.Thumbprint, "my") # 第二参数为存储名
}
中央证书存储(CCS)值得上吗?据 Microsoft 文档,CCS 要求 IIS 8.5 / Windows Server 2012 R2 以上,所有 PFX 以主机名命名(如 www.example.com.pfx)放入共享目录,绑定 sslFlags 必须含 2。续订时只需覆盖同名文件,绑定零改动:
# 启用中央证书存储,密码为 PFX 统一口令
appcmd.exe set config -section:system.applicationHost/centralCertProvider ^
/enabled:"True" /physicalPath:"C:CentralCertStore" ^
/password:"YourPfxPassword" /commit:apphost
| 方式 | 适用场景 | 关键参数/默认值 | 主要坑点 |
|---|---|---|---|
| netsh http | 底层绑定修复、HTTP.sys 级排错 | appid 固定 GUID;certstorename 默认 MY | SNI 下须用 hostnameport 删除 |
| appcmd | 单站点精细控制、脚本化配置 | sslFlags 0/1/2/3,默认 0 | 漏 /commit:apphost 不落盘 |
| PowerShell | 批量迁移、百站点以上 | -SslFlags 默认 0 | AddSslCertificate 需先取到绑定对象 |
| CCS | 多站点统一续订 | 需 IIS 8.5+,sslFlags 含 2 | PFX 口令变更需同步改配置 |
顺带一提:这些命令只解决“绑定层”,若证书链缺中间 CA,仍会在浏览器报 NET::ERR_CERT_AUTHORITY_INVALID——那是 PFX 导入环节的问题,与 sslFlags 无关。掌握上述命令行写法后,iis ssl证书配置 就能从“点鼠标”变成可版本化、可审计的脚本,也为后续排查 0x80070520(证书私钥权限不足)打下基础。
IIS SSL 证书配置方式怎么选?GUI、命令行、中央证书存储、win-acme 对比表
选哪种方式,取决于三个变量:站点数量、是否需要自动化、证书从哪来。把五种方式放进同一张表对比,边界会立刻清晰。默认前提:Windows Server 2012 / IIS 8.0 起才支持 SNI 绑定(sslFlags=1),在此之前 443 端口只能靠独立 IP 区分站点。
| 方式 | 操作复杂度与耗时 | 适用规模 | 可审计 / 可回滚 | 证书来源与成本 |
|---|---|---|---|---|
| IIS 管理器 GUI | 单站点 1–3 分钟,零学习成本 | ≤5 个站点的单机 | 无操作日志,故障只能靠 applicationHost.config 修改时间倒推;回滚需人工核对证书指纹 |
手工导入 PFX,商业证书为主 |
| appcmd | 单条命令 1 秒内,但需先取到指纹 | 10–100 站点批量脚本 | 命令可入 Git,删一条绑定约 5 秒 | 不涉及签发,仅做绑定 |
| PowerShell + WebAdministration | 首次写循环约 30 分钟调试 | 10–100 站点,可接 CI/CD | 脚本即文档,-WhatIf 可预演 |
可与 ACME 客户端组合 |
| 中央证书存储(CCS) | 首次约 20 分钟;之后新增站点只需放 PFX + 一条绑定 | ≥50 站点或 NLB 集群,IIS 8+,Server 2012 R2 起完整可用 | 证书集中在一个 UNC 目录,版本可追溯 | 多机共用同一份 PFX |
| win-acme 2.2.x | 向导 5 分钟,续订全自动 | 公网单域名与通配符 | 计划任务 + 日志目录可查每次续订 | Let’s Encrypt 0 元,90 天有效期 |
命令行方式的核心是 appcmd,注意 sni:1 与 sslFlags:1 必须成对出现,否则 IIS 会退化为 IP 独占模式:
rem 管理员权限运行;IIS 8.0+ 才支持 sni,sslFlags 默认值 0(无 SNI)
rem 先取指纹(SHA1,40 位十六进制)
certutil -store My | findstr /i "证书 哈希 Cert Hash"
rem 新增 HTTPS 绑定并启用 SNI,同时用哈希指定证书
%windir%system32inetsrvappcmd.exe set site "Default Web Site" ^
/+bindings.[protocol='https',bindingInformation='*:443:www.example.com',sni:1,sslFlags:1]
rem 绑定后把证书挂到该绑定上(哈希替换为实际值)
%windir%system32inetsrvappcmd.exe set config "Default Web Site" ^
-section:system.webServer/security/access ^
/commit:apphost
批量场景改用 PowerShell,New-WebBinding 的 -SslFlags 参数自 IIS 8.0 起可用,取值为 0(None)、1(SNI)、2(CentralCertStore)、3(SNI+CCS):
Import-Module WebAdministration
$thumb = (Get-ChildItem Cert:LocalMachineMy |
Where-Object { $_.Subject -like "*www.example.com*" }).Thumbprint
foreach ($h in @("www.example.com","api.example.com")) {
# -SslFlags 1 = 启用 SNI,避免每个站点占用独立 IP
New-WebBinding -Name $h -Protocol https -Port 443 -HostHeader $h -SslFlags 1
(Get-WebBinding -Name $h -Protocol https).AddSslCertificate($thumb, "My")
}
站点数超过 50 或部署在 NLB 后面时,用中央证书存储,证书只需放在一个 UNC 共享里,各节点通过私钥密码读取:
# Windows Server 2012 R2+ / IIS 8.5+,需先启用共享配置
Enable-WebCentralCertProvider -CertStoreLocation "\fileserverCerts" `
-PrivateKeyPassword "P@ssw0rd"
# 之后新增站点:把 www.example.com.pfx 丢进共享目录,再建一条 SNI 绑定即可
# 常见报错 0x80070520(ERROR_NO_SUCH_LOGON_SESSION)多为私钥密码不匹配
# 或应用池标识对 UNC 目录无读权限
公网免费证书用 win-acme 2.2.x,通配符必须走 DNS-01,--store centralssl 可直接写进 CCS,--installation iis 自动建绑定:
rem 64 位系统务必用 x64 版 wacs.exe,x86 版加载 IIS 模块会失败
wacs.exe --target manual --host *.example.com ^
--validation dnsscript --dnsscript "C:scriptsdns.ps1" ^
--store centralssl --centralsslstore "\fileserverCerts" ^
--installation iis
据 Let’s Encrypt 官方文档,证书固定 90 天有效期,win-acme 默认在到期前 30 天触发续订任务,务必单独建一个应用池运行该任务,避免 32/64 位加载冲突。据微软 Learn 关于 Enable-WebCentralCertProvider 的说明,私钥密码以可逆方式存于 applicationHost.config,因此该文件本身的 ACL 就是安全边界。价格参考:商业 DV 单域名约 0–200 元/年,OV 约 800–2000 元/年,DV 通配符约 500–1500 元/年;EV 证书自 Chrome 77 起不再显示绿色地址栏,多站点场景优先用 SNI 绑定而非通配符,可以少一份私钥分发面。
多站点场景下的 IIS SSL 证书配置:SNI、通配符与多域名证书怎么选
IIS 7.5 能不能在同一个 IP:443 上挂多张证书?为什么绑第二个站点时证书总被“抢”?
不能。SNI(Server Name Indication,RFC 6066)在 IIS 中从 IIS 8.0(Windows Server 2012 / Windows 8)才开始支持;IIS 7.5 的绑定属性里根本没有 sslFlags 字段,IIS 管理器也没有“需要服务器名称指示”复选框。在 IIS 7.5 上,HTTP.sys 只按 IP:端口 建立 SSL 端点映射,因此一个 0.0.0.0:443 只能绑定一张证书;即使你能创建多条 https 绑定,所有站点握手时拿到的仍是第一条绑定的证书,于是出现 NET::ERR_CERT_COMMON_NAME_INVALID。所以多站点场景只有两条路:升级到 IIS 8.0+ 使用 SNI,或者在 IIS 7.5 上让所有站点共用一张通配符/多域名证书。
IIS 8.0+ 开启 SNI 的本质就是把 sslFlags 置为 1(0 = 无,1 = SNI,2 = 集中证书存储,3 = SNI + 集中证书存储)。据 Microsoft IIS 官方文档,SNI 绑定使证书按主机名而非 IP 选择:
# 管理员权限运行;-SslFlags 参数仅在 IIS 8.0+ 的 WebAdministration 模块中存在
Import-Module WebAdministration
# 1) 创建带 SNI 的 https 绑定(SslFlags 1 = SNI)
New-WebBinding -Name "shop" -Protocol https -Port 443 `
-HostHeader "shop.example.com" -SslFlags 1
# 2) 把证书挂到该 SNI 端点(IIS:SslBindingsIP!端口!主机名)
$cert = Get-Item Cert:LocalMachineMy3A7F9C2E1B4D8A60F5C1E9D2B7A4C6E8F0D1A2B3
New-Item -Path "IIS:SslBindings.0.0.0!443!shop.example.com" -Value $cert -SSLFlags 1
# 3) 核对结果:sslFlags 应为 1,bindingInformation 含主机名
Get-WebBinding -Name "shop" | Select-Object protocol, bindingInformation, sslFlags
对应的 %windir%System32inetsrvconfigapplicationHost.config 片段如下,手工编辑后需执行 iisreset /noforce 或重启 W3SVC 生效:
<site name="shop" id="2">
<bindings>
<!-- sslFlags="1" 即 SNI;去掉该属性等同于 0(非 SNI) -->
<binding protocol="https" bindingInformation="*:443:shop.example.com" sslFlags="1" />
</bindings>
</site>
通配符、多域名 SAN、单域名证书怎么选?
| 方案 | 覆盖范围 | IIS 版本要求 | 续订与运维 | 典型坑 |
|---|---|---|---|---|
| 单域名证书 | 仅一个 FQDN | IIS 7.5 可用,但同 IP:443 只能生效一张 | 每个站点各自续订,证书数量 = 站点数量 | IIS 7.5 上多站点互相覆盖证书 |
通配符 *.example.com |
仅一级子域,且不含 example.com 本身 |
任意版本;IIS 7.5 需手动为每个站点建绑定并挂同一张证书 | 一次续订覆盖所有子域 | 新增 a.b.example.com 需另购证书;裸域须加进 SAN |
| 多域名 SAN | 多个不同域名/裸域,主流 CA 单证书上限约 100 个名称 | IIS 8.0+ 配 SNI 最省心 | 一次更新全部生效,运维成本最低 | 每个主机名仍需一条独立 https 绑定,漏建即回落默认站点 |
注意 *.example.com 的边界:a.example.com 匹配,a.b.example.com 不匹配,example.com 也不在覆盖范围内,必须额外写入 SAN。据 Let’s Encrypt 文档,通配符证书只能通过 DNS-01 挑战签发,无法用 HTTP-01 的 /.well-known/acme-challenge/ 文件验证——这也意味着签发流程必须能操作 DNS TXT 记录。使用 SAN 证书时,IIS 侧要为每个主机名建一条 sslFlags=1 的绑定,但都指向同一张证书,续订后无需逐站替换。
老客户端不支持 SNI 会怎样?需要兼容怎么办?
Windows XP 的 SChannel、Android 2.x 等客户端不发送 SNI 扩展。据 TLS 1.3(RFC 8446)与 SNI(RFC 6066)规范,服务端在收不到 SNI 时必须回落到该 IP:443 上的非 SNI 绑定;若不存在非 SNI 绑定,HTTP.sys 会用默认证书应答,客户端随即报名称不匹配。折中做法是:把主域名站点保留为非 SNI 绑定(sslFlags=0,即不勾选 SNI)作为兜底,其余站点全部启用 SNI。约束是同一 IP:443 只允许存在一条非 SNI 绑定,第二条会被拒绝或覆盖前者。
因此不要把默认站点绑到无关域名——它会在所有无 SNI 的握手中泄露该域名证书并触发告警。上线前用 OpenSSL 验证每个主机名实际返回的证书:
# 模拟发送 SNI,查看真实下发的证书主题与 SAN
openssl s_client -connect 203.0.113.10:443 -servername shop.example.com -showcerts /dev/null
| openssl x509 -noout -subject -ext subjectAltName
# 对照:不发送 SNI(-noservername 需 OpenSSL 1.1.1+),应拿到兜底站点证书
openssl s_client -connect 203.0.113.10:443 -noservername /dev/null | openssl x509 -noout -subject
IIS SSL 证书配置常见报错与排查:0x80070520、ERR_SSL_VERSION_OR_CIPHER_MISMATCH 等
0x80070520 报错是不是证书坏了?不是。这条错误全称是 “A specified logon session does not exist. It may already have been terminated.”,本质是 w3wp.exe 进程读不到证书对应的私钥容器。据 Microsoft Learn 的 Schannel 文档,私钥访问由密钥容器 ACL 控制,进程身份不在 ACL 里就会返回该 HRESULT。排查按三步走:先在 certlm.msc(本地计算机,不是 certmgr.msc 的当前用户)确认证书位于「个人」存储;再右键证书 →「所有任务」→「管理私钥」,把 IIS_IUSRS 或具体应用池标识(如 IIS AppPoolMySite)加为读取;最后确认导入 PFX 时未勾选「强私钥保护」——勾选后每次访问都弹密码框,服务账户必然读不到。
若三步都做过仍失败,多半是 PFX 被导入到了用户存储。用 certutil 强制重导到计算机密钥集(适用于 Windows Server 2012 R2 及以上,certutil 随系统自带):
# -importPFX 默认写入「本地计算机个人」,私钥落在 MachineKeyset
# 切勿加 -user,否则写入用户配置文件密钥容器,IIS 应用池读不到 → 0x80070520
certutil -importPFX -p "YourPfxPassword" -f "C:certswww.example.com.pfx"
# 验证私钥是否可被服务账户读取(输出中需含 IIS_IUSRS 或应用池标识)
certutil -store My www.example.com
绑定后站点起不来、报 0x80070020 怎么办?“该进程无法访问文件,因为另一个程序正在使用此文件”几乎都是 443 被抢占。Skype(默认监听 443)、VMware Workstation 共享虚拟机、另一个绑定同 IP 的 IIS 站点是三大常见元凶。IIS 8 及以上默认启用 SNI,同一 IP:443 可承载多站点,但若某个站点绑定勾选了「需要服务器名称指示」之外的“所有未分配 IP”,就会独占端口。
netstat -ano | findstr :443
# 拿到最后一列 PID,再定位进程名
tasklist /FI "PID eq 4712"
浏览器报 ERR_SSL_VERSION_OR_CIPHER_MISMATCH 说明什么?说明客户端与服务端没有交集协议或密码套件。用 OpenSSL 3.x 直连测试(-servername 用于 SNI 场景):
openssl s_client -connect www.example.com:443 -servername www.example.com -tls1_2
# 握手失败会输出 "no protocols available" 或 "sslv3 alert handshake failure"
# Windows Server 2016+ 可用 PowerShell 查看启用的套件
Get-TlsCipherSuite | Where-Object Protocols -like "*TLS12*" | Select-Object -First 10
同时检查 HKLMSYSTEMCurrentControlSetControlSecurityProvidersSCHANNELProtocolsTLS 1.2Server 下 Enabled 是否为 1、DisabledByDefault 是否为 0。注意:TLS 1.0/1.1 在 Windows Server 2022 上默认已禁用,IIS 不会主动降级兼容旧客户端。
| 浏览器/客户端报错 | 真实根因 | 一条定位命令 |
|---|---|---|
| ERR_CERT_COMMON_NAME_INVALID | 绑定主机名与证书 CN/SAN 不符,或未勾选 SNI 导致返回默认站点证书 | openssl s_client -connect 10.0.0.5:443 -servername www.example.com,比对返回的 subject 与 X509v3 Subject Alternative Name |
| unable to find valid certification path to requested target(Android/Java) | 服务器未下发中间证书,链只有 1 张 | openssl s_client -connect www.example.com:443 -showcerts,正常返回 2–3 张;仅 1 张则需把中间 CA 导入「中间证书颁发机构」存储后重新绑定 |
| IIS 无任何日志但握手失败 | 失败发生在 HTTP 之前,W3C 日志不记录 | 查 %SystemRoot%System32LogFilesHTTPERRhttperr*.log,常见状态为 Timer_ConnectionIdle、Client_Reset;再在 IIS 管理器启用「失败请求跟踪」,日志落在 %SystemDrive%inetpublogsFailedReqLogFiles |
证书链问题在移动端最容易被放大:据 Let’s Encrypt 文档,其签发的叶子证书需配套 ISRG Root X1 中间证书下发,Windows 桌面端会自动补链,Android 7 以下与部分 Java 客户端不会,于是直接抛 PKIX 异常。完成上述 iis ssl证书配置 排查后,建议用 SSL Labs 或 openssl s_client -verify_return_error 做一次链完整性回归,避免换证书后问题复现。
如何验证 IIS SSL 证书配置已生效?6 种可复核的方法
配置改完不等于生效。IIS 的 iis ssl证书配置 涉及三处独立状态:HTTP.sys 的端口绑定(netsh 层)、证书存储中的私钥可用性、以及证书链完整性。任何一处错位,IIS 管理器都不会报错,只会在握手阶段失败。下面 6 种方法从绑定、握手、协议、套件、浏览器、日志六个层面交叉复核,全部通过才算配置到位。
方法一:证书绑定到底指向哪张证书?用 netsh 比对指纹最直接。
# 查看 443 端口当前的 SSL 绑定;启用 SNI 后会按 hostnameport 分条列出
netsh http show sslcert ipport=0.0.0.0:443
# 关键字段示例:
# IP:port : 0.0.0.0:443
# Certificate Hash : 8f3a1c...c1d2 ← 不带空格
# Application ID : {4dc3e181-e14b-4a21-b022-59fc669b0914}
# Certificate Store Name : MY
# 从本机 MY 存储取证书指纹(带空格),去掉空格后与上面的 Hash 逐字符比对
Get-ChildItem Cert:LocalMachineMy |
Select-Object Subject, NotAfter, Thumbprint | Format-Table -AutoSize
判读标准:Hash 与 Thumbprint 完全一致;Application ID 为 {4dc3e181-e14b-4a21-b022-59fc669b0914}(IIS 在 HTTP.sys 中的固定应用标识,非此值说明绑定被其他进程改写);Store Name 为 MY。若绑定失败并报 SSL Certificate add failed, Error: 1312 / 0x80070520,通常是证书已从 MY 删除,或 IIS 服务账户缺少私钥读取权限(在 certlm.msc 中检查证书的”管理私钥”)。
方法二:服务端返回的链是否完整?用 openssl 握手一次看返回值。
openssl s_client -connect www.example.com:443 -servername www.example.com -showcerts </dev/null
# 关注三行输出:
# Verify return code: 0 (ok)
# Protocol : TLSv1.3
# Cipher : TLS_AES_256_GCM_SHA384
返回 21 (unable to verify the first certificate) 表示服务器未下发中间证书——IIS 只发站点证书,必须把中间 CA 手工导入”中间证书颁发机构”存储(certutil -addstore CA intermediate.crt),再刷新绑定。返回 20 (unable to get local issuer certificate) 多为自签或根不受信。据 Let’s Encrypt 文档,链不完整是移动端与老版本 Java 客户端握手失败的首要原因;返回证书链应为 2 至 3 张(叶证书 + 中间证书,可选交叉签名根)。
方法三:协议版本是否按预期收敛?用 curl 做正反双向探测。
# 正向:强制 TLS 1.2,应返回 HTTP/2 200 或 HTTP/1.1 200
curl -sI --tlsv1.2 --tls-max 1.2 https://www.example.com
# 反向:强制 TLS 1.0,在已禁用 TLS 1.0 的环境中应失败
curl -sI --tlsv1.0 https://www.example.com
# 期望报错:curl: (35) error:0A000410:SSL routines::sslcert/ssl3 alert handshake failure
两个结果同时符合预期,才说明 TLS 1.0/1.1 确实在 HKLMSYSTEMCurrentControlSetControlSecurityProvidersSCHANNELProtocols 下被禁用,而不是仅靠 IIS 站点级设置。
方法四:还在用弱套件吗?nmap 枚举 + SSL Labs 评级。
nmap --script ssl-enum-ciphers -p 443 www.example.com
# 检查输出中不出现 TLS_RSA_WITH_3DES_EDE_CBC_SHA、RC4、以及 *CBC* 系列(TLS 1.3 除外)
据 Mozilla Server Side TLS 指南,中间兼容配置已不再推荐任何 CBC 套件;TLS 1.3(RFC 8446)仅保留 AEAD 套件。再用 Qualys SSL Labs 复测,目标 A 或 A+,并确认 Certificate 项显示 Chain issues: None。
方法五:浏览器实测,多站点场景逐个域名访问。Chrome 开发者工具 → Security 面板:Connection 应为 TLS 1.2/1.3,Key exchange 为 X25519 或 ECDHE-RSA,Certificate 有效且 SAN 覆盖当前域名。绑定了 SNI 的多站点必须逐域名验证,否则会把”访问到默认站点证书”误判为配置成功。
方法六:日志与可用性,看真实请求的落点。打开 %SystemDrive%inetpublogsLogFilesW3SVC1 下当日日志,HTTPS 请求应记录 sc-status 200、sc-substatus 0;出现 403.7 或 404.7 指向证书权限问题。再用 curl 每 5 分钟探测一次,连续 24 小时无握手失败即可判定稳定。
| 方法 | 核心命令/入口 | 通过判据 | 主要能发现的问题 |
|---|---|---|---|
| 一 指纹比对 | netsh http show sslcert | Hash=Thumbprint,Store=MY | 绑定错证书、0x80070520 |
| 二 openssl | s_client -servername | verify code 0,链 2–3 张 | 中间证书缺失 |
| 三 curl | –tlsv1.2 / –tlsv1.0 | 前者 200,后者失败 | 旧协议未禁用 |
| 四 套件枚举 | nmap ssl-enum-ciphers | 无 RC4/3DES/CBC,评级 A+ | 弱套件、SCHANNEL 配置 |
| 五 浏览器 | DevTools → Security | TLS 1.2/1.3 + SAN 匹配 | SNI 分发错位 |
| 六 日志 | W3SVC1 日志 + 定时探测 | sc-status 200 / 24h 无失败 | 间歇性握手失败 |
不需要。新增或修改 https 绑定后 IIS 会自动检测 applicationHost.config 变更,必要时回收应用池即可生效。只有修改 SCHANNEL 下的 TLS 协议注册表项才需要重启操作系统,执行 iisreset 对协议开关无效。
IIS 的证书绑定落在 HTTP.sys 的 IP:端口 层,站点只是引用方,所以要用 netsh http show sslcert 验证;Nginx 用 server 块里的 ssl_certificate 指令直接声明,reload 即生效。IIS 的 SNI 需要 IIS 8.0 以上并显式勾选,Nginx 默认就按 server_name 分发。
先用 certlm.msc 确认证书在“本地计算机个人”而不是“当前用户个人”;再右键证书 → 所有任务 → 管理私钥,添加 IIS_IUSRS 或具体应用池标识的读取权限;最后确认 PFX 导入时没有启用强私钥保护。三步做完重新绑定,多数情况下握手即可恢复。
优先用 .pfx,它包含站点证书、中间证书和私钥,导入后可直接绑定。若 CA 只给 .cer 或 .p7b,需要先把中间 CA 导入“中间证书颁发机构”存储,再导入站点证书,否则客户端会因证书链不完整报 unable to find valid certification path。
IIS 8.0 及以上启用 SNI 后,同一 IP:443 可以绑定任意多个站点,实际数量受服务器内存与握手并发限制,生产环境建议单机控制在 100 个以内。IIS 7.5 不支持 SNI,同一 IP:443 只能有一个证书,多站点只能共用通配符或多域名 SAN 证书。
要更新绑定。新证书的指纹与旧证书不同,而 HTTP.sys 是按 certhash 绑定的,必须重新执行 netsh http add sslcert 或在 IIS 管理器中改选新证书。使用中央证书存储或 win-acme 2.2.x 时,替换同名 PFX 或由工具自动更新绑定,可以免去手工操作。
可以。用 win-acme 2.2.x 的 wacs.exe 交互模式即可自动完成 HTTP-01 验证、PFX 生成与 IIS 绑定,并创建每天检查的续订计划任务,90 天有效期在到期前 30 天自动续期。注意通配符证书必须走 DNS-01,需要提供 DNS API 凭据。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。