本指南中的功能介绍了您可以在设备政策控制器 (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,请按以下步骤操作:
- 为 Google Play 软件包
com.android.vending设置托管式配置软件包。 - 在 bundle 中,为
verify_apps:device_wide_unknown_source_block键添加一个布尔值。 - 添加
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 中的账号,请执行以下操作:
- 为 Google Play 软件包
com.android.vending设置托管式配置软件包。 - 在 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 可以在全托管式设备的整个生命周期内配置这些账号。
- IT 管理员可以使用 People API 中的
people.get方法(使用特殊值me)。此操作会检索已登录账号的userId。userID在resourceName键中以people/[userId]形式作为整数字符串返回。新创建的账号可能在 72 小时内无法用于恢复出厂设置。 - 您可能还希望允许一个或多个 IT 管理员在恢复出厂设置后解锁设备。让这些 IT 管理员分别登录其 Google 账号,并按照第 1 步操作,与您分享其
userId,以便您在下一步中将这些userIds添加到列表中。 - DPC 会使用
setFactoryResetProtectionPolicy()设置适当的应用限制,以设置可预配恢复出厂设置的设备的userId列表。 - 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():
- 如果用户接受共享 bug 报告,DPC 会使用
onBugreportShared()接收 bug 报告。 - 如果用户拒绝分享 bug 报告,DPC 会使用
onBugreportSharingDeclined()收到分享请求遭拒的消息。 - 如果 bug 报告失败,DPC 会看到
onBugreportFailed(),并显示BUGREPORT_FAILURE_FAILED_COMPLETING或BUGREPORT_FAILURE_FILE_NO_LONGER_AVAILABLE。
授予和撤消对客户端证书的访问权限
如果以资料所有者或设备所有者模式运行的 DPC 授予第三方应用管理证书的能力,则该应用可以自行授予对它所安装证书的访问权限,而无需用户干预。如需安装个人资料中的所有应用都可以访问的证书,请使用 installKeyPair()。
如需了解要配置哪些参数,请参阅 installKeyPair()。此功能与用于管理证书的现有 API 结合使用。
部署场景
不使用 installKeyPair() 方法:
- 每次想要授予证书访问权限时,用户都需要点按证书名称,然后点按允许。
- 用户在安装证书时会看到提示,并且必须为证书命名。
使用 installKeyPair() 方法:
- 用户无需在每次想要授予证书访问权限时都点按允许。
- 用户无法重命名证书。
- 管理员拥有更多控制权,可以屏蔽不应有权访问特定证书的应用的证书。
移除客户端证书
授予对客户端证书的访问权限后,如需远程移除通过 installKeyPair() 安装的客户端证书,请调用 removeKeyPair()。
在设备所有者模式或资料所有者模式下运行的 DPC 或委托的证书安装程序可以调用 removeKeyPair()。这会移除在给定私钥别名下安装的证书和密钥对。
部署场景
如果组织要迁移到更安全的客户端证书形式,请使用此功能。如果管理员发布新证书,并且其分发需要很长时间,则管理员可以在迁移完成后撤消已弃用的证书。
安全重置密码
DPC 可以通过使用预注册的安全令牌授权更改来重置用户的密码。设备所有者和个人资料所有者可以分别调用安全密码重置 API 来更改设备和工作资料的密码。安全密码重置取代了 resetPassword(),并进行了以下改进:
如果您的 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 可以要求用户为在工作资料中运行的应用指定安全验证。当用户尝试打开任何工作应用时,系统会显示安全验证。如果用户成功完成安全质询,系统会解锁工作资料并对其进行解密(如有必要)。
工作资料安全验证的工作原理
- 如果 DPC 发送
ACTION_SET_NEW_PASSWORDintent,系统会提示用户设置安全验证问题。 - DPC 还可以发送
ACTION_SET_NEW_PARENT_PROFILE_PASSWORDintent,以提示用户设置设备锁定。
DPC 可以为工作挑战设置不同于其他设备密码的密码政策。例如,设备质询响应的最小长度可能与其他密码所需的长度不同。DPC 使用常用的 DevicePolicyManager 方法(例如 setPasswordQuality() 和 setPasswordMinimumLength())设置验证政策。
注意事项
- DPC 可以重置工作资料的密码,但无法重置设备(个人)密码。如果用户选择将工作密码和个人密码设置为相同,则在工作资料上调用
resetPassword()会导致仅在工作资料上重置密码,并且该密码将与设备锁屏密码不同。 - DPC 可以使用
setOrganizationColor()和setOrganizationName()自定义工作挑战的凭据屏幕。 - 设备管理员无法使用
resetPassword()清除密码或更改已设置的密码。设备管理员仍然可以设置密码,但仅限于设备没有密码、PIN 码或解锁图案的情况。
如需了解详情,请参阅 getParentProfileInstance() 和 DevicePolicyManager 下的参考文档。