29. Keystore实战案例：支付SDK密钥保护、VPN证书管理、端到端加密实现、DRM方案集成

好，前面我们把Keystore的原理、架构、API都过了一遍。说实话，理论讲再多，不如直接上手干一票。这一章，我挑四个最典型的实战场景，带你看看Keystore到底怎么落地。

这四个场景分别是：支付SDK的密钥保护、VPN证书管理、端到端加密实现、DRM方案集成。每个场景我都踩过坑，有些坑现在想起来还肉疼。咱们一个一个来。

29.1 支付SDK密钥保护

支付SDK，说白了就是帮App跟服务器做签名、验签的。密钥一旦泄露，攻击者就能伪造请求，后果你懂的。

传统做法是把密钥硬编码在so里，或者藏在资源文件中。嗯，这种做法在2015年之前还行，现在嘛……基本上等于裸奔。

我的做法：把签名私钥存入Keystore，用KeyGenParameterSpec生成，设置 PURPOSE_SIGN。这样私钥永远出不了安全硬件。

// 生成签名密钥
KeyGenParameterSpec spec = new KeyGenParameterSpec.Builder(
        "payment_sign_key",
        KeyProperties.PURPOSE_SIGN)
        .setDigests(KeyProperties.DIGEST_SHA256)
        .setSignaturePaddings(KeyProperties.SIGNATURE_PADDING_RSA_PKCS1)
        .setUserAuthenticationRequired(false) // 支付场景不需要用户解锁
        .build();

KeyPairGenerator generator = KeyPairGenerator.getInstance(
        KeyProperties.KEY_ALGORITHM_RSA, "AndroidKeyStore");
generator.initialize(spec);
KeyPair keyPair = generator.generateKeyPair();

签名时，直接从Keystore取私钥：

PrivateKey privateKey = (PrivateKey) keyStore.getKey("payment_sign_key", null);
Signature signature = Signature.getInstance("SHA256withRSA");
signature.initSign(privateKey);
signature.update(data);
byte[] signedData = signature.sign();

29.2 VPN证书管理

VPN客户端需要存储客户端证书，用于跟服务器双向认证。证书如果被导出，攻击者就能冒充合法用户接入内网。

我建议：把证书和私钥一起导入Keystore。Android从API 28开始支持setIsStrongBoxBacked(true)，把密钥锁进独立安全芯片。

// 导入PKCS12证书到Keystore
KeyStore keyStore = KeyStore.getInstance("AndroidKeyStore");
keyStore.load(null);

// 从PKCS12文件加载
KeyStore p12 = KeyStore.getInstance("PKCS12");
p12.load(new FileInputStream("client.p12"), "password".toCharArray());

// 枚举别名并导入
Enumeration<String> aliases = p12.aliases();
while (aliases.hasMoreElements()) {
    String alias = aliases.nextElement();
    if (p12.isKeyEntry(alias)) {
        // 这里用setEntry，而不是getKey，避免私钥在内存中暴露
        keyStore.setEntry(
            "vpn_" + alias,
            p12.getEntry(alias, new KeyStore.PasswordProtection("password".toCharArray())),
            null
        );
    }
}

VPN连接时，用KeyChain.createInstallIntent()引导用户安装证书，或者直接用KeyChain.getPrivateKey()获取。

我记得有一次，客户反馈VPN证书导入后无法使用。查了半天，发现是证书链不完整。Android Keystore要求导入的证书必须包含完整的CA链，否则握手会失败。解决方案是：导入前先检查证书链，缺的就补上。

29.3 端到端加密实现

端到端加密（E2EE），核心是每个用户有一对密钥。公钥公开，私钥本地保存。私钥绝不能上传服务器。

我的方案：用Keystore生成RSA密钥对，公钥导出给服务器分发，私钥留在设备里。加密时用对方的公钥，解密时用自己的私钥。

// 生成E2EE密钥对
KeyGenParameterSpec spec = new KeyGenParameterSpec.Builder(
        "e2ee_key_" + userId,
        KeyProperties.PURPOSE_ENCRYPT | KeyProperties.PURPOSE_DECRYPT)
        .setKeySize(2048)
        .setBlockModes(KeyProperties.BLOCK_MODE_ECB)
        .setEncryptionPaddings(KeyProperties.ENCRYPTION_PADDING_RSA_OAEP)
        .setUserAuthenticationRequired(true)
        .setUserAuthenticationValidityDurationSeconds(300)
        .build();

KeyPairGenerator generator = KeyPairGenerator.getInstance(
        KeyProperties.KEY_ALGORITHM_RSA, "AndroidKeyStore");
generator.initialize(spec);
KeyPair keyPair = generator.generateKeyPair();

// 导出公钥（发给服务器）
byte[] publicKeyBytes = keyPair.getPublic().getEncoded();

解密时，需要用户最近5分钟内解锁过设备：

// 解密消息
Cipher cipher = Cipher.getInstance("RSA/ECB/OAEPWithSHA-256AndMGF1Padding");
cipher.init(Cipher.DECRYPT_MODE, privateKey);
byte[] plaintext = cipher.doFinal(ciphertext);

这里有个细节：setUserAuthenticationValidityDurationSeconds(300)。我设了5分钟，意思是用户解锁后5分钟内，App可以自由使用私钥。超过5分钟，需要重新解锁。这个值要根据业务场景调，太短用户体验差，太长安全性降低。

29.4 DRM方案集成

DRM（数字版权管理）这块，Android提供了MediaDrm框架，底层依赖Keystore来保护解密密钥。

说白了，DRM的流程是：

1. App从License服务器获取加密内容密钥（Content Key）
2. 这个密钥被设备公钥加密过，只有当前设备的Keystore能解密
3. 解密后的内容密钥直接送入硬件解码器，App根本碰不到

我实际做过的一个项目：集成Widevine DRM。核心代码其实不多，但坑不少。

// 初始化MediaDrm
MediaDrm mediaDrm = new MediaDrm(UUID.fromString("edef8ba9-79d6-4ace-a3c8-27dcd51d21ed")); // Widevine UUID

// 获取设备唯一ID（用于License请求）
byte[] deviceId = mediaDrm.getPropertyByteArray(MediaDrm.PROPERTY_DEVICE_UNIQUE_ID);

// 处理License响应
mediaDrm.provideKeyResponse(requestId, licenseResponse);

DRM方案集成时，还有一个容易被忽略的点：密钥过期处理。License服务器返回的密钥通常有有效期，过期后需要重新请求。我建议在播放器里加一个监听器，捕获KEY_EXPIRED事件后自动刷新License。

29.5 四个场景对比总结

场景	核心需求	Keystore用途	安全级别	常见坑
支付SDK	签名防篡改	存储签名私钥	高	低端机TEE bug
VPN证书	双向认证	存储客户端证书+私钥	高	证书链不完整
端到端加密	消息加密解密	存储解密私钥	极高	用户解锁超时
DRM集成	内容保护	保护内容密钥	极高	厂商TEE实现不完整

这四个场景，覆盖了Keystore最常见的用法。你想想看，不管是支付、VPN、聊天还是视频，最终都绕不开密钥保护。而Keystore，就是Android生态里最靠谱的密钥管家。