语言

KeyGenParameterSpec.Builder.SetMaxUsageCount(Int32) 方法

定义

设置允许使用密钥的最大次数。

[Android.Runtime.Register("setMaxUsageCount", "(I)Landroid/security/keystore/KeyGenParameterSpec$Builder;", "", ApiSince=31)]
public Android.Security.Keystore.KeyGenParameterSpec.Builder SetMaxUsageCount(int maxUsageCount);
[<Android.Runtime.Register("setMaxUsageCount", "(I)Landroid/security/keystore/KeyGenParameterSpec$Builder;", "", ApiSince=31)>]
member this.SetMaxUsageCount : int -> Android.Security.Keystore.KeyGenParameterSpec.Builder

参数

maxUsageCount
Int32

允许使用密钥的最大次数;如果没有使用限制,则KeyProperties.UNRESTRICTED_USAGE_COUNT密钥。

返回

特性

注解

设置允许使用密钥的最大次数。 每次使用密钥后,使用计数器就会减少。 此授权仅适用于密钥和私钥操作。 公钥操作不受限制。 例如,使用 Cipher.doFinal()等方法成功加密和解密数据后,密钥的使用计数器将减少。 使用 Signature.sign()等方法成功对数据进行签名后,私钥的使用计数器将减少。 使用计数器耗尽时,密钥将被 Android 密钥存储标记为删除,后续尝试使用该密钥将引发 KeyPermanentlyInvalidatedException。 永久删除耗尽的密钥后,不会从 Android 密钥存储加载密钥,就好像以前从未存在密钥一样。

默认情况下,密钥的使用没有限制。

某些安全硬件可能根本不支持此功能,在这种情况下,将在软件中强制执行此功能,某些安全硬件可能支持此功能,但仅支持 maxUsageCount = 1,而某些安全硬件可能支持其价值较大的 maxUsageCount。

PackageManager 功能标志:可以使用PackageManager.FEATURE_KEYSTORE_SINGLE_USE_KEY和PackageManager.FEATURE_KEYSTORE_LIMITED_USE_KEY来检查安全硬件是否无法强制实施此功能,只能使用 maxUsageCount = 1 强制实施此功能,也可以强制其值较大的 maxUsageCount。

Android 参考。android.security.keystore.KeyGenParameterSpec.Builder.setMaxUsageCount

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

适用于