Android硬件密钥库KeyMaster4.0环境下3DES解密失败求助

问题根因 #

• 测试代码存在两处核心问题，第一处是密钥生成逻辑错误：当前使用KeyGenerator.getInstance("DESede")生成的是软件层3DES密钥，并非TEE/StrongBox内生成的硬件绑定密钥。将这类软密钥写入AndroidKeyStore时，系统不会将其导入安全硬件，后续取出的密钥对象虽然getEncoded()返回null，但Cipher运算不会路由到AndroidKeyStore的硬件实现，只会默认落到BouncyCastle（BC）的软件实现上。BC的3DES逻辑依赖密钥原始字节完成运算，拿不到字节数组时就会抛出观测到的空指针异常。
• 第二处是系统版本适配限制：即使修正密钥生成逻辑，测试所用的三星Tab Active 3、Note 10、S22+三款设备若运行Android 12以下系统，依然无法调用硬件3DES能力。KeyMaster 4.0 HAL层确实声明支持3DES算法，但Android框架直到Android 12版本才在AndroidKeyStore服务中添加3DES对应的SPI路由逻辑，低版本系统不会将3DES运算请求转发给安全硬件，这也是为什么相同逻辑下AES可以正常运行——AES从Android 6开始就完成了从框架到HAL层的全链路适配，无需额外指定提供者即可自动路由到硬件实现。

可行实现方案 #

• 若需在Android 12及以上版本设备上使用硬件保护的3DES，按如下方式修正代码：
  1. 生成密钥时必须指定AndroidKeyStore为提供者，使用硬件密钥生成器创建密钥，而非生成软密钥再导入：

// 加载AndroidKeyStore
KeyStore keyStore = KeyStore.getInstance("AndroidKeyStore");
keyStore.load(null);

// 生成硬件绑定的3DES密钥
KeyGenerator keyGenerator = KeyGenerator.getInstance(
        KeyProperties.KEY_ALGORITHM_3DES,
        "AndroidKeyStore"
);
keyGenerator.init(
        new KeyGenParameterSpec.Builder(
                "hwBound3Des",
                KeyProperties.PURPOSE_ENCRYPT | KeyProperties.PURPOSE_DECRYPT
        )
                .setBlockModes(KeyProperties.BLOCK_MODE_CBC)
                .setEncryptionPaddings(KeyProperties.ENCRYPTION_PADDING_NONE)
                // 需要走StrongBox则添加.setIsStrongBoxBacked(true)，普通TEE无需配置
                .build()
);
SecretKey hw3DesKey = keyGenerator.generateKey();

2. 初始化Cipher时显式指定AndroidKeyStore提供者，避免请求路由到BC等软件实现：

Cipher cipher = Cipher.getInstance("DESede/CBC/NoPadding", "AndroidKeyStore");
IvParameterSpec iv = new IvParameterSpec(new byte[8]);
cipher.init(Cipher.DECRYPT_MODE, hw3DesKey, iv);

• 若需兼容Android 12以下版本：无官方支持的硬件3DES实现路径，可选择两种替代方案：
  • 放弃3DES，直接迁移到安全等级更高、全版本适配完善的AES算法，这是官方推荐的方案。
  • 若业务强制要求3DES，可在AndroidKeyStore中生成硬件保护的AES密钥，用该AES密钥加密3DES软密钥后存储在本地，做3DES运算时临时在内存中解密出3DES软密钥完成计算，该方案安全等级低于纯硬件运算。

官方文档与实际实现的差异说明 #

KeyMaster 4.0的HAL接口规范确实将3DES列为支持算法，但这仅代表硬件层具备3DES运算能力，不代表Android框架层完成了对应逻辑对接。安卓CDD兼容性要求中并未强制OEM厂商适配3DES的框架层路由，大部分厂商只会优先适配强制要求的AES、RSA、EC等算法，因此会出现硬件声明支持但上层实际无法调用的情况。

内容的提问来源于stack exchange，提问作者Håvard Wigtil