KeyGenParameterSpec.Builder.SetMaxUsageCount(Int32) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Définit le nombre maximal de fois où la clé est autorisée à être utilisée.
[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.BuilderParamètres
- maxUsageCount
- Int32
nombre maximal de fois où la clé est autorisée à être utilisée ou KeyProperties.UNRESTRICTED_USAGE_COUNT s’il n’existe aucune restriction sur l’utilisation.
Retours
- Attributs
Remarques
Définit le nombre maximal de fois où la clé est autorisée à être utilisée. Après chaque utilisation de la clé, le compteur d’utilisation diminue. Cette autorisation s’applique uniquement aux opérations de clé secrète et de clé privée. Les opérations de clé publique ne sont pas limitées. Par exemple, après le chiffrement et le déchiffrement des données à l’aide de méthodes telles que Cipher.doFinal(), le compteur d’utilisation de la clé secrète diminue. Une fois les données de signature réussies à l’aide de méthodes telles que Signature.sign(), le compteur d’utilisation de la clé privée diminue. Lorsque le compteur d’utilisation est épuisé, la clé est marquée pour suppression par Android Keystore et toute tentative ultérieure d’utilisation de la clé lève KeyPermanentlyInvalidatedException. Il n’existe aucune clé à charger à partir du magasin de clés Android une fois que la clé épuisée est définitivement supprimée, comme si la clé n’existait jamais auparavant.
Par défaut, il n’existe aucune restriction sur l’utilisation de la clé.
Certains matériels sécurisés peuvent ne pas prendre en charge cette fonctionnalité du tout, auquel cas il sera appliqué dans les logiciels, certains matériels sécurisés peuvent le prendre en charge, mais uniquement avec maxUsageCount = 1, et certains matériels sécurisés peuvent le prendre en charge avec une plus grande valeur de maxUsageCount.
Les indicateurs de fonctionnalité PackageManager : PackageManager.FEATURE_KEYSTORE_SINGLE_USE_KEY et PackageManager.FEATURE_KEYSTORE_LIMITED_USE_KEY peuvent être utilisés pour vérifier si le matériel sécurisé ne peut pas appliquer cette fonctionnalité, ne peut l’appliquer qu’avec maxUsageCount = 1 ou l’appliquer avec une valeur supérieure de maxUsageCount.
Référence Android pour android.security.keystore.KeyGenParameterSpec.Builder.setMaxUsageCount.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.