このガイドの機能では、Device Policy Controller(DPC)アプリに実装できるセキュリティ管理機能について説明します。このドキュメントにはコードサンプルが含まれています。また、Android のエンタープライズ機能のサンプルコードのソースとして Test DPC アプリを使用することもできます。
DPC アプリは、個人所有のデバイスではプロファイル所有者モードで、完全管理対象デバイスではデバイス所有者モードで実行できます。次の表は、DPC がプロファイル所有者モードまたはデバイス所有者モードで実行されている場合に使用できる機能を示しています。
| 機能 | プロファイル所有者 | デバイス所有者 |
|---|---|---|
| アプリへのアクセスを無効にする | ✓ | ✓ |
| 提供元不明のアプリをブロックする | ✓ | ✓ |
| Google Play でアカウントを制限する | ✓ | ✓ |
| 企業向けの出荷時設定へのリセット保護機能を有効にする | ✓ | |
| 企業のプロセスログとリモート バグレポートをモニタリングする | ✓ | |
| クライアント証明書へのアクセス権を付与、削除する | ✓ | ✓ |
| 安全なパスコードのリセット | ✓ | ✓ |
| 仕事用プロファイルのセキュリティ チャレンジ | ✓ |
アプリへのアクセスを無効にする
1 日の特定の時間帯や特定の曜日に、従業員が Android 搭載デバイスでゲームをプレイしたり YouTube を視聴したりできないようにしたい組織の場合、DPC を使用してアプリへのアクセスを一時的に無効にできます。
アプリへのアクセスを無効にするには、デバイス所有者モードまたはプロファイル所有者モードで実行されている DPC が setPackagesSuspended() を構成します。これにより、選択したアプリは無効になっているかのように動作します(Google ランチャーでアプリがグレー表示されます)。ユーザーがアプリをタップすると、アプリが一時停止されていることを示すシステム ダイアログが表示されます。
アプリが一時停止されている間は、アクティビティを開始できず、パッケージへの通知は抑制されます。停止中のパッケージは、概要画面に表示されず、ダイアログ(トーストやスナックバーを含む)を表示することも、音声を再生することも、デバイスを振動させることもできません。
ランチャーは、isPackageSuspended() メソッドを呼び出すことで、アプリが一時停止されているかどうかを確認できます。アプリの停止を構成する方法については、setPackagesSuspended をご覧ください。
提供元不明のアプリをブロックする
Google Play(またはその他の信頼できるアプリストア)からインストールされていないアプリは、提供元不明のアプリと呼ばれます。これらのアプリをインストールすると、デバイスやデータが危険にさらされるリスクが高まります。
提供元不明のアプリのインストールを防止するため、完全管理対象デバイスと仕事用プロファイルの管理コンポーネントは、DISALLOW_INSTALL_UNKNOWN_SOURCES ユーザー制限を追加できます。
仕事用プロファイルのデバイス全体の制限
仕事用プロファイルの管理者が DISALLOW_INSTALL_UNKNOWN_SOURCES を追加すると、制限は仕事用プロファイルにのみ適用されます。ただし、仕事用プロファイルの管理者は、Google Play の管理対象の設定を設定することで、デバイス全体に制限を適用できます。デバイス全体の制限は、Android 8.0 以降で、インストールされている Google Play アプリのバージョンが 80812500 以降の場合に利用できます。
アプリのインストールを Google Play に制限する手順は次のとおりです。
- Google Play パッケージ
com.android.vendingの管理対象設定バンドルを設定します。 - バンドルで、
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 Debug Bridge(adb)を使用して、個人用プロファイルにアプリをインストールできます。
提供元不明のアプリについて詳しくは、代替の配布オプションをご覧ください。
Google Play でアカウントを制限する
組織によっては、ユーザーが個人の Google アカウントを追加できるようにしたい(たとえば、Gmail でメールを読めるようにしたい)が、個人のアカウントでインストール済みのアプリをインストールできないようにしたい場合があります。DPC は、ユーザーが Google Play で使用できるアカウントのリストを設定できます。
完全管理対象デバイスまたは仕事用プロファイルの管理コンポーネントは、Google Play の管理対象設定を設定することで、アカウントを制限できます。アカウント制限は、インストールされている Google Play アプリのバージョンが 80970100 以降の場合に利用できます。
Google Play でアカウントを制限する手順は次のとおりです。
- Google Play パッケージ
com.android.vendingの管理対象設定バンドルを設定します。 - バンドルで、カンマ区切りのメールアドレスを
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 時間使用できない場合があります。 - また、出荷時の設定にリセットした後に、1 人以上の IT 管理者がデバイスのロックを解除できるようにすることもできます。これらの IT 管理者それぞれに Google アカウントにログインしてもらい、ステップ 1 に従って
userIdを共有してもらいます。これにより、次のステップでこれらのuserIdsをリストに追加できます。 - DPC は、
setFactoryResetProtectionPolicy()を使用して、出荷時の設定にリセットされたデバイスをプロビジョニングできるuserIdのリストを設定することで、適切なアプリ制限を設定します。 - DPC は、バックグラウンド制限によるドロップを防ぐために、ブロードキャスト
com.google.android.gms.auth.FRP_CONFIG_CHANGEDを明示的なインテントとして送信することで、出荷時の設定にリセットした後にデバイスをプロビジョニングできるアカウントを有効にします。
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);
レガシー
API レベル 30 で導入された setFactoryResetProtectionPolicy() を使用できないデバイスの場合、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);
レガシー
API レベル 30 で導入された setFactoryResetProtectionPolicy() を使用できないデバイスの場合、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);
企業のプロセスログとリモート バグレポートをモニタリングする
EMM コンソールでは、管理者はエンタープライズ プロセスログとリモート バグレポートを使用して、完全管理対象デバイスをモニタリングできます。
エンタープライズ デバイスのアクティビティをログに記録する
デバイス所有者モードで実行されている DPC は、アプリの起動、Android Debug Bridge(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 Debug Bridge(adb)コマンドを実行します。
adb shell dpm force-security-logs
システムは、ツールの使用頻度を制限し、意図的な速度低下をターミナル出力で報告します。利用可能なログがある場合、DPC は onSecurityLogsAvailable() コールバックを受信します。
バグレポートをリモートでリクエストする
デバイス所有者モードで実行されている DPC は、1 人のユーザーまたは関連付けられたユーザーのみを持つユーザー デバイスのバグレポートをリモートでリクエストできます。バグレポートは、バグレポートがリクエストされた正確な瞬間のデバイス アクティビティをキャプチャしますが、logcat バッファが更新される頻度によっては、過去数時間のアクティビティも含まれる場合があります。
バグレポートをリモートでリクエストするには、DPC が requestBugreport() を呼び出します。
- ユーザーがバグレポートの共有を承認すると、DPC は
onBugreportShared()を使用してバグレポートを受け取ります。 - ユーザーがバグレポートの共有を拒否すると、DPC は
onBugreportSharingDeclined()を使用して、共有リクエストが拒否されたというメッセージを受け取ります。 - バグレポートが失敗した場合、DPC には
BUGREPORT_FAILURE_FAILED_COMPLETINGまたはBUGREPORT_FAILURE_FILE_NO_LONGER_AVAILABLEを含むonBugreportFailed()が表示されます。
クライアント証明書へのアクセス権を付与、削除する
プロファイル所有者モードまたはデバイス所有者モードで実行されている DPC が、サードパーティ製アプリに証明書を管理する権限を付与すると、そのアプリは、ユーザーの介入なしに、インストールする証明書へのアクセス権を自身に付与できます。プロファイル内のすべてのアプリがアクセスできる証明書をインストールするには、installKeyPair() を使用します。
構成するパラメータについては、installKeyPair() をご覧ください。この機能は、証明書を管理するための既存の API と連携して動作します。
デプロイ シナリオ
installKeyPair() メソッドを使用しない場合:
- ユーザーは、証明書へのアクセスを許可するたびに、証明書の名前をタップして [許可] をタップする必要があります。
- 証明書をインストールするときにプロンプトが表示され、証明書に名前を付ける必要があります。
installKeyPair() メソッドを使用する。
- ユーザーは、証明書へのアクセスを許可するたびに [許可] をタップする必要はありません。
- ユーザーは証明書の名前を変更できません。
- 管理者は、特定の証明書にアクセスできないようにするアプリの証明書をブロックできるため、より詳細な制御が可能になります。
クライアント証明書を削除する
クライアント証明書へのアクセス権を付与した後、installKeyPair() を通じてインストールされたクライアント証明書をリモートで削除するには、removeKeyPair() を呼び出します。
デバイス所有者モードまたはプロファイル所有者モードで実行されている DPC、または委任された証明書インストーラは、removeKeyPair() を呼び出すことができます。これにより、指定された秘密鍵エイリアスでインストールされた証明書と鍵ペアが削除されます。
デプロイ シナリオ
この機能は、組織がより安全な形式のクライアント証明書に移行する場合に使用します。管理者が新しい証明書をロールアウトし、その配布にかなりの時間がかかる場合、管理者は移行の完了後に非推奨の証明書を取り消すことができます。
安全なパスコードのリセット
DPC は、事前登録された安全なトークンを使用して変更を承認することで、ユーザーのパスワードをリセットできます。デバイス所有者とプロファイル所有者は、安全なパスコード リセット API を呼び出して、デバイスと仕事用プロファイルのパスワードをそれぞれ変更できます。安全なパスコードのリセットは、resetPassword() を置き換えるもので、次のような改善が加えられています。
- ファイルベースの暗号化を使用しているデバイスでは、再起動後にユーザーがデバイスまたはプロファイルのロックを解除する前に、DPC がパスコードをリセットできます。
- Android キーストアは、パスコードのリセット後もユーザー認証鍵を保持します。
DPC ビルドが 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_PASSWORDインテントを送信すると、システムはユーザーにセキュリティ チャレンジの設定を求めるメッセージを表示します。 - DPC は、
ACTION_SET_NEW_PARENT_PROFILE_PASSWORDインテントを送信して、デバイスロックを設定するようユーザーに求めることもできます。
DPC は、仕事用確認コードのパスワード ポリシーを、他のデバイスのパスワードのポリシーとは異なるものに設定できます。たとえば、デバイス チャレンジ レスポンスの最小長は、他のパスワードに必要な長さとは異なる場合があります。DPC は、setPasswordQuality() や setPasswordMinimumLength() などの通常の DevicePolicyManager メソッドを使用して、チャレンジ ポリシーを設定します。
考慮事項
- DPC は仕事用プロファイルのパスワードをリセットできますが、デバイス(個人用)のパスワードはリセットできません。ユーザーが仕事用と個人用のパスワードを同じに設定することを選択した場合、仕事用プロファイルで
resetPassword()を実行すると、仕事用プロファイルでのみパスワードがリセットされ、デバイスのロック画面のパスワードとは異なるものになります。 - DPC は、
setOrganizationColor()とsetOrganizationName()を使用して、仕事用確認コードの認証情報画面をカスタマイズできます。 - デバイス管理者は、
resetPassword()を使用してパスワードを消去したり、すでに設定されているパスワードを変更したりすることはできません。デバイス管理者は引き続きパスワードを設定できますが、デバイスにパスワード、PIN、パターンが設定されていない場合に限られます。
詳細については、getParentProfileInstance() と DevicePolicyManager のリファレンス ドキュメントをご覧ください。