使用公钥解密时遇BouncyCastle FIPS校验错误求助

首先，你碰到的org.bouncycastle.crypto.fips.FipsOperationError: Module checksum failed: entry错误，大概率是BouncyCastle FIPS模块的完整性校验没通过——这是FIPS合规的硬性要求，模块会自动校验自身完整性，确保代码没被篡改。另外，你的代码还有个逻辑误区：用Cipher来做RSA签名验证（公钥解密）并不是标准做法，在FIPS合规场景下更推荐用专门的Signature类来处理。

一、搞定Module Checksum Failed错误 #

这个错误常见原因有几个，你可以挨个排查：

• 依赖包问题：确保你引入的是完整且版本匹配的BouncyCastle FIPS包，比如bc-fips和bcpkix-fips版本要严格对应，绝对不能混用非FIPS版本的BC包。
• 模块加载路径问题：FIPS模块需要从可信路径加载，如果你是在打包后环境运行，要保证BC的FIPS jar包没被修改，且类加载器能正确访问到完整的模块文件。
• 环境修改干扰：如果你的环境对jar包做了字节码增强、混淆或者调试修改，会破坏FIPS模块的校验和，直接导致这个错误。必须保证BC FIPS的jar包是原始未修改的版本。

二、修正RSA签名验证的代码逻辑 #

用Cipher直接解密签名来验证哈希的做法不符合标准规范，还可能触发FIPS合规检查问题。正确的姿势是用Signature类完成RSA签名验证，修正后的代码如下：

import java.security.PublicKey;
import java.security.Signature;
import org.bouncycastle.jcajce.provider.BouncyCastleFipsProvider;

private static boolean verifyRSASignature(PublicKey key, byte[] originalData, byte[] signature) {
    if (key.getAlgorithm().equalsIgnoreCase("RSA")) {
        try {
            // 注意：这里的算法要和签名生成时完全一致，比如SHA256withRSA，根据实际场景调整
            Signature sig = Signature.getInstance("SHA256withRSA", new BouncyCastleFipsProvider());
            sig.initVerify(key);
            sig.update(originalData); // 传入签名对应的原始数据，而非直接解密签名
            return sig.verify(signature);
        } catch (Exception e) {
            e.printStackTrace();
            return false;
        }
    }
    return false;
}

public static void main(String[] args) {
    // 替换成签名对应的原始数据
    byte[] originalData = "your original content here".getBytes();
    byte[] signature = { 41, 9, 86, 109, -67, 82, -61, -60, -1, -46, 26, 65, 20, -112, 23, -16, -25, 115, 21, 39, -49, 11, -98, 44, 96, -51, 24, -97, -38, -72, 27, -119, 16, -43, 38, -49, -116, 3, 62, 12, -7, 102, 67, -37, -128, -10, 3, 122, -22, -2, -58, 97, 104, 74, 76, -45, 19, 50, 34, 33, -74, 54, 44, -60, 23, -109, -6, -3, -31, -98, -58, 12, -94, -72, -15, -72, 22, 88, -54, 5, 122, -29, -27, -74, 47, -127, 26, 120, 64, 59, 53, -82, -97, -80, -66, 48, -16, 26, 17, 60, 104, 78, -91, 2, 78, 33, -18, -60, 30, -118, -51, 29, 0, -48, 87, -112, 23, 70, 127, -80, 116, -93, -1, 51, -56, -110, 86, -68 };
    
    // 假设你已经获取到对应的PublicKey实例
    // PublicKey publicKey = ...;
    // boolean isSignatureValid = verifyRSASignature(publicKey, originalData, signature);
}

为什么不推荐用Cipher？ #

• 合规性：FIPS规范更认可Signature这类专门的签名验证API，它内部已经处理了PKCS#1 padding等细节，避免手动操作出错。
• 安全性：直接用Cipher解密签名可能泄露敏感信息，而Signature API做了更安全的封装。
• 可读性：代码意图更清晰，一眼就能看出是在做签名验证，而非普通加解密。

三、额外注意事项 #

• 确保BouncyCastle FIPS Provider正确初始化，并且在代码中优先使用它。
• 如果特殊场景下必须用Cipher处理，要确保算法字符串是FIPS认可的格式，比如RSA/ECB/PKCS1Padding（RSA签名解密用的是ECB模式），但还是强烈建议用Signature API。

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