安全

本指南中的功能介绍了您可以在设备政策控制器 (DPC) 应用中实现的安全管理功能。本文档包含代码示例,您也可以使用 Test DPC 应用作为 Android 企业功能的示例代码来源。

DPC 应用可以在个人设备上以资料所有者模式运行,或在全托管式设备上以设备所有者模式运行。下表指明了 DPC 在资料所有者模式或设备所有者模式下运行时可用的功能:

功能 资料所有者 设备所有者
停用对应用的访问权限 ✓ ✓
禁止安装未知来源的应用 ✓ ✓
在 Google Play 中限制账号 ✓ ✓
启用企业恢复出厂设置保护机制 ✓
监控企业进程日志和远程错误报告 ✓
授予和移除对客户端证书的访问权限 ✓ ✓
安全密码重置 ✓ ✓
工作资料安全验证 ✓

停用对应用的访问权限

对于希望阻止员工在一天中的特定时间或一周中的特定日期在 Android 设备上玩游戏或观看 YouTube 的组织,DPC 可以暂时停用对应用的访问权限。

如需停用对应用的访问权限,在设备所有者或资料所有者模式下运行的 DPC 会配置 setPackagesSuspended(),然后所选应用会表现为已停用(Google 启动器会将该应用灰显)。当用户点按该应用时,会看到一个系统对话框,其中显示该应用已暂停。

当应用处于暂停状态时,它无法启动 activity,并且系统会禁止向该软件包发送通知。暂停的软件包不会显示在概览屏幕中,无法显示对话框(包括消息框和信息提示控件),也无法播放音频或使设备振动。

启动器可以通过调用 isPackageSuspended() 方法来确定应用是否已暂停。如需详细了解如何配置应用暂停,请参阅 setPackagesSuspended。

禁止安装未知来源的应用

并非从 Google Play(或其他受信任的应用商店)安装的应用称为来自未知来源的应用。用户安装这些应用后,设备和数据面临的风险可能会增加。

为了防止有人安装来自未知来源的应用,全托管式设备和工作资料的管理组件可以添加 DISALLOW_INSTALL_UNKNOWN_SOURCES 用户限制。

工作资料设备级限制

当工作资料的管理员添加 DISALLOW_INSTALL_UNKNOWN_SOURCES 时,该限制仅适用于工作资料。不过,工作资料的管理员可以通过为 Google Play 设置受管理配置来施加设备级限制。如果安装的 Google Play 应用版本为 80812500 或更高版本,则 Android 8.0(或更高版本)中会提供设备级限制。

如需将应用安装限制为仅限 Google Play,请按以下步骤操作:

  1. 为 Google Play 软件包 com.android.vending 设置托管式配置软件包。
  2. 在 bundle 中,为 verify_apps:device_wide_unknown_source_block 键添加一个布尔值。
  3. 添加 ENSURE_VERIFY_APPS 用户限制。

以下示例展示了如何检查 Google Play 是否支持此设置,并将值设为 true:

Kotlin

internal val DEVICE_WIDE_UNKNOWN_SOURCES = "verify_apps:device_wide_unknown_source_block"
internal val GOOGLE_PLAY_APK = "com.android.vending"

// ...

// Add the setting to Google Play's existing managed config. Supported in
// Google Play version 80812500 or higher--older versions ignore unsupported
// settings.
val dpm = context.getSystemService(Context.DEVICE_POLICY_SERVICE) as DevicePolicyManager
var existingConfig = dpm.getApplicationRestrictions(adminName, GOOGLE_PLAY_APK)
val newConfig = Bundle(existingConfig)
newConfig.putBoolean(DEVICE_WIDE_UNKNOWN_SOURCES, true)
dpm.setApplicationRestrictions(adminName, GOOGLE_PLAY_APK, newConfig)

// Make sure that Google Play Protect verifies apps.
dpm.addUserRestriction(adminName, UserManager.ENSURE_VERIFY_APPS)
dpm.addUserRestriction(adminName, UserManager.DISALLOW_INSTALL_UNKNOWN_SOURCES)

Java

static final String DEVICE_WIDE_UNKNOWN_SOURCES =
    "verify_apps:device_wide_unknown_source_block";
static final String GOOGLE_PLAY_APK = "com.android.vending";

// ...


// Add the setting to Google Play's existing managed config. Supported in
// Google Play version 80812500 or higher--older versions ignore unsupported
// settings.
DevicePolicyManager dpm =
    (DevicePolicyManager) context.getSystemService(Context.DEVICE_POLICY_SERVICE);
Bundle existingConfig =
    dpm.getApplicationRestrictions(adminName, GOOGLE_PLAY_APK);
Bundle newConfig = new Bundle(existingConfig);
newConfig.putBoolean(DEVICE_WIDE_UNKNOWN_SOURCES, true);
dpm.setApplicationRestrictions(adminName, GOOGLE_PLAY_APK, newConfig);

// Make sure that Google Play Protect verifies apps.
dpm.addUserRestriction(adminName, UserManager.ENSURE_VERIFY_APPS);
dpm.addUserRestriction(adminName, UserManager.DISALLOW_INSTALL_UNKNOWN_SOURCES);

系统设置中的界面仍处于活跃状态,但系统会阻止应用安装。此限制会影响未来的安装,但之前安装的应用仍会保留在设备上。设备用户可以继续使用 Android 调试桥 (adb) 将安装式应用安装到个人资料中。

如需详细了解未知来源,请参阅其他分发选项。

在 Google Play 中限制账号

有时,组织可能希望允许用户添加个人 Google 账号(例如,在 Gmail 中阅读邮件),但不希望个人账号安装应用。您的 DPC 可以设置用户可在 Google Play 中使用的账号列表。

完全受管设备或工作资料的管理员组件可以通过为 Google Play 设置受管配置来限制账号。当安装的 Google Play 应用版本为 80970100 或更高版本时,可以使用账号限制。

如需限制 Google Play 中的账号,请执行以下操作:

  1. 为 Google Play 软件包 com.android.vending 设置托管式配置软件包。
  2. 在 bundle 中,将以逗号分隔的邮箱作为 allowed_accounts 键的字符串值。

以下示例展示了如何限制账号:

Kotlin

internal val ALLOWED_ACCOUNTS = "allowed_accounts"
internal val GOOGLE_PLAY_APK = "com.android.vending"

// ...

// Limit Google Play to one work and one personal account. Use
// a comma-separated list of account email addresses (usernames).
val googleAccounts = "ali@gmail.com,ali.connors@example.com"

// Supported in Google Play version 80970100 or higher.
val existingConfig = dpm.getApplicationRestrictions(adminName, GOOGLE_PLAY_APK)
val newConfig = Bundle(existingConfig)
newConfig.putString(ALLOWED_ACCOUNTS, googleAccounts)
dpm.setApplicationRestrictions(adminName, GOOGLE_PLAY_APK, newConfig)

Java

static final String ALLOWED_ACCOUNTS = "allowed_accounts";
static final String GOOGLE_PLAY_APK = "com.android.vending";

// ...


// Limit Google Play to one work and one personal account. Use
// a comma-separated list of account email addresses (usernames).
String googleAccounts = "ali@gmail.com,ali.connors@example.com";

// Supported in Google Play version 80970100 or higher.
Bundle existingConfig =
    dpm.getApplicationRestrictions(adminName, GOOGLE_PLAY_APK);
Bundle newConfig = new Bundle(existingConfig);
newConfig.putString(ALLOWED_ACCOUNTS, googleAccounts);
dpm.setApplicationRestrictions(adminName, GOOGLE_PLAY_APK, newConfig);

如需将 Google Play 限制为仅使用工作账号,请在设备政策控制器 (DPC) 知道账号的邮箱后立即将 allowed_accounts 设置为单个受管理的账号。空字符串会阻止用户在 Google Play 中使用任何账号。

启用企业恢复出厂设置保护机制

借助企业恢复出厂设置保护机制,组织可以指定哪些 Google 账号可以配置已恢复出厂设置的设备。

消费者恢复出厂设置保护机制旨在防止设备被盗。在允许任何人在未经授权恢复出厂设置(例如使用 EMM)后配置设备之前,设置向导会要求用户针对之前位于设备个人资料中的任何 Google 账号进行身份验证。

在企业环境中,当员工离职时,恢复出厂设置是管理员工设备的重要工具。不过,如果组织不知道员工的账号凭证,恢复出厂设置保护机制可能会阻止组织将设备发放给其他员工。

控制恢复出厂设置后的配置

在设备所有者模式下运行时,DPC 可以使用 setFactoryResetProtectionPolicy() 控制哪些账号有权在恢复出厂设置后配置设备。如果此配置设为 null 或空列表,则有权在恢复出厂设置后配置设备的账号是设备个人资料中的账号。

DPC 可以在全托管式设备的整个生命周期内配置这些账号。

  1. IT 管理员可以使用 People API 中的 people.get 方法(使用特殊值 me)。此操作会检索已登录账号的 userId。userID 在 resourceName 键中以 people/[userId] 形式作为整数字符串返回。新创建的账号可能在 72 小时内无法用于恢复出厂设置。
  2. 您可能还希望允许一个或多个 IT 管理员在恢复出厂设置后解锁设备。让这些 IT 管理员分别登录其 Google 账号,并按照第 1 步操作,与您分享其 userId,以便您在下一步中将这些 userIds 添加到列表中。
  3. DPC 会使用 setFactoryResetProtectionPolicy() 设置适当的应用限制,以设置可预配恢复出厂设置的设备的 userId 列表。
  4. DPC 通过将广播 com.google.android.gms.auth.FRP_CONFIG_CHANGED 作为显式 intent 发送,启用可在恢复出厂设置后配置设备的账号,以防止因后台限制而被丢弃。

Kotlin

const val ACTION_FRP_CONFIG_CHANGED =
    "com.google.android.gms.auth.FRP_CONFIG_CHANGED"
const val GMSCORE_PACKAGE = "com.google.android.gms"

// ...

// List of userId that can provision a factory reset device.
// You can use the value returned calling people/me endpoint.
val accountIds = listOf("000000000000000000000")

dpm.setFactoryResetProtectionPolicy(
    adminName,
    FactoryResetProtectionPolicy.Builder()
        .setFactoryResetProtectionAccounts(accountIds)
        .setFactoryResetProtectionEnabled(true)
        .build()
)

val frpChangedIntent = Intent(ACTION_FRP_CONFIG_CHANGED)

frpChangedIntent.setPackage(GMSCORE_PACKAGE)
context.sendBroadcast(frpChangedIntent)

Java

static final String ACTION_FRP_CONFIG_CHANGED =
    "com.google.android.gms.auth.FRP_CONFIG_CHANGED";
static final String GMSCORE_PACKAGE = "com.google.android.gms";

// ...

// List of userId that can provision a factory reset device.
// You can use the value returned calling people/me endpoint.
List<String> accountIds = new ArrayList<String>();
accountIds.add("000000000000000000000");

dpm.setFactoryResetProtectionPolicy(
    adminName,
    new FactoryResetProtectionPolicy.Builder()
        .setFactoryResetProtectionAccounts(accountIds)
        .setFactoryResetProtectionEnabled(true)
        .build());

Intent frpChangedIntent = new Intent(ACTION_FRP_CONFIG_CHANGED);

frpChangedIntent.setPackage(GMSCORE_PACKAGE);
context.sendBroadcast(frpChangedIntent);

旧版

对于无法使用 setFactoryResetProtectionPolicy()(在 API 级别 30 中引入)的设备,您的 DPC 可以使用 setApplicationRestrictions 将所选账号添加到 com.google.android.gms 软件包的 factoryResetProtectionAdmin 受管理配置中。

Kotlin

const val GOOGLE_PLAY_APK = "com.android.vending"
const val FACTORY_RESET_PROTECTION_ADMIN = "factoryResetProtectionAdmin"
const val DISABLE_FACTORY_RESET_PROTECTION_ADMIN = "disableFactoryResetProtectionAdmin"
const val GMSCORE_PACKAGE = "com.google.android.gms"

// ...

val existingConfig = dpm.getApplicationRestrictions(adminName, GOOGLE_PLAY_APK)
val newConfig = Bundle(existingConfig)
newConfig.putBoolean(DISABLE_FACTORY_RESET_PROTECTION_ADMIN, false)
newConfig.putString(FACTORY_RESET_PROTECTION_ADMIN, googleAccounts)
dpm.setApplicationRestrictions(adminName, GOOGLE_PLAY_APK, newConfig)

val frpChangedIntent = Intent(ACTION_FRP_CONFIG_CHANGED)

frpChangedIntent.setPackage(GMSCORE_PACKAGE)
context.sendBroadcast(frpChangedIntent)

Java

static final String GOOGLE_PLAY_APK = "com.android.vending";
static final String FACTORY_RESET_PROTECTION_ADMIN = "factoryResetProtectionAdmin";
static final String DISABLE_FACTORY_RESET_PROTECTION_ADMIN = "disableFactoryResetProtectionAdmin";
static final String GMSCORE_PACKAGE = "com.google.android.gms";

// ...

Bundle existingConfig =
        dpm.getApplicationRestrictions(adminName, GOOGLE_PLAY_APK);
Bundle newConfig = new Bundle(existingConfig);
newConfig.putBoolean(DISABLE_FACTORY_RESET_PROTECTION_ADMIN, false);
newConfig.putStringArray(FACTORY_RESET_PROTECTION_ADMIN,
        accountIds.toArray(new String[accountIds.size()]));
dpm.setApplicationRestrictions(adminName, GOOGLE_PLAY_APK, newConfig);

Intent frpChangedIntent = new Intent(ACTION_FRP_CONFIG_CHANGED);

frpChangedIntent.setPackage(GMSCORE_PACKAGE);
context.sendBroadcast(frpChangedIntent);

停用企业恢复出厂设置保护机制

如需停用恢复出厂设置保护机制,您的 DPC 可以使用 setFactoryResetProtectionPolicy() 传递值 null。

Kotlin

const val ACTION_FRP_CONFIG_CHANGED =
    "com.google.android.gms.auth.FRP_CONFIG_CHANGED"
const val GMSCORE_PACKAGE = "com.google.android.gms"

// ...

dpm.setFactoryResetProtectionPolicy(adminName, null)

val frpChangedIntent = Intent(ACTION_FRP_CONFIG_CHANGED)

frpChangedIntent.setPackage(GMSCORE_PACKAGE)
context.sendBroadcast(frpChangedIntent)

Java

static final String ACTION_FRP_CONFIG_CHANGED =
    "com.google.android.gms.auth.FRP_CONFIG_CHANGED";
static final String GMSCORE_PACKAGE = "com.google.android.gms";

// ...

dpm.setFactoryResetProtectionPolicy(adminName, null);

Intent frpChangedIntent = new Intent(ACTION_FRP_CONFIG_CHANGED);

frpChangedIntent.setPackage(GMSCORE_PACKAGE);
context.sendBroadcast(frpChangedIntent);

旧版

对于无法使用 setFactoryResetProtectionPolicy()(在 API 级别 30 中引入)的设备,您的 DPC 可以使用 setApplicationRestrictions 在 com.google.android.gms 软件包的 disableFactoryResetProtectionAdmin 受管理配置中设置键值 true。

Kotlin

const val GOOGLE_PLAY_APK = "com.android.vending"
const val FACTORY_RESET_PROTECTION_ADMIN = "factoryResetProtectionAdmin"
const val DISABLE_FACTORY_RESET_PROTECTION_ADMIN = "disableFactoryResetProtectionAdmin"
const val GMSCORE_PACKAGE = "com.google.android.gms"

// ...

val existingConfig = dpm.getApplicationRestrictions(adminName, GOOGLE_PLAY_APK)
val newConfig = Bundle(existingConfig)
newConfig.putBoolean(DISABLE_FACTORY_RESET_PROTECTION_ADMIN, true)

dpm.setApplicationRestrictions(
    adminName, GOOGLE_PLAY_SERVICES_PACKAGE, restrictions
)

val frpChangedIntent = Intent(ACTION_FRP_CONFIG_CHANGED)

frpChangedIntent.setPackage(GMSCORE_PACKAGE)
context.sendBroadcast(frpChangedIntent)

Java

static final String GOOGLE_PLAY_APK = "com.android.vending";
static final String FACTORY_RESET_PROTECTION_ADMIN = "factoryResetProtectionAdmin";
static final String DISABLE_FACTORY_RESET_PROTECTION_ADMIN = "disableFactoryResetProtectionAdmin";
static final String GMSCORE_PACKAGE = "com.google.android.gms";

// ...

Bundle existingConfig =
        dpm.getApplicationRestrictions(adminName, GOOGLE_PLAY_APK);
Bundle newConfig = new Bundle(existingConfig);
newConfig.putBoolean(DISABLE_FACTORY_RESET_PROTECTION_ADMIN, true);

dpm.setApplicationRestrictions(
    adminName, GOOGLE_PLAY_SERVICES_PACKAGE, restrictions);

Intent frpChangedIntent = new Intent(ACTION_FRP_CONFIG_CHANGED);

frpChangedIntent.setPackage(GMSCORE_PACKAGE);
context.sendBroadcast(frpChangedIntent);

监控企业流程日志和远程 bug 报告

在 EMM 控制台中,管理员可以使用企业进程日志和远程 bug 报告来监控全托管式设备。

记录企业设备活动记录

以设备所有者模式运行的设备政策控制器 (DPC) 可以通过远程跟踪设备活动记录(包括应用启动、Android 调试桥 [adb] 活动和屏幕解锁)来识别可疑活动。处理日志不需要征得用户同意。

如需启用或停用日志记录,DPC 会调用 setSecurityLoggingEnabled()。

当有新一批日志可用时,DeviceAdminReceiver 会收到 onSecurityLogsAvailable() 回调。如需检索日志(在收到回调后),DPC 会调用 retrieveSecurityLogs()。

DPC 还可以调用 retrievePreRebootSecurityLogs() 来提取在上一个重新启动周期中生成的安全日志。这是设备最后一次重启与上一次重启之间的时间间隔。不支持 retrieveSecurityLogs() 的设备会返回 null。如果您的应用同时使用 retrievePreRebootSecurityLogs() 和 retrieveSecurityLogs() 检索日志,则需要检查是否有重复条目。
注意:此功能仅记录完全受管设备(由设备所有者或其 DELEGATION_SECURITY_LOGGING 委托人管理)上的活动,且设备上只有单个用户或关联用户。此功能不适用于个人设备,因为它会记录整个设备的活动。

此设置在安全性事件后审核中非常有用,因为它会记录以下类型的操作:

  • 每次应用全新启动时。这有助于识别是否存在从被入侵的应用开始的恶意软件。
  • 设备解锁失败。这可以识别短时间内是否多次尝试解锁失败。
  • 当用户使用 USB 线将设备连接到计算机时, 可能会执行有害的 adb 命令。

如需详细了解如何读取日志,请参阅 SecurityLog。

在开发和测试期间,您可以强制系统向 DPC 提供任何现有安全日志,而无需等待整个批次。在 Android 9.0(API 级别 28)或更高版本中,在终端中运行以下 Android 调试桥 (adb) 命令:

adb shell dpm force-security-logs

系统会限制您使用该工具的频率,并在终端输出中报告任何有意减慢的情况。如果有可用的日志,您的 DPC 会收到 onSecurityLogsAvailable() 回调。

远程请求错误报告

在设备所有者模式下运行的 DPC 可以远程请求仅有一个用户或关联用户的用户设备的 bug 报告。错误报告会捕获请求错误报告的确切时刻的设备活动记录,但也可能包含前几个小时的活动,具体取决于 Logcat 缓冲区刷新的频率。

如需远程请求错误报告,DPC 会调用 requestBugreport():

授予和撤消对客户端证书的访问权限

如果以资料所有者或设备所有者模式运行的 DPC 授予第三方应用管理证书的能力,则该应用可以自行授予对它所安装证书的访问权限,而无需用户干预。如需安装个人资料中的所有应用都可以访问的证书,请使用 installKeyPair()。

如需了解要配置哪些参数,请参阅 installKeyPair()。此功能与用于管理证书的现有 API 结合使用。

部署场景

不使用 installKeyPair() 方法:

  • 每次想要授予证书访问权限时,用户都需要点按证书名称,然后点按允许。
  • 用户在安装证书时会看到提示,并且必须为证书命名。

使用 installKeyPair() 方法:

  • 用户无需在每次想要授予证书访问权限时都点按允许。
  • 用户无法重命名证书。
  • 管理员拥有更多控制权,可以屏蔽不应有权访问特定证书的应用的证书。

移除客户端证书

授予对客户端证书的访问权限后,如需远程移除通过 installKeyPair() 安装的客户端证书,请调用 removeKeyPair()。

在设备所有者模式或资料所有者模式下运行的 DPC 或委托的证书安装程序可以调用 removeKeyPair()。这会移除在给定私钥别名下安装的证书和密钥对。

部署场景

如果组织要迁移到更安全的客户端证书形式,请使用此功能。如果管理员发布新证书,并且其分发需要很长时间,则管理员可以在迁移完成后撤消已弃用的证书。

安全重置密码

DPC 可以通过使用预注册的安全令牌授权更改来重置用户的密码。设备所有者和个人资料所有者可以分别调用安全密码重置 API 来更改设备和工作资料的密码。安全密码重置取代了 resetPassword(),并进行了以下改进:

  • 在采用文件级加密的设备上,DPC 可以在用户重启设备后解锁设备或个人资料之前重置密码。
  • 密码重置后,Android 密钥库会保留用户身份验证密钥。

如果您的 DPC build 以 Android 8.0(API 级别 26)或更高版本为目标平台,则应使用安全密码重置。在以 Android 8.0 或更高版本为目标平台的 DPC 中,调用 resetPassword() 会抛出 SecurityException,因此您可能需要更新 DPC。

设置并激活令牌

您的 DPC 需要先设置并激活令牌,然后才能重置密码。由于 DPC 可能无法立即使用令牌,因此您应在 IT 管理员可能需要使用令牌之前设置令牌。

重设密码令牌是一个加密强度高的随机值,长度至少需要 32 个字节。为每个设备和配置文件创建一个令牌,请勿重复使用或共享生成的令牌。

我们建议将令牌或解密加密令牌的方法存储在服务器上。如果您将令牌存储在本地凭据加密存储空间中,则在用户解锁设备或个人资料之前,DPC 无法重置密码。如果您将令牌存储在本地的设备加密存储空间中,而该存储空间遭到入侵,则攻击者可能会使用该令牌来访问工作资料或主用户。

您可以在 DPC 中生成新令牌,也可以从服务器提取令牌。以下示例展示了 DPC 自行生成令牌并将其报告给服务器:

Kotlin

val token = ByteArray(32)

// Generate a new token
val random = SecureRandom()
random.nextBytes(token)

// Set the token to use at a later date
val success: Boolean
success = dpm.setResetPasswordToken(DeviceAdminReceiver.getComponentName(context), token)

// Activate the token and update success variable...

// Store the token on a server
if (success) {
 sendTokenToServer(token)
}

Java

byte token[] = new byte[32]; // Minimum size token accepted

// Generate a new token
SecureRandom random = new SecureRandom();
random.nextBytes(token);

// Set the token to use at a later date
boolean success;
success = dpm.setResetPasswordToken(DeviceAdminReceiver.getComponentName(getContext()), token);

// Activate the token and update success variable ...

// Store the token on a server
if (success) {
 sendTokenToServer(token);
}

在大多数情况下,DPC 需要在设置令牌后将其激活。不过,如果用户没有锁屏密码,系统会立即激活令牌。如需激活令牌,请让用户确认其凭证。 您的 DPC 可以调用 KeyguardManager 方法 createConfirmDeviceCredentialIntent(),以获取启动确认的 Intent。在界面中向设备用户说明您要求他们进行身份验证的原因。以下代码段展示了如何在 DPC 中激活令牌:

Kotlin

// In your DPC, you'll need to localize the user prompt
val ACTIVATE_TOKEN_PROMPT = "Use your credentials to enable remote password reset"
val ACTIVATE_TOKEN_REQUEST = 1

// Create or fetch a token and set it in setResetPasswordToken() ...
val keyguardManager = context.getSystemService(Context.KEYGUARD_SERVICE) as KeyguardManager
val confirmIntent = keyguardManager.createConfirmDeviceCredentialIntent(null, ACTIVATE_TOKEN_PROMPT)

if (confirmIntent != null) {
 startActivityForResult(confirmIntent, ACTIVATE_TOKEN_REQUEST)
 // Check your onActivityResult() callback for RESULT_OK
} else {
 // Null means the user doesn't have a lock screen so the token is already active.
 // Call isResetPasswordTokenActive() if you need to confirm
}

Java

// In your DPC, you'll need to localize the user prompt
static final String ACTIVATE_TOKEN_PROMPT =
 "Use your credentials to enable remote password reset";
static final int ACTIVATE_TOKEN_REQUEST = 1;

// Create or fetch a token and set it in setResetPasswordToken() ...

KeyguardManager keyguardManager = (KeyguardManager) getSystemService(Context.KEYGUARD_SERVICE);
Intent confirmIntent = keyguardManager.createConfirmDeviceCredentialIntent(
  null, ACTIVATE_TOKEN_PROMPT);

if (confirmIntent != null) {
 startActivityForResult(confirmIntent, ACTIVATE_TOKEN_REQUEST);
 // Check your onActivityResult() callback for RESULT_OK
} else {
 // Null means the user doesn't have a lock screen so the token is already active.
 // Call isResetPasswordTokenActive() if you need to confirm
}

您需要在设备重启之前激活 DPC 设置的令牌。Android 会将未激活的令牌存储在内存中,并且在重启后不会保留该令牌。如果用户在激活令牌之前重启设备,您的 DPC 可以再次设置相同的令牌或生成新令牌。

DPC 可以通过调用 isResetPasswordTokenActive() 并检查结果是否为 true 来确认令牌是否有效。

DPC 设置并激活令牌后,该令牌会一直有效,直到 DPC 将其删除或替换(或设备恢复出厂设置)。该令牌独立于密码,不受用户更改或清除密码的影响。

删除令牌

您可以调用 clearResetPasswordToken() 来删除 DPC 之前设置的令牌。您可能需要撤消已泄露的令牌,或者可能需要移除重置密码的功能。以下示例展示了如何在 DPC 中执行此操作:

Kotlin

val dpm = getDpm()
val admin = DeviceAdminReceiver.getComponentName(requireActivity())

// Clear the token
if (!dpm.clearResetPasswordToken(admin)) {
 // Report the failure and possibly try later ...
}

Java

DevicePolicyManager dpm = getDpm();
ComponentName admin = DeviceAdminReceiver.getComponentName(getActivity());

// Clear the token
if (!dpm.clearResetPasswordToken(admin)) {
 // Report the failure and possibly try later ...
}

重置密码

当 IT 管理员需要重置密码时,请调用 resetPasswordWithToken() 并传递 DPC 预先设置和激活的令牌:

Kotlin

val token: ByteArray = getTokenFromServer()
val newPassword = "password"

try {
 val result: Boolean = dpm.resetPasswordWithToken(
 DeviceAdminReceiver.getComponentName(requireContext()),
 newPassword,
 token,
 0
 )

 if (result) {
 // The password is now 'password'
 } else {
 // Using 'password' doesn't meet password restrictions
 }
} catch (e: IllegalStateException) {
 // The token doesn't match the one set earlier.
}

Java

byte token[] = getTokenFromServer();
String newPassword = "password";

try {
 boolean result = dpm.resetPasswordWithToken(
  DeviceAdminReceiver.getComponentName(getContext()), newPassword, token, 0);

 if (result) {
 // The password is now 'password'
 } else {
 // Using `password` doesn't meet password restrictions
 }
} catch (IllegalStateException e) {
 // The token doesn't match the one set earlier.
}

如果新密码不符合以下限制,则调用 resetPasswordWithToken() 会返回 false,并且密码不会更改:

  • 字符数符合密码长度下限限制。调用 getPasswordMinimumLength() 可了解 IT 管理员是否设置了长度限制。
  • 密码中字符的范围和复杂性满足组合限制。调用 getPasswordQuality() 可了解 IT 管理员是否设置了组合限制。

如果密码质量限制不要求设置密码,您可以将 null 或空字符串传递给 resetPasswordWithToken() 以移除密码。

工作资料安全验证

在资料所有者模式下运行的 DPC 可以要求用户为在工作资料中运行的应用指定安全验证。当用户尝试打开任何工作应用时,系统会显示安全验证。如果用户成功完成安全质询,系统会解锁工作资料并对其进行解密(如有必要)。

工作资料安全验证的工作原理

  1. 如果 DPC 发送 ACTION_SET_NEW_PASSWORD intent,系统会提示用户设置安全验证问题。
  2. DPC 还可以发送 ACTION_SET_NEW_PARENT_PROFILE_PASSWORD intent,以提示用户设置设备锁定。

DPC 可以为工作挑战设置不同于其他设备密码的密码政策。例如,设备质询响应的最小长度可能与其他密码所需的长度不同。DPC 使用常用的 DevicePolicyManager 方法(例如 setPasswordQuality() 和 setPasswordMinimumLength())设置验证政策。

注意事项

  • DPC 可以重置工作资料的密码,但无法重置设备(个人)密码。如果用户选择将工作密码和个人密码设置为相同,则在工作资料上调用 resetPassword() 会导致仅在工作资料上重置密码,并且该密码将与设备锁屏密码不同。
  • DPC 可以使用 setOrganizationColor() 和 setOrganizationName() 自定义工作挑战的凭据屏幕。
  • 设备管理员无法使用 resetPassword() 清除密码或更改已设置的密码。设备管理员仍然可以设置密码,但仅限于设备没有密码、PIN 码或解锁图案的情况。

如需了解详情,请参阅 getParentProfileInstance() 和 DevicePolicyManager 下的参考文档。