KeyGenParameterSpec.Builder.SetMaxUsageCount(Int32) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Define o número máximo de vezes que a chave tem permissão para ser usada.
[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.BuilderParâmetros
- maxUsageCount
- Int32
número máximo de vezes que a chave tem permissão para ser usada ou KeyProperties.UNRESTRICTED_USAGE_COUNT se não houver nenhuma restrição ao uso.
Retornos
- Atributos
Comentários
Define o número máximo de vezes que a chave tem permissão para ser usada. Após cada uso da chave, o contador de uso diminuirá. Essa autorização se aplica apenas a operações de chave secreta e chave privada. As operações de chave pública não são restritas. Por exemplo, depois de criptografar e descriptografar dados com êxito usando métodos como Cipher.doFinal(), o contador de uso da chave secreta diminuirá. Depois de assinar dados com êxito usando métodos como Signature.sign(), o contador de uso da chave privada diminuirá. Quando o contador de uso for esgotado, a chave será marcada para exclusão pelo Android Keystore e qualquer tentativa subsequente de usar a chave gerará KeyPermanentlyInvalidatedException. Não há nenhuma chave a ser carregada do Repositório de Chaves do Android depois que a chave esgotada for excluída permanentemente, como se a chave nunca tivesse existido antes.
Por padrão, não há nenhuma restrição sobre o uso da chave.
Alguns hardwares seguros podem não dar suporte a esse recurso, caso em que ele será imposto no software, algum hardware seguro pode dar suporte a ele, mas apenas com maxUsageCount = 1, e algum hardware seguro pode dar suporte a ele com um valor maior de maxUsageCount.
Os sinalizadores de recursos PackageManager: PackageManager.FEATURE_KEYSTORE_SINGLE_USE_KEY e PackageManager.FEATURE_KEYSTORE_LIMITED_USE_KEY podem ser usados para verificar se o hardware seguro não pode impor esse recurso, só pode aplicá-lo com maxUsageCount = 1 ou pode aplicá-lo com um valor maior de maxUsageCount.
Referência do Android para android.security.keystore.KeyGenParameterSpec.Builder.setMaxUsageCount.
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.