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

Definición

Espacio de nombres:: Android.App.Admin

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í.

Llamado por un perfil o propietario del dispositivo para aprovisionar un token que se puede usar más adelante para restablecer la contraseña de la pantalla de bloqueo del dispositivo (si lo llama el propietario del dispositivo) o el desafío de perfil administrado (si lo llama el propietario del perfil), a través #resetPasswordWithTokende .

[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

admin: ComponentName

Al que DeviceAdminReceiver está asociada esta solicitud. Null si el autor de la llamada no es un administrador de dispositivos.

token: Byte[]

un token seguro de un largo de 32 bytes como mínimo, que debe generarse mediante un generador de números aleatorios criptográficamente seguro.

Devoluciones

Boolean

True si la operación se realiza correctamente; de lo contrario, es false.

Atributos: RegisterAttribute RequiresPermissionAttribute

Comentarios

Si el usuario tiene actualmente una contraseña de pantalla de bloqueo, el token aprovisionado no se podrá usar inmediatamente; solo se activa después de que el usuario realice una operación de confirmación de credenciales, que puede desencadenar KeyguardManager#createConfirmDeviceCredentialIntent. Si el usuario no tiene ninguna contraseña de pantalla de bloqueo, el token se activa inmediatamente. En todos los casos, el estado activo del token actual se puede comprobar mediante #isResetPasswordTokenActive. Por motivos de seguridad, los tokens no activados solo se almacenan en memoria y se perderán una vez que se reinicie el dispositivo. En este caso, es necesario aprovisionar de nuevo un nuevo token.

Una vez aprovisionado y activado, el token seguirá siendo efectivo incluso si el usuario cambia o borra la contraseña de la pantalla de bloqueo.

<em>Este token es altamente confidencial y debe tratarse en el mismo nivel que las credenciales de usuario. En concreto, NUNCA almacene este token en el dispositivo en texto no cifrado. No almacene el token de texto no cifrado en el almacenamiento cifrado por dispositivo si será necesario restablecer la contraseña en dispositivos de cifrado basados en archivos antes de que el usuario se desbloquee. Considere cuidadosamente cómo se almacenará cualquier token de contraseña en el servidor y quién necesitará acceder a ellos. Los tokens pueden ser objeto de solicitudes de acceso legal. </em>

En los dispositivos que no admiten PackageManager#FEATURE_SECURE_LOCK_SCREEN la característica, el token de restablecimiento no se establece y este método devuelve false.

Java documentación para android.app.admin.DevicePolicyManager.setResetPasswordToken(android.content.ComponentName, byte[]).

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