使用AndroidKeyStore StrongBox存储3DES密钥时Cipher.init崩溃

问题根源 #

你遇到的NullPointerException是因为错误地将外部生成的3DES密钥导入StrongBox托管的AndroidKeyStore。StrongBox要求密钥必须由AndroidKeyStore Provider直接在硬件中生成，外部生成的密钥导入后，硬件模块无法访问密钥材料，导致Cipher初始化时无法获取有效密钥数据，触发空指针异常。

修正方案 #

使用AndroidKeyStore作为KeyGenerator的Provider，让密钥直接在StrongBox硬件内生成，而非外部生成后导入。

修正后的完整代码 #

import android.security.keystore.KeyGenParameterSpec;
import android.security.keystore.KeyProperties;
import javax.crypto.Cipher;
import javax.crypto.KeyGenerator;
import javax.crypto.SecretKey;
import javax.crypto.spec.IvParameterSpec;
import java.nio.charset.StandardCharsets;
import java.security.KeyStore;

// 生成StrongBox托管的3DES密钥
KeyGenerator kg = KeyGenerator.getInstance("DESede", "AndroidKeyStore");
KeyGenParameterSpec spec = new KeyGenParameterSpec.Builder(
        "TestAlias",
        KeyProperties.PURPOSE_ENCRYPT | KeyProperties.PURPOSE_DECRYPT)
        .setBlockModes(KeyProperties.BLOCK_MODE_CBC)
        .setEncryptionPaddings(KeyProperties.ENCRYPTION_PADDING_PKCS7)
        .setIsStrongBoxBacked(true)
        .build();
kg.init(spec);
SecretKey key = kg.generateKey();

// 加密操作
Cipher cipher = Cipher.getInstance("DESede/CBC/PKCS7Padding");
cipher.init(Cipher.ENCRYPT_MODE, key);
IvParameterSpec ivSpec = new IvParameterSpec(cipher.getIV());
byte[] encryptedData = cipher.doFinal("hello, world".getBytes(StandardCharsets.UTF_8));

// 解密操作
cipher = Cipher.getInstance("DESede/CBC/PKCS7Padding");
cipher.init(Cipher.DECRYPT_MODE, key, ivSpec);
String decryptedText = new String(cipher.doFinal(encryptedData), StandardCharsets.UTF_8);

关键说明 #

1. 指定AndroidKeyStore Provider：KeyGenerator.getInstance("DESede", "AndroidKeyStore")确保密钥直接在StrongBox硬件中生成，密钥材料不会暴露到应用层。
2. StrongBox兼容性：Pixel 6的StrongBox模块支持3DES，但需确保密钥生成时的参数（块模式、填充方式）与硬件支持的范围匹配。
3. 避免密钥导入：不要使用KeyStore.setEntry导入外部生成的密钥到StrongBox，这类操作对于3DES通常不被硬件模块支持；而AES部分设备允许导入，但3DES一般要求硬件内生成。

内容的提问来源于stack exchange，提问作者Michael Janošík