Node.js实现WOPI Host时Proof Key验证始终失败求助

我之前在实现WOPI Host的Proof Key验证时，也试过用edge.js调用.NET官方代码，结果遇到了和你一模一样的问题——参数看起来都传对了，但验证就是失败。这种跨语言调用的问题，往往出在一些容易忽略的细节上，下面是我总结的几个排查方向和解决思路：

1. 字节数组/编码的一致性问题 #

Node.js的Buffer和.NET的byte[]虽然都是字节容器，但在字符串转字节的过程中可能存在差异：

• 检查你在Node.js中处理请求头（比如X-WOPI-Proof、X-WOPI-TimeStamp）时，是不是用了正确的UTF-8编码。理论上Node.js的Buffer.from(str, 'utf8')和.NET的Encoding.UTF8.GetBytes(str)是一致的，但要注意**BOM（字节顺序标记）**的问题——如果.NET代码不小心用了带BOM的UTF-8或者其他编码，就会导致字节数组不匹配。
• 建议在两边分别把关键数据（比如生成的预期Proof数据、传递的签名）转成Base64字符串打印出来，直接对比是否完全一致。比如在Node.js里用buffer.toString('base64')，在.NET里用Convert.ToBase64String(byteArray)。

2. 时间戳的精度与转换问题 #

WOPI的Proof Key验证对时间戳的精度要求很高，Node.js和.NET的时间表示差异很容易踩坑：

• Node.js的Date.now()返回的是毫秒级时间戳，而.NET的DateTime.Ticks是100纳秒级（从0001年1月1日开始计算）。如果传递给.NET函数的时间戳没有正确转换，生成的预期Proof数据就会完全错误。
• 正确的转换公式应该是：

  // Node.js中把毫秒时间戳转成.NET Ticks
  const ticks = (Date.now() * 10000) + 621355968000000000;
  

• 另外要注意请求头里的X-WOPI-TimeStamp是RFC1123格式的字符串，确保你在Node.js中解析它的时候没有时区错误，比如是不是转成了UTC时间再传递给.NET？

3. edge.js的参数序列化陷阱 #

edge.js在Node.js和.NET之间传递参数时，会做隐式的序列化/反序列化，复杂类型容易出问题：

• 比如Node.js的Buffer传到.NET那边，是不是真的被解析成了byte[]？可以在.NET的constructProofKey和TryProofkeyVerification函数里加日志，输出参数的类型和值：

  // .NET函数里的日志示例
  public static bool TryProofkeyVerification(byte[] proof, byte[] expectedProof, byte[] publicKey)
  {
      Console.WriteLine($"Proof Base64: {Convert.ToBase64String(proof)}");
      Console.WriteLine($"ExpectedProof Base64: {Convert.ToBase64String(expectedProof)}");
      // ... 原有验证逻辑
  }
  

• 如果传递的是自定义对象，要确保edge.js能正确序列化它，或者尽量用简单类型（字符串、Base64字符串、数字）传递，避免复杂类型的转换误差。

4. 公钥的导入与格式问题 #

验证签名的核心是公钥，要确保公钥在.NET中能正确导入：

• WOPI客户端的公钥通常是PEM格式的，你在传递给.NET函数之前，是不是已经去掉了-----BEGIN PUBLIC KEY-----和-----END PUBLIC KEY-----的头尾，以及中间的换行符？.NET的RSACryptoServiceProvider导入公钥时需要干净的Base64字符串。
• 可以在.NET里单独写个测试函数，手动导入公钥并验证一个已知的签名，确认公钥本身是有效的，排除公钥格式错误的可能。

5. .NET验证逻辑的细节检查 #

再仔细核对官方.NET示例的验证逻辑，确保没有遗漏WOPI规范的要求：

• 验证时是不是用了SHA256哈希算法和PKCS#1填充模式？WOPI规范明确要求这两个参数，代码应该类似：

  using (var rsa = new RSACryptoServiceProvider())
  {
      rsa.ImportSubjectPublicKeyInfo(Convert.FromBase64String(publicKeyBase64), out _);
      return rsa.VerifyData(expectedProof, proof, HashAlgorithmName.SHA256, RSASignaturePadding.Pkcs1);
  }
  

• 有没有同时验证X-WOPI-Proof和X-WOPI-ProofOld？WOPI客户端会同时发送这两个头，用来处理密钥轮换的情况，你的验证逻辑是不是只检查了其中一个？

最后排查步骤 #

1. 把Node.js端所有传递给.NET函数的参数（时间戳、公钥、请求URL、Proof值）都打印出来；
2. 在.NET端对应函数里，把接收到的参数同样打印出来，和Node.js端的对比，确保完全一致；
3. 用相同的参数，手动在.NET控制台程序里跑验证逻辑，看是否能成功；
4. 如果.NET控制台程序能成功，但edge.js调用不行，那大概率是edge.js的参数序列化问题。

我当时就是发现edge.js传递Buffer时偶尔会出现末尾字节缺失的情况，最后改成传递Base64字符串，在.NET里再转成byte[]就解决了问题。

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