DevicePolicyManager.SetResetPasswordToken(ComponentName, Byte[]) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
由配置文件或设备所有者调用来预配令牌,稍后可以使用令牌重置设备锁屏密码(如果由设备所有者调用),或托管配置文件质询(如果由配置文件所有者调用),通过 #resetPasswordWithToken。
[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
参数
- admin
- ComponentName
DeviceAdminReceiver此请求与此请求相关联。 如果调用方不是设备管理员,则为 Null。
- token
- Byte[]
安全令牌长度至少为 32 字节,必须由加密强随机数生成器生成。
返回
如果操作成功,则为 true;否则为 false。
- 特性
注解
由配置文件或设备所有者调用来预配令牌,稍后可以使用令牌重置设备锁屏密码(如果由设备所有者调用),或托管配置文件质询(如果由配置文件所有者调用),通过 #resetPasswordWithToken。
如果用户当前具有锁屏密码,则预配的令牌将无法立即使用;它仅在用户执行确认凭据操作后变为活动状态,该操作可由该 KeyguardManager#createConfirmDeviceCredentialIntent操作触发。 如果用户没有锁屏密码,则会立即激活令牌。 在所有情况下,都可以通过 #isResetPasswordTokenActive检查当前令牌的活动状态。 出于安全原因,未激活的令牌仅存储在内存中,一旦设备重新启动,就会丢失。 在这种情况下,需要再次预配新的令牌。
预配并激活后,即使用户更改或清除锁屏密码,令牌也将保持有效。
<em>此令牌高度敏感,应与用户凭据在同一级别进行处理。 具体而言,从不以纯文本形式将此令牌存储在设备上。 如果用户解锁之前需要在基于文件的加密设备上重置密码,请不要将纯文本令牌存储在设备加密存储中。 请仔细考虑如何将任何密码令牌存储在服务器上,以及谁需要访问它们。 令牌可能是法律访问请求的主题。 </em>
在不支持 PackageManager#FEATURE_SECURE_LOCK_SCREEN 功能的设备上,未设置重置令牌,此方法返回 false。
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。