适用场景 #
Exchange 身份验证证书(Auth Certificate)是全局唯一的自签名证书,供组织内所有 Exchange 服务器共享,用于 OAuth 身份验证。它支撑 Office Online Server(OOS)、SharePoint、Lync 以及 Exchange Online 等集成场景。OOS 需要借助该证书从 Exchange 存储中读取文档,Exchange 也需要它来正确验证与 OOS 之间的用户会话。
该证书通常在首次安装 Exchange 时自动生成,后续加入的服务器通过复制自动获取。以下情况需要手动新建或续订:
- 证书未正确生成,或未复制到全部 Exchange 服务器。
- OOS 已正确配置,但 Outlook Web 中无法查看附件。
- 证书接近过期,需要提前替换。
若环境已与 Office 365 混合部署,或与 SharePoint、Lync 通过 OAuth 集成,替换该证书会影响这些服务。操作前请查阅对应版本的官方文档,确认影响范围。
准备与风险 #
- 确认拥有 Exchange 组织管理员权限,并以管理员身份打开 Exchange 命令行管理程序。
- 记录当前证书指纹,便于回退。
- 在测试环境验证流程后再在生产环境执行。
- 新建证书前备份现有证书及私钥,导出时务必包含私钥。
- 大型环境中复制与发布可能需等待较长时间,期间不要反复修改配置。
处理步骤 #
1. 查看当前证书 #
Get-AuthConfig | FL CurrentCertificateThumbprint
若未返回指纹,说明尚未配置,可按后续步骤新建。
2. 生成自签名证书 #
在 Exchange 服务器上以管理员身份运行命令行管理程序,执行以下命令。将域名替换为实际环境值,密码使用占位符。
New-ExchangeCertificate -KeySize 2048 --password [密码] $true -SubjectName "cn=Microsoft Exchange Server Auth Certificate" -DomainName "[邮件域名]" -FriendlyName "Microsoft Exchange Server Auth Certificate" -Services SMTP
提示是否覆盖现有 SMTP 证书时,选择“否”。命令成功后记录新证书指纹。
3. 指定为全局身份验证证书 #
$dt = Get-Date
Set-AuthConfig -NewCertificateThumbprint [新证书指纹] -NewCertificateEffectiveDate $dt
提示生效时间不足 48 小时时,确认继续。
4. 发布并清理旧证书 #
Set-AuthConfig --password [密码]
Set-AuthConfig -ClearPreviousCertificate
随后在每台 Exchange 服务器上执行 IISRESET。大型环境中,证书复制与发布可能需要等待较长时间,请耐心等待后再验证。
验证方法 #
复制完成后,在每台 Exchange 服务器上执行:
(Get-AuthConfig).CurrentCertificateThumbprint | Get-ExchangeCertificate
所有服务器应返回相同指纹。若某台服务器无匹配证书,需手动处理:
- 在另一台 Exchange 服务器上确认该指纹对应的证书。
- 通过 MMC 添加“证书”管理单元(本地计算机),进入“个人”存储,导出证书并包含私钥,设置导出密码。
- 将证书导入目标服务器的本地计算机存储。
- 执行
IISRESET。 - 重新运行上述验证命令确认。
回退建议 #
- 替换前导出并保存原证书及私钥,记录原指纹。
- 若新证书导致集成异常,可用原指纹重新执行
Set-AuthConfig指定旧证书,再发布并重置 IIS。 - 回退同样需要等待复制生效,避免在复制未完成时重复操作。
常见问题 #
- 命令未返回指纹?说明尚未配置身份验证证书,按步骤新建即可。
- OOS 无法显示附件?先确认证书已复制到全部服务器且指纹一致,再检查 OOS 配置。
- 某台服务器缺少证书?按验证方法中的手动导入流程处理。
- 混合部署环境能否直接替换?替换会影响 OAuth 相关服务,务必先查阅对应版本官方文档并评估影响。
- 需要等待多久?复制时间取决于环境规模,请以实际复制状态为准,不要提前反复修改。
