密钥规范 ( "KeySpec" ) 是与证书和密钥关联的属性。 它指定与证书关联的私钥是否可用于签名和/或加密。
不正确的 KeySpec 值可能会导致 AD FS 和 Web 应用程序代理错误,如:
- 未能建立与 AD FS 或 Web 应用程序代理的 SSL/TLS 连接,但未记录 (的 AD FS 事件,但可能会记录 SChannel 36888 和36874事件)
- 在 AD FS 或 WAP 窗体的身份验证页上登录失败,页面上没有显示错误消息。
你可能会在事件日志中看到以下内容:
Log Name: AD FS Tracing/Debug
Source: AD FS Tracing
Date: 2/12/2015 9:03:08 AM
Event ID: 67
Task Category: None
Level: Error
Keywords: ADFSProtocol
User: S-1-5-21-3723329422-3858836549-556620232-1580884
Computer: ADFS1.contoso.com
Description:
Ignore corrupted SSO cookie.
导致问题的原因
KeySpec 属性标识了 Microsoft CryptoAPI (CAPI) 从 Microsoft 旧加密存储提供程序 (CSP) )生成或检索到的密钥的方式。
KeySpec 值 1 或 AT_KEYEXCHANGE 可用于签名和加密。 值 2 或 AT_SIGNATURE 仅用于签名。
最常见的 KeySpec 错误配置是对证书(而不是令牌签名证书)使用值2。
对于其密钥是使用下一代加密技术 (CNG) 提供程序生成的证书,没有密钥规范的概念,KeySpec 值将始终为零。
请参阅下面的如何检查有效的 KeySpec 值。
示例
Microsoft 增强的加密提供程序就是一个旧 CSP 的示例。
Microsoft RSA CSP 密钥 blob 格式包括一种算法标识符,分别 CALG_RSA_KEYX 或 CALG_RSA_SIGN 为 AT_KEYEXCHANGE * * 或 * * AT_SIGNATURE 密钥的请求提供服务。
RSA 密钥算法标识符映射到 KeySpec 值,如下所示
| 提供程序支持的算法 | CAPI 调用的密钥规范值 |
|---|---|
| CALG_RSA_KEYX:可用于签名和解密的 RSA 密钥 | AT_KEYEXCHANGE (或 KeySpec = 1) |
| CALG_RSA_SIGN: RSA 仅签名密钥 | AT_SIGNATURE (或 KeySpec = 2) |
KeySpec 值和关联的含义
以下是各种 KeySpec 值的含义:
| Keyspec 值 | 也就是说 | 建议 AD FS 使用 |
|---|---|---|
| 0 | 证书是 CNG 证书 | 仅适用于 SSL 证书 |
| 1 | 对于传统的 CAPI (非 CNG) 证书,密钥可用于签名和解密 | SSL、令牌签名、令牌解密和服务通信证书 |
| 2 | 对于传统的 CAPI (非 CNG) 证书,密钥只能用于签名 | 不建议 |
如何检查证书/密钥的 KeySpec 值
若要查看证书值,可以使用 certutil 命令行工具。
下面是一个示例: certutil – v – store my。 这会将证书信息转储到屏幕。
Keyspec 证书
在 "CERT_KEY_PROV_INFO_PROP_ID" 下,查找以下两项内容:
-
ProviderType: 这表示证书是使用旧的加密存储提供程序 (CSP) 还是基于新证书的密钥存储提供程序 (CNG) api。 任何非零值都表示旧提供程序。
-
KeySpec: 下面是 AD FS 证书的有效 KeySpec 值:
旧 CSP 提供程序 (ProviderType 不等于 0) :
AD FS 证书目的 有效的 KeySpec 值 服务通信 1 令牌解密 1 令牌签名 1和2 SSL 1 CNG 提供程序 (ProviderType = 0) :
AD FS 证书目的 有效的 KeySpec 值 SSL 0
如何将证书的 keyspec 更改为支持的值
更改 KeySpec 值不需要证书颁发机构重新生成或重新颁发证书。 可以通过将完整的证书和私钥从 PFX 文件重新导入到证书存储中,使用以下步骤更改 KeySpec:
- 首先,检查并记录现有证书上的私钥权限,以便在重新导入后需要重新配置这些权限。
- 将包含私钥的证书导出到 PFX 文件。
- 针对每个 AD FS 和 WAP 服务器执行以下步骤
- 从 AD FS/WAP 服务器中删除证书 ()
- 使用下面的 cmdlet 语法打开提升的 PowerShell 命令提示符,并在每个 AD FS 和 WAP 服务器上导入 PFX 文件,并指定 AT_KEYEXCHANGE 值 (这适用于所有 AD FS 证书目的) :
- C: > certutil – importpfx certfile AT_KEYEXCHANGE
- 输入 PFX 密码
- 完成上述操作后,请执行以下操作
- 检查私钥权限
- 重新启动 adfs 或 wap 服务
历史资料。此文对应 2021-03-23 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 billmath)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
