KeyGenParameterSpec.Builder.SetMaxUsageCount(Int32) Método

Definición

Espacio de nombres:: Android.Security.Keystore

Ensamblado:: Mono.Android.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Establece el número máximo de veces que se permite usar la clave.

[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

Parámetros

maxUsageCount: Int32

número máximo de veces que se permite usar la clave o KeyProperties.UNRESTRICTED_USAGE_COUNT si no hay ninguna restricción sobre el uso.

Devoluciones

KeyGenParameterSpec.Builder

Atributos: RegisterAttribute

Comentarios

Establece el número máximo de veces que se permite usar la clave. Después de cada uso de la clave, el contador de uso disminuirá. Esta autorización solo se aplica a las operaciones de clave secreta y clave privada. Las operaciones de clave pública no están restringidas. Por ejemplo, después de cifrar y descifrar correctamente los datos mediante métodos como Cipher.doFinal(), el contador de uso de la clave secreta disminuirá. Después de firmar correctamente los datos mediante métodos como Signature.sign(), el contador de uso de la clave privada disminuirá. Cuando se agota el contador de uso, el almacén de claves de Android marcará la clave para su eliminación y cualquier intento posterior de usar la clave producirá KeyPermanentlyInvalidatedException. No hay ninguna clave que se cargue desde el almacén de claves de Android una vez que la clave agotada se elimine permanentemente, como si la clave nunca existiera antes.

De forma predeterminada, no hay ninguna restricción en el uso de la clave.

Es posible que algún hardware seguro no admita esta característica en absoluto, en cuyo caso se aplicará en el software, es posible que algún hardware seguro lo admita, pero solo con maxUsageCount = 1, y algún hardware seguro puede admitirlo con un valor mayor de maxUsageCount.

Las marcas de características packageManager: PackageManager.FEATURE_KEYSTORE_SINGLE_USE_KEY y PackageManager.FEATURE_KEYSTORE_LIMITED_USE_KEY se pueden usar para comprobar si el hardware seguro no puede aplicar esta característica, solo puede aplicarla con maxUsageCount = 1 o puede aplicarla con un valor mayor de maxUsageCount.

Referencia de Android para android.security.keystore.KeyGenParameterSpec.Builder.setMaxUsageCount.

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

Se aplica a