.NET Core中SOAP请求签名验证失败原因及加前缀风险分析

我在.NET Core环境里做SOAP请求签名时，碰到了验证失败的问题。下面是我的C#签名代码：

public string SignXml(string xml, X509Certificate2 cert)
{
    if (xml == null)
        throw new ArgumentException(nameof(xml));

    if (string.IsNullOrEmpty(_appSettings.EncryptedKeyPassword))
        throw new ArgumentException(nameof(_appSettings.EncryptedKeyPassword));


    XmlDocument xmlDoc = new XmlDocument { PreserveWhitespace = true };
    xmlDoc.LoadXml(xml);

    string privateKey = File.ReadAllText(_appSettings.PrivateKeyFilePath);
    RSACryptoServiceProvider rsaKey = DecodeRsaPrivateKey(privateKey, _appSettings.EncryptedKeyPassword);

    SignedXml signedXml = new SignedXml(xmlDoc);
    signedXml.SigningKey = rsaKey;
    signedXml.SignedInfo.SignatureMethod = "http://www.w3.org/2000/09/xmldsig#rsa-sha1";

    KeyInfo keyInfo = new KeyInfo();

    KeyInfoX509Data x509Data = new KeyInfoX509Data(cert);
    x509Data.AddIssuerSerial(cert.IssuerName.Format(false), cert.SerialNumber);
    keyInfo.AddClause(x509Data);

    signedXml.KeyInfo = keyInfo;
    signedXml.SignedInfo.CanonicalizationMethod = "http://www.w3.org/TR/2001/REC-xml-c14n-20010315";

    Reference reference = new Reference();
    reference.Uri = "#Body";
    reference.AddTransform(new XmlDsigC14NTransform());
    reference.DigestMethod = "http://www.w3.org/2000/09/xmldsig#sha1";

    signedXml.AddReference(reference);

    signedXml.ComputeSignature();

    XmlElement signedElement = signedXml.GetXml();
    SetPrefix("ds", signedElement);

    XmlElement soapSignature = xmlDoc.CreateElement("soap-sec", "Signature", "http://schemas.xmlsoap.org/soap/security/2000-12");
    soapSignature.SetAttribute("xmlns:soap-sec", "http://schemas.xmlsoap.org/soap/security/2000-12");
    soapSignature.SetAttribute("SOAP-ENV:mustUnderstand", "1");

    soapSignature.AppendChild(signedElement);

    string soapNamespace = "http://schemas.xmlsoap.org/soap/envelope/";
    XmlElement soapHeader = xmlDoc.SelectSingleNode("//SOAP-ENV:Header", GetNamespaceManager(xmlDoc, soapNamespace)) as XmlElement;
    
    if (soapHeader == null)
    {
        soapHeader = xmlDoc.CreateElement("Header", "http://schemas.xmlsoap.org/soap/envelope/");
        soapHeader.Prefix = "SOAP";
        xmlDoc.DocumentElement.InsertBefore(soapHeader, xmlDoc.DocumentElement.ChildNodes[0]);
    }
    soapHeader.AppendChild(soapSignature);
    return xmlDoc.OuterXml;
}

我需要生成如下格式的XML签名，所以必须给签名元素的所有子元素添加"ds"前缀，通过SetPrefix("ds", signedElement)实现。想问两个问题：

1. 在调用signedXml.ComputeSignature()后添加前缀会不会容易引发错误？
2. 签名验证失败的可能原因有哪些？

预期签名格式：

<soap-sec:Signature xmlns:soap-sec="http://schemas.xmlsoap.org/soap/security/2000-12" mustUnderstand="1">
    <ds:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#">
        <ds:SignedInfo>
            <ds:CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
            <ds:SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1"/>
            <ds:Reference URI="#Body">
                <ds:Transforms>
                    <ds:Transform Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
                </ds:Transforms>
                <ds:DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/>
                <ds:DigestValue>..</ds:DigestValue>
            </ds:Reference>
        </ds:SignedInfo>
        <ds:SignatureValue>XrBHe3hAO</ds:SignatureValue>
        <ds:KeyInfo>
            <ds:X509Data>
                <ds:X509IssuerSerial>
                    <ds:X509IssuerName>...</ds:X509IssuerName>
                    <ds:X509SerialNumber>..</ds:X509SerialNumber>
                </ds:X509IssuerSerial>
                <ds:X509Certificate>....</ds:X509Certificate>
            </ds:X509Data>
        </ds:KeyInfo>
    </ds:Signature>
</soap-sec:Signature>

1. 计算签名后添加前缀是否会引发错误？ #

会，这大概率就是你验证失败的核心原因。

XML签名的计算基于规范化后的XML内容，其中包含元素的命名空间与前缀绑定关系。当你调用ComputeSignature()时，SignedXml已经基于当时无ds前缀的签名元素结构生成了签名值和摘要值。事后给子元素添加ds前缀，相当于修改了签名元素的结构——即便命名空间URI正确，但你使用的http://www.w3.org/TR/2001/REC-xml-c14n-20010315规范是保留前缀的模式，修改前缀会导致验证方重新规范化后的内容与你签名时的内容不一致，直接触发验证失败。

正确做法是：在计算签名前就确保签名元素使用ds前缀，比如创建SignedXml时就绑定ds前缀到http://www.w3.org/2000/09/xmldsig#命名空间，让生成的签名元素天生带ds前缀，无需事后修改。

2. 签名验证失败的其他可能原因 #

除了前缀修改的问题，还有这些常见诱因：

• 空白字符不一致：你设置了PreserveWhitespace = true，但要确保原始XML和验证方收到的XML空白（换行、缩进等）完全一致。C14N规范会处理空白，但如果双方XML解析的空白逻辑不同，也会出问题。
• 私钥加载错误：DecodeRsaPrivateKey方法是否正确解密并加载了私钥？如果私钥不匹配，签名本身就是无效的。可以先自测：用私钥签名后再用公钥验证，排除密钥问题。
• 命名空间不匹配：你创建的Header前缀是SOAP，但预期格式用的是SOAP-ENV，这可能导致验证方找不到签名元素，或解析时命名空间不匹配。
• Reference的URI匹配问题：#Body对应的元素是否存在？其命名空间是否和验证方预期一致？如果Body元素命名空间错误，Reference的摘要验证会失败。
• 证书信息问题：你添加的IssuerSerial是否正确？证书是否被验证方信任？如果验证方需要完整证书链，而你只提供了单张证书，也会导致验证失败。
• .NET Core的SignedXml差异：.NET Core的SignedXml和.NET Framework版本存在细节差异，比如默认规范化行为、命名空间处理，需要确保和验证方的实现兼容。

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