Android KeyStore哈希时触发Unsupported purpose错误求助

问题原因分析 #

报错Unsupported purpose when hashing - using PURPOSE_SIGN的核心原因有两点：

• 存储到KeyStore的密钥算法类型不匹配：你用AES_ALG创建了SecretKeySpec，但后续要用于HmacSHA256操作，Android KeyStore不允许用AES密钥执行HMAC相关操作。
• KeyProtection参数冗余且冲突：你为密钥设置了AES专属的BLOCK_MODE_GCM和ENCRYPTION_PADDING_NONE，这些参数和HMAC用途不兼容，触发了用途不支持的错误。

具体解决步骤 #

1. 修正密钥的算法类型 #

将存储到KeyStore的密钥指定为HMAC算法（即你使用的HmacSHA256），而不是AES。因为HMAC需要专门的HMAC密钥，不能复用AES密钥。

2. 调整KeyProtection配置 #

移除AES相关的块模式、加密填充参数，只保留HMAC所需的用途和摘要配置：

• 保留PURPOSE_SIGN（HMAC生成属于签名用途），如果需要验证HMAC，可添加PURPOSE_VERIFY。
• 移除setBlockModes和setEncryptionPaddings，这些参数对HMAC无效。
• 保留对应HMAC算法的摘要（DIGEST_SHA256）。

修改后的代码示例 #

加载密钥的代码

private fun loadKey(fullAlias: String, key: SecretKey) {
    // 改用HmacSHA256作为密钥算法，匹配后续的HMAC操作
    val keyEntry = KeyStore.SecretKeyEntry(SecretKeySpec(key.encoded, HMAC_ALGORITHM))
    val prot: ProtectionParameter = KeyProtection.Builder(
        KeyProperties.PURPOSE_SIGN // 若需要验证HMAC，可添加 or KeyProperties.PURPOSE_VERIFY
    )
        .setDigests(KeyProperties.DIGEST_SHA256)
        .setUserAuthenticationRequired(false)
        .setRandomizedEncryptionRequired(false)
        .build()
    keyStore.setEntry(fullAlias, keyEntry, prot)
}

HMAC哈希实现代码（无需修改，确保传入的是KeyStore中加载的HMAC密钥）

private const val HMAC_ALGORITHM = "HmacSHA256"

fun pibaseToken(key: Key, label: ByteString): ByteString {
    val mac = Mac.getInstance(HMAC_ALGORITHM)
    mac.init(key)
    val token = mac.doFinal(label.toByteArray())
    return ByteString.copyFrom(token)
}

额外说明 #

如果你的需求是同一个密钥既要支持AES加密解密，又要支持HMAC哈希，Android KeyStore不允许这种跨用途的密钥使用，建议分开存储两个独立的密钥：一个用于AES加解密，一个用于HMAC操作。

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