大网数据广告活动
账户与安全

主机保护者服务疑难解答

· 52CE 我爱测

在受保护的构造中 (HGS) 服务器部署或操作主机保护者服务时遇到的常见问题的解决方法。

适用于: 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) 或使用自定义的第三方密钥存储提供程序。

授予对软件支持的私钥的访问权限

如果你使用的是自签名证书或证书颁发机构颁发的证书,而该证书颁发机构 未 存储在硬件安全模块或自定义密钥存储提供程序中,则可以通过执行以下步骤更改私钥权限:

  1. (certlm.msc 中打开本地证书管理器)
  2. 展开 " 个人 > 证书 " 并找到要更新的签名或加密证书。
  3. 右键单击该证书,然后选择 " 所有任务" > "管理私钥"。
  4. 选择 " 添加 " 以向新用户授予对证书私钥的访问权限。
  5. 在对象选取器中,输入之前找到的 HGS 的 gMSA 帐户名称,然后选择 "确定"。
  6. 确保 gMSA 对证书具有 读取 访问权限。
  7. 选择 "确定" 以关闭 "权限" 窗口。

如果在服务器核心上运行 HGS 或远程管理服务器,将不能使用本地证书管理器管理私钥。 相反,你将需要下载 受保护的构造工具 PowerShell 模块 ,该模块将允许你在 PowerShell 中管理权限。

  1. 在 Server Core 计算机上打开提升的 PowerShell 控制台,或使用具有对 HGS 的本地管理员权限的帐户的 PowerShell 远程处理。
  2. 运行以下命令以安装受保护的构造工具 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 主机时,会收到错误:

  1. 平台标识符文件 不 包含认可密钥证书
  2. 平台标识符文件包含认可密钥证书,但你的系统 不信任 该证书

某些 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,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Windows Server 中文文档历史快照
适用范围
历史中文快照 2021-03-23;详见原文产品版本;文档日期 10/12/2020
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。