适用于: Windows Server 2019、Windows Server (半年频道) 、Windows Server 2016
本文介绍在受保护的构造中 (HGS) 服务器部署或操作主机保护者服务时遇到的常见问题的解决方法。 如果你不确定问题的性质,请首先尝试在 HGS 服务器和 Hyper-v 主机上运行 受保护的构造诊断 ,以缩小可能的原因。
证书
HGS 需要使用多个证书才能运行,包括管理员配置的加密和签名证书,以及由 HGS 本身管理的证明证书。 如果这些证书配置不正确,则 HGS 将无法处理来自 Hyper-v 主机的请求,该主机希望证明或解锁受防护的 Vm 的密钥保护程序。 以下部分介绍了与在 HGS 上配置的证书相关的常见问题。
证书权限
HGS 必须能够访问证书指纹添加到 HGS 的加密证书和签名证书的公钥和私钥。 具体而言,组托管服务帐户 (gMSA) 运行 HGS 服务需要访问密钥。 若要查找 HGS 使用的 gMSA,请在你的 HGS 服务器上的权限提升的 PowerShell 提示符下运行以下命令:
(Get-IISAppPool -Name KeyProtection).ProcessModel.UserName
如何授予 gMSA 帐户对使用私钥的访问权限取决于存储密钥的位置:在计算机上作为本地证书文件、在硬件安全模块 (HSM) 或使用自定义的第三方密钥存储提供程序。
授予对软件支持的私钥的访问权限
如果你使用的是自签名证书或证书颁发机构颁发的证书,而该证书颁发机构 未 存储在硬件安全模块或自定义密钥存储提供程序中,则可以通过执行以下步骤更改私钥权限:
- (certlm.msc 中打开本地证书管理器)
- 展开 " 个人 > 证书 " 并找到要更新的签名或加密证书。
- 右键单击该证书,然后选择 " 所有任务" > "管理私钥"。
- 选择 " 添加 " 以向新用户授予对证书私钥的访问权限。
- 在对象选取器中,输入之前找到的 HGS 的 gMSA 帐户名称,然后选择 "确定"。
- 确保 gMSA 对证书具有 读取 访问权限。
- 选择 "确定" 以关闭 "权限" 窗口。
如果在服务器核心上运行 HGS 或远程管理服务器,将不能使用本地证书管理器管理私钥。 相反,你将需要下载 受保护的构造工具 PowerShell 模块 ,该模块将允许你在 PowerShell 中管理权限。
- 在 Server Core 计算机上打开提升的 PowerShell 控制台,或使用具有对 HGS 的本地管理员权限的帐户的 PowerShell 远程处理。
- 运行以下命令以安装受保护的构造工具 PowerShell 模块,并向 gMSA 帐户授予对私钥的访问权限。
$certificateThumbprint = '<ENTER CERTIFICATE THUMBPRINT HERE>'
# Install the Guarded Fabric Tools module, if necessary
Install-Module -Name GuardedFabricTools -Repository PSGallery
# Import the module into the current session
Import-Module -Name GuardedFabricTools
# Get the certificate object
$cert = Get-Item "Cert:\LocalMachine\My\$certificateThumbprint"
# Get the gMSA account name
$gMSA = (Get-IISAppPool -Name KeyProtection).ProcessModel.UserName
# Grant the gMSA read access to the certificate
$cert.Acl = $cert.Acl | Add-AccessRule $gMSA Read Allow
授予对 HSM 或自定义提供程序支持的私钥的访问权限
如果证书的私钥由硬件安全模块 (HSM) 或自定义密钥存储提供程序 (KSP) ,则权限模型将取决于您的特定软件供应商。 为了获得最佳结果,请查阅供应商的文档或支持网站,以获取有关如何为特定设备/软件处理私钥权限的信息。 在所有情况下,HGS 使用的 gMSA 都需要对加密、签名和通信证书私钥的 读取 权限,以便能够执行签名和加密操作。
某些硬件安全模块不支持向特定的用户帐户授予对私钥的访问权限;相反,它们允许计算机帐户访问特定密钥集中的所有密钥。 对于此类设备,通常足以使计算机能够访问密钥,并且 HGS 将能够利用该连接。
Hsm 的技巧
下面是建议的配置选项,这些选项可帮助你成功地将支持 HSM 的密钥与基于 Microsoft 及其合作伙伴体验的 HGS 结合使用。 为方便起见,我们提供了这些提示,在阅读本文时并不保证它们是正确的,也不会被 HSM 制造商认可。 如果你有其他问题,请与 HSM 制造商联系,以获取有关特定设备的准确信息。
| HSM 品牌/系列 | 建议 |
|---|---|
| Gemalto 身份 SafeNet | 确保证书请求文件中的 "密钥用法" 属性设置为0xa0,允许使用证书进行签名和加密。 此外,还必须使用本地证书管理器工具授予 gMSA 帐户对私钥的 读取 访问权限 (参阅上述步骤) 。 |
| nCipher nShield | 确保每个 HGS 节点都有权访问包含签名和加密密钥的安全体系。 你可能还需要使用本地证书管理器授予 gMSA 对私钥的 读取 访问权限 (请参阅上述步骤) 。 |
| Utimaco CryptoServers | 确保证书请求文件中的 "密钥用法" 属性设置为 "0x13",以允许将证书用于加密、解密和签名。 |
证书请求
如果你使用证书颁发机构在 (PKI) 环境的公钥基础结构中颁发证书,则需要确保证书请求包含对这些密钥的 HGS 使用的最低要求。
签名证书
| CSR 属性 | 必需的值 |
|---|---|
| 算法 | RSA |
| 密钥大小 | 至少2048位 |
| 密钥用法 | 签名/签名/DigitalSignature |
加密证书
| CSR 属性 | 必需的值 |
|---|---|
| 算法 | RSA |
| 密钥大小 | 至少2048位 |
| 密钥用法 | 加密/加密/DataEncipherment |
Active Directory 证书服务模板
如果使用 Active Directory 证书服务 (ADCS) 证书模板来创建证书,建议使用具有以下设置的模板:
| ADCS 模板属性 | 必需的值 |
|---|---|
| 提供程序类别 | 密钥存储提供程序 |
| 算法名称 | RSA |
| 最小密钥大小 | 2048 |
| 目的 | 签名和加密 |
| 密钥用法扩展 | 数字签名、密钥译码、数据加密 ( "允许对用户数据进行加密" ) |
时间偏差
如果服务器的时间与受保护构造中的其他 HGS 节点或 Hyper-v 主机的偏移明显相同,则可能会遇到证明签名者证书有效性的问题。 在 HGS 上的后台创建并续订证明签名者证书,并用于签署由证明服务颁发给受保护主机的健康证书。
若要刷新证明签名者证书,请在提升的 PowerShell 提示符下运行以下命令。
Start-ScheduledTask -TaskPath \Microsoft\Windows\HGSServer -TaskName
AttestationSignerCertRenewalTask
或者,你可以通过打开 任务计划程序 (taskschd.msc) ,导航到 任务计划程序库 > Microsoft > HGSServer 并运行名为 AttestationSignerCertRenewalTask的任务,手动运行计划的任务。
切换证明模式
如果将 HGS 从 TPM 模式切换到 Active Directory 模式,或使用 HgsServer cmdlet 将其切换为相反模式,则你的 hgs 群集中的每个节点可能需要长达10分钟的时间才能开始强制实施新的证明模式。 这是正常行为。 建议你在使用新的证明模式验证所有主机均已成功证明之前,不要删除任何允许主机使用以前的证明模式的策略。
从 TPM 切换到 AD 模式时的已知问题
如果在 TPM 模式下初始化了 HGS 群集并随后切换到 Active Directory 模式,则会出现一个已知问题,它会阻止你的 HGS 群集中的其他节点切换到新的证明模式。
若要确保所有 HGS 服务器都强制实施正确的证明模式,请 Set-HgsServer -TrustActiveDirectory 在 HGS 群集的 每个节点上 运行。
如果要从 TPM 模式切换到 AD 模式 ,并且 群集最初是在 ad 模式下设置的,则不会应用此问题。
可以通过运行 HgsServer来验证 HGS 服务器的证明模式。
内存转储加密策略
如果你尝试配置内存转储加密策略,但未看到默认的 HGS 转储策略 (Hgs _ NoDumps、hgs _ DumpEncryption 和 hgs _ DumpEncryptionKey) 或转储策略 cmdlet (HgsAttestationDumpPolicy) ,则很可能你没有安装最新的累积更新。 若要解决此问题,请将 你的 HGS 服务器更新 到最新的累积 Windows 更新并 激活新的证明策略。 激活新的证明策略之前,请确保将 Hyper-v 主机更新为相同的累积更新,因为在激活 HGS 策略后,未安装新的转储加密功能的主机可能会失败证明。
认可密钥证书错误消息
使用 HgsAttestationTpmHost cmdlet 注册主机时,会从提供的平台标识符文件中提取两个 TPM 标识符:认可密钥证书 (EKcert) ,公共认可密钥 (EKpub) 。 EKcert 标识 TPM 的制造商,从而保证 TPM 是真实的,并通过正常供应链制造。 EKpub 可以唯一地标识该特定 TPM,它是 HGS 用于授予主机运行受防护的 Vm 访问权限的一种措施。
如果满足以下两个条件之一,则在注册 TPM 主机时,会收到错误:
- 平台标识符文件 不 包含认可密钥证书
- 平台标识符文件包含认可密钥证书,但你的系统 不信任 该证书
某些 TPM 制造商未在其 Tpm 中包含 EKcerts。
如果怀疑您的 TPM 是这种情况,请向 OEM 确认 Tpm 不应具有 EKcert,并使用 -Force 标志手动向 HGS 注册该主机。
如果 TPM 应具有 EKcert,但在平台标识符文件中找不到,请确保在主机上运行 PlatformIdentifier 时,使用的是管理员 (提升的) PowerShell 控制台。
如果你收到 EKcert 不受信任的错误,请确保你已在每个 HGS 服务器上 安装受信任的 TPM 根证书包 ,并且你的 TPM 供应商的根证书位于本地计算机的 TrustedTPM _ rootca.cer 存储区中。 还需要在本地计算机上的 TrustedTPM _ IntermediateCA 存储中安装任何适用的中间证书。
安装根证书和中间证书后,应该能够 Add-HgsAttestationTpmHost 成功运行。
组托管服务帐户 (gMSA) 权限
需要授予 IIS) 中用于密钥保护服务应用程序池 (gMSA 的 HGS 服务帐户 " 生成安全审核 " 权限(也称为) SeAuditPrivilege 。 如果缺少此特权,初始 HGS 配置将成功,并且 IIS 将启动,但是密钥保护服务无法正常工作,并返回 HTTP 错误500, _ ( "在/KeyProtection 应用程序中出现服务器错误" ) 。_ 你还可能在应用程序事件日志中看到以下警告消息。
System.ComponentModel.Win32Exception (0x80004005): A required privilege is not held by the client
at Microsoft.Windows.KpsServer.Common.Diagnostics.Auditing.NativeUtility.RegisterAuditSource(String pszSourceName, SafeAuditProviderHandle& phAuditProvider)
at Microsoft.Windows.KpsServer.Common.Diagnostics.Auditing.SecurityLog.RegisterAuditSource(String sourceName)
或
Failed to register the security event source.
at System.Web.HttpApplicationFactory.EnsureAppStartCalledForIntegratedMode(HttpContext context, HttpApplication app)
at System.Web.HttpApplication.RegisterEventSubscriptionsWithIIS(IntPtr appContext, HttpContext context, MethodInfo[] handlers)
at System.Web.HttpApplication.InitSpecial(HttpApplicationState state, MethodInfo[] handlers, IntPtr appContext, HttpContext context)
at System.Web.HttpApplicationFactory.GetSpecialApplicationInstance(IntPtr appContext, HttpContext context)
at System.Web.Hosting.PipelineRuntime.InitializeApplication(IntPtr appContext)
Failed to register the security event source.
at Microsoft.Windows.KpsServer.Common.Diagnostics.Auditing.SecurityLog.RegisterAuditSource(String sourceName)
at Microsoft.Windows.KpsServer.Common.Diagnostics.Auditing.SecurityLog.ReportAudit(EventLogEntryType eventType, UInt32 eventId, Object[] os)
at Microsoft.Windows.KpsServer.KpsServerHttpApplication.Application_Start()
A required privilege is not held by the client
at Microsoft.Windows.KpsServer.Common.Diagnostics.Auditing.NativeUtility.RegisterAuditSource(String pszSourceName, SafeAuditProviderHandle& phAuditProvider)
at Microsoft.Windows.KpsServer.Common.Diagnostics.Auditing.SecurityLog.RegisterAuditSource(String sourceName)
此外,你可能会注意到没有任何密钥保护服务 cmdlet (例如 HgsKeyProtectionCertificate) 工作,而是返回错误。
若要解决此问题,需要向 gMSA 授予 "生成安全审核" (SeAuditPrivilege) 。 要执行此操作,可以使用 SecPol.msc HGS 群集的每个节点上的本地安全策略,或者组策略。 或者,您可以使用 SecEdit.exe 工具导出当前安全策略,在配置文件中进行必要的编辑, (这是纯文本) ,然后将其重新导入。
Note: 配置此设置时,为权限定义的安全原则列表会完全覆盖默认值, (不会将) 连接起来。 因此,在定义此策略设置时,除了要添加的 gMSA 外,还请确保将此特权的默认担任者( (网络服务和本地服务) )包括在内。
历史资料。此文对应 2021-03-23 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 rpsqrd)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
