XML签名验证失败问题排查及信封式签名实现咨询

1. 签名目标节点与API验签逻辑不匹配
   你最初以根元素Object作为签名引用的XPath，但API的验签逻辑实际仅校验dip节点的完整性。切换XPath到dip后验证成功，说明签名生成的哈希值和API预期不一致——API只认dip节点的哈希，签整个根节点自然过不了校验。

2. 信封式签名结构不兼容xml-crypto默认输出
   xml-crypto默认生成的是分离式签名（<Signature>与被签名节点同级），但API要求的是信封式签名（被签名的Object节点嵌套在<Signature>内部）。这种结构差异会导致API的验签程序无法定位正确的被签名内容，直接判定签名无效。

1. 直接调整签名的XPath为dip节点 #

既然切换到dip节点验证能通过，先确认API文档是否明确要求签名覆盖dip。如果是，直接修改签名代码的XPath配置：

const sig = new SignedXml();
// 指向dip节点，同时添加enveloped-signature变换适配信封结构
sig.addReference({ xpath: "//dip", transforms: ["enveloped-signature"] });

2. 手动构造信封式签名结构 #

由于xml-crypto不原生支持信封式签名，需要手动调整XML结构：

• 先对业务Object节点完成签名，得到生成的<Signature>节点
• 将原业务Object节点移动到<Signature>内部的<Object>标签下（注意：这里的<Object>是XML-Signature规范的节点，和你的业务Object节点是不同的概念）
• 调整签名的引用XPath，指向嵌套后的业务Object节点，确保哈希计算的是正确内容

调整后的结构示例：

<Signature xmlns="http://www.w3.org/2000/09/xmldsig#">
  <SignedInfo>...</SignedInfo>
  <SignatureValue>...</SignatureValue>
  <KeyInfo>...</KeyInfo>
  <Object>
    <!-- 你的业务根节点 -->
    <Object>...</Object>
  </Object>
</Signature>

3. 验签时同步调整配置 #

调用checkSignature验签时，要确保使用的XPath和签名时一致，并且必须包含enveloped-signature变换，让验签程序自动忽略<Signature>节点本身，仅校验内部的业务节点。

内容的提问来源于stack exchange，提问作者Alaa Eddine Cherif