Idioma

KeyProtection.Builder.SetUserAuthenticationRequired(Boolean) Método

Definição

Define se essa chave está autorizada a ser usada somente se o usuário tiver sido autenticado.

[Android.Runtime.Register("setUserAuthenticationRequired", "(Z)Landroid/security/keystore/KeyProtection$Builder;", "", ApiSince=23)]
public Android.Security.Keystore.KeyProtection.Builder SetUserAuthenticationRequired(bool required);
[<Android.Runtime.Register("setUserAuthenticationRequired", "(Z)Landroid/security/keystore/KeyProtection$Builder;", "", ApiSince=23)>]
member this.SetUserAuthenticationRequired : bool -> Android.Security.Keystore.KeyProtection.Builder

Parâmetros

required
Boolean

Retornos

Atributos

Comentários

Define se essa chave está autorizada a ser usada somente se o usuário tiver sido autenticado.

Por padrão, a chave está autorizada a ser usada independentemente de o usuário ter sido autenticado.

Quando a autenticação do usuário é necessária: a chave só pode ser importada se a tela de bloqueio segura estiver configurada (consulte KeyguardManager.isDeviceSecure()). Além disso, se a chave exigir que a autenticação do usuário ocorra para cada uso da chave (consulte setUserAuthenticationValidityDurationSeconds(int)), pelo menos uma biometria deverá ser registrada (consulte BiometricManager.canAuthenticate(); O uso da chave deve ser autorizado pelo usuário autenticando-se neste dispositivo Android usando um subconjunto de suas credenciais de tela de bloqueio segura, como senha/PIN/padrão ou biométrico. Mais informações; A chave será invalidada irreversivelmente depois que a tela de bloqueio segura estiver desabilitada (reconfigurada para Nenhum, Passar o dedo ou outro modo que não autentique o usuário) ou quando a tela de bloqueio segura for redefinida à força (por exemplo, por um Administrador de Dispositivos). Além disso, se a chave exigir que a autenticação do usuário ocorra para cada uso da chave, ela também será invalidada irreversivelmente quando uma nova biometria for registrada ou quando nenhuma biometria for registrada, a menos que setInvalidatedByBiometricEnrollment(boolean) seja usado para permitir a validade após o registro. As tentativas de inicializar operações criptográficas usando essas chaves gerarão KeyPermanentlyInvalidatedException.

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.

Referência do Android para android.security.keystore.KeyProtection.Builder.setUserAuthenticationRequired.

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.

Aplica-se a