PKCS#11Interop.X509Store无法找到私钥及签名报错问题咨询

排查步骤 #

• 确认令牌私钥权限配置
  检查PKCS#11令牌内对应证书的私钥是否开启允许签名、允许会话访问权限，部分硬件UKey、智能卡会默认禁止私钥导出，GetRSAPrivateKey()方法需要读取私钥明文到内存，遇到不可导出私钥时会直接返回null。
• 校验进程访问令牌权限
  确认当前程序运行身份是否有权限访问PKCS#11设备资源，非管理员权限运行的进程、低权限服务账号经常出现无法读取令牌私钥的问题，可提权运行后验证问题是否复现。
• 核对证书与私钥绑定关系
  调用PKCS#11原生接口查询对应证书的CKA_ID属性值，对比同令牌内私钥的CKA_ID，二者不一致时组件无法关联证书与对应私钥，会出现私钥读取失败的问题。
• 验证密钥算法类型
  GetRSAPrivateKey()仅支持返回RSA类型私钥，若令牌内为ECC、SM2等其他算法密钥，调用该方法会返回null，可先通过GetKeyAlgorithm()方法确认实际密钥类型。

解决方案 #

• 不可导出私钥适配方案
  托管在硬件令牌内的不可导出私钥不要通过GetRSAPrivateKey()读取，直接调用PKCS#11组件的原生签名接口完成签名计算，再把签名结果赋值给SignedXml对象，示例代码如下：

  // 枚举获取对应私钥对象
  var privateKey = session.FindAllObjects(new List<ObjectAttribute>()
  {
      new ObjectAttribute(CKA.CKA_CLASS, CKO.CKO_PRIVATE_KEY),
      new ObjectAttribute(CKA.CKA_ID, targetCertCkaId)
  }).First();
  
  // 调用硬件完成签名计算
  byte[] digest = signedXml.SignatureMethod == "http://www.w3.org/2001/04/xmldsig-more#rsa-sha256" 
      ? SHA256.Create().ComputeHash(signedXml.SignedInfo.GetXml().OuterXml)
      : SHA1.Create().ComputeHash(signedXml.SignedInfo.GetXml().OuterXml);
  byte[] signature = session.Sign(new Mechanism(CKM.CKM_RSA_PKCS), privateKey, digest);
  
  // 赋值签名结果
  signedXml.SignatureValue = signature;
  

• 绑定关系异常修复方案
  重新向令牌内导入证书与私钥，导入时强制指定证书和私钥使用相同的CKA_ID值，确保二者绑定关系正确。
• 权限不足修复方案
  Windows环境下右键选择以管理员身份运行程序，Linux环境下给运行进程添加PKCS#11驱动文件的读取、执行权限，若为服务部署可调整服务运行账号为system/root权限测试。
• 非RSA密钥适配方案
  根据实际密钥类型调用对应私钥获取方法，ECC密钥调用GetECDsaPrivateKey()，SM2密钥调用国密对应的私钥读取方法，同时调整SignedXml的签名算法配置为匹配的算法标识。

内容的提问来源于stack exchange，提问作者Dalmo