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

[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

Paramètres

Retours

true si l’opération réussit, false sinon.

Attributs

RegisterAttribute RequiresPermissionAttribute

Remarques

Appelé par un profil ou un propriétaire d’appareil pour provisionner un jeton qui peut être utilisé ultérieurement pour réinitialiser le mot de passe de l’écran de verrouillage de l’appareil (s’il est appelé par le propriétaire de l’appareil) ou le défi de profil managé (s’il est appelé par le propriétaire du profil), via #resetPasswordWithToken.

Si l’utilisateur dispose actuellement d’un mot de passe d’écran de verrouillage, le jeton provisionné ne sera pas immédiatement utilisable ; elle devient active uniquement une fois que l’utilisateur effectue une opération de confirmation des informations d’identification, qui peut être déclenchée par KeyguardManager#createConfirmDeviceCredentialIntent. Si l’utilisateur n’a pas de mot de passe d’écran de verrouillage, le jeton est activé immédiatement. Dans tous les cas, l’état actif du jeton actuel peut être vérifié par #isResetPasswordTokenActive. Pour des raisons de sécurité, les jetons non activés sont stockés uniquement en mémoire et seront perdus une fois l’appareil redémarré. Dans ce cas, un nouveau jeton doit être provisionné à nouveau.

Une fois provisionné et activé, le jeton reste effectif même si l’utilisateur change ou efface le mot de passe de l’écran de verrouillage.

<em>Ce jeton est très sensible et doit être traité au même niveau que les informations d’identification de l’utilisateur. En particulier, NEVER stocke ce jeton sur l’appareil en texte clair. Ne stockez pas le jeton en texte clair dans le stockage chiffré par l’appareil s’il sera nécessaire de réinitialiser le mot de passe sur les appareils de chiffrement basés sur des fichiers avant le déverrouillage de l’utilisateur. Réfléchissez soigneusement à la façon dont un jeton de mot de passe sera stocké sur votre serveur et qui aura besoin d’y accéder. Les jetons peuvent être l’objet de demandes d’accès juridique. </em>

Sur les appareils ne prenant pas en charge PackageManager#FEATURE_SECURE_LOCK_SCREEN la fonctionnalité, le jeton de réinitialisation n’est pas défini et cette méthode retourne false.

Java documentation pour android.app.admin.DevicePolicyManager.setResetPasswordToken(android.content.ComponentName, byte[]).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.