DevicePolicyManager.SetResetPasswordToken(ComponentName, Byte[]) Método

[Android.Runtime.Register("setResetPasswordToken", "(Landroid/content/ComponentName;[B)Z", "GetSetResetPasswordToken_Landroid_content_ComponentName_arrayBHandler", ApiSince=26)]
[Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_RESET_PASSWORD")]
public virtual bool SetResetPasswordToken(Android.Content.ComponentName? admin, byte[]? token);

[<Android.Runtime.Register("setResetPasswordToken", "(Landroid/content/ComponentName;[B)Z", "GetSetResetPasswordToken_Landroid_content_ComponentName_arrayBHandler", ApiSince=26)>]
[<Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_RESET_PASSWORD")>]
abstract member SetResetPasswordToken : Android.Content.ComponentName * byte[] -> bool
override this.SetResetPasswordToken : Android.Content.ComponentName * byte[] -> bool

Parâmetros

Retornos

true se a operação for bem-sucedida, caso contrário, false.

Atributos

RegisterAttribute RequiresPermissionAttribute

Comentários

Chamado por um proprietário de perfil ou dispositivo para provisionar um token que pode ser usado posteriormente para redefinir a senha de tela de bloqueio do dispositivo (se chamado pelo proprietário do dispositivo) ou desafio de perfil gerenciado (se chamado pelo proprietário do perfil), via #resetPasswordWithToken.

Se o usuário tiver atualmente uma senha de tela de bloqueio, o token provisionado não será utilizável imediatamente; ele só se torna ativo depois que o usuário executa uma operação de credencial de confirmação, que pode ser disparada por KeyguardManager#createConfirmDeviceCredentialIntent. Se o usuário não tiver senha de tela de bloqueio, o token será ativado imediatamente. Em todos os casos, o estado ativo do token atual pode ser verificado por #isResetPasswordTokenActive. Por motivos de segurança, os tokens não ativados são armazenados apenas na memória e serão perdidos quando o dispositivo for reinicializado. Nesse caso, um novo token precisa ser provisionado novamente.

Depois de provisionado e ativado, o token permanecerá em vigor mesmo se o usuário alterar ou limpar a senha da tela de bloqueio.

<em>Esse token é altamente sensível e deve ser tratado no mesmo nível que as credenciais do usuário. Em particular, NUNCA armazene esse token no dispositivo em texto sem formatação. Não armazene o token de texto sem formatação no armazenamento criptografado pelo dispositivo se ele for necessário para redefinir a senha em dispositivos de criptografia baseados em arquivo antes que o usuário desbloqueie. Considere cuidadosamente como qualquer token de senha será armazenado em seu servidor e quem precisará de acesso a eles. Os tokens podem ser objeto de solicitações de acesso legal. </em>

Em dispositivos que não dão PackageManager#FEATURE_SECURE_LOCK_SCREEN suporte ao recurso, o token de redefinição não é definido e esse método retorna false.

Java documentação para android.app.admin.DevicePolicyManager.setResetPasswordToken(android.content.ComponentName, byte[]).

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.