KeyGenParameterSpec.Builder.SetMaxUsageCount(Int32) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Legt fest, wie oft der Schlüssel verwendet werden darf.
[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.BuilderParameter
- maxUsageCount
- Int32
maximal zulässige Anzahl von Verwendungs- oder KeyProperties.UNRESTRICTED_USAGE_COUNT, wenn keine Einschränkung für die Verwendung vorhanden ist.
Gibt zurück
- Attribute
Hinweise
Legt fest, wie oft der Schlüssel verwendet werden darf. Nach jeder Verwendung des Schlüssels nimmt der Verwendungsindikator ab. Diese Autorisierung gilt nur für geheime Schlüssel- und private Schlüsselvorgänge. Öffentliche Schlüsselvorgänge sind nicht eingeschränkt. Nach dem erfolgreichen Verschlüsseln und Entschlüsseln von Daten mithilfe von Methoden wie Cipher.doFinal() wird beispielsweise der Verwendungszähler des geheimen Schlüssels verringert. Nach dem erfolgreichen Signieren von Daten mithilfe von Methoden wie Signature.sign() wird der Verwendungsindikator des privaten Schlüssels verringert. Wenn der Verwendungsindikator erschöpft ist, wird der Schlüssel für das Löschen von Android Keystore markiert, und jeder nachfolgende Versuch, den Schlüssel zu verwenden, löst KeyPermanentlyInvalidatedException aus. Es gibt keinen Schlüssel, der aus dem Android Keystore geladen werden soll, sobald der erschöpfte Schlüssel endgültig gelöscht wird, als ob der Schlüssel noch nie vorhanden war.
Standardmäßig gibt es keine Einschränkung für die Verwendung von Schlüsseln.
Einige sichere Hardware unterstützt dieses Feature möglicherweise überhaupt nicht. In diesem Fall wird es in der Software erzwungen, einige sichere Hardware unterstützt sie möglicherweise, aber nur mit maxUsageCount = 1, und einige sichere Hardware unterstützt es möglicherweise mit größerem Wert von maxUsageCount.
Die PackageManager-Featurekennzeichnungen: PackageManager.FEATURE_KEYSTORE_SINGLE_USE_KEY und PackageManager.FEATURE_KEYSTORE_LIMITED_USE_KEY können verwendet werden, um zu überprüfen, ob die sichere Hardware dieses Feature nicht erzwingen kann, sie nur mit maxUsageCount = 1 erzwingen oder mit größerem Wert von maxUsageCount erzwingen kann.
Android-Referenz für android.security.keystore.KeyGenParameterSpec.Builder.setMaxUsageCount.
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.