アプリケーション ロール機能を使用すると、IT 管理者は Android 搭載デバイス上の管理対象アプリに特別な権限を付与できます。特定のロールを割り当てることで、アプリは電力とバックグラウンドの制限、停止、休止状態(Android 14 以降)から除外され、ユーザー コントロール(強制停止やアプリデータの消去などのユーザー アクションを含む)が無効になります(Android 11 以降)。これにより、アプリは中断することなく重要な機能を実行できます。さらに、アプリに割り当てられたロールを通知できるため、ユーザーの介入なしにアプリをブートストラップできます。
使用可能なアプリケーション ロールと、各ロールに付与される特別な権限の一覧については、RoleType をご覧ください。
前提条件
デバイスが AMAPI ベースの EMM で管理されている(カスタム DPC を使用する EMM はサポートされていません)。
機能を使用するためのアプリの準備
AMAPI SDK との統合が必要になるのは、アプリが割り当てられたロールの通知を受け取り、それによって自身をブートストラップする(つまり、ユーザー操作なしで自動起動する)場合のみです。
アプリに AMAPI SDK を統合する
AMAPI SDK の詳細と、アプリに AMAPI SDK を追加する方法については、AMAPI SDK 統合ガイドをご覧ください。
アプリのマニフェストに必要なメタデータを追加する
Android Device Policy(ADP)は、割り当てられたロールをアプリに通知するために、NotificationReceiverService を実装するクラスの ComponentName を認識する必要があります。ADP で自動的に検出されるように、AndroidManifest.xml でサービスに適切なタグを付ける必要があります。
- アプリには、
enabledであり、android:nameがcom.google.android.managementapi.notification.NotificationReceiverService.SERVICE_APP_ROLESと等しいmeta-dataを持つサービスが 1 つだけ必要です。 - このサービスでは、
android:exportedをtrueに設定する必要があります。 meta-dataのandroid:valueは空の文字列に設定する必要があります。
<service
android:name=".MyNotificationReceiverService"
android:exported="true">
<meta-data android:name="com.google.android.managementapi.notification.NotificationReceiverService.SERVICE_APP_ROLES" android:value="" />
</service>
COMPANION_APP ロールをテストする場合は、Android Device Policy がローカル コマンドのステータス更新をアプリに送信できるように、次の meta-data もサービスに追加する必要があります。
<meta-data android:name="com.google.android.managementapi.notification.NotificationReceiverService.SERVICE_COMMAND_STATUS" android:value="" />
NotificationReceiverService を拡張するサービスを作成する(または既存のサービスを更新する)
既存の NotificationReceiverService を作成または更新し、AppRolesListener を実装して、アプリに割り当てられたロールをリッスンします。アプリに割り当てられたロールをリッスンするには、getAppRolesListener() のみが必要です。アプリに COMPANION_APP ロールが割り当てられている場合は、getCommandListener() も実装する必要があります。
import android.util.Log
import com.google.android.managementapi.approles.AppRolesListener
import com.google.android.managementapi.approles.model.AppRolesSetRequest
import com.google.android.managementapi.approles.model.AppRolesSetResponse
import com.google.android.managementapi.commands.CommandListener
import com.google.android.managementapi.commands.model.Command
import com.google.android.managementapi.notification.NotificationReceiverService
class MyNotificationReceiverService : NotificationReceiverService() {
// If your app wants to listen for roles assigned
override fun getAppRolesListener(): AppRolesListener =
object : AppRolesListener {
override fun onAppRolesSet(request: AppRolesSetRequest): AppRolesSetResponse {
val roleTypes = request.roles.map { role -> role.roleType }
Log.i(TAG, "onAppRolesSet: $roleTypes")
return AppRolesSetResponse.getDefaultInstance()
}
}
// If your app wants to listen for local command status updates
// Only relevant for COMPANION_APP role
override fun getCommandListener(): CommandListener {
return object : CommandListener {
override fun onCommandStatusChanged(command: Command) {
Log.i(TAG, "onCommandStatusChanged")
}
}
}
private companion object {
const val TAG = "MyNotificationReceiverService"
}
}
ロールが複数回変更された場合、アプリは複数回通知を受け取ることがあります。すべてのロールが削除された場合でも、アプリには空のロールリストが通知されます。この通知により、アプリは停止状態から復帰し、アプリに付与された除外とともに、ユーザー操作なしでアプリ自体をブートストラップできます。アプリロールの通知と除外により、アプリは ACTION_BOOT_COMPLETED ブロードキャストをリッスンできます。アプリが管理対象設定に依存してブートストラップする場合は、管理対象設定をセットアップするで、変更を読み取ってリッスンする方法をご覧ください。
AMAPI SDK 1.9.0 以降、AppRolesSetRequest の各ロールには、IT 管理者がポリシーで付与した Role.ExtraCapabilities も含まれます。たとえば、コンパニオン アプリは、ローカル ワイプ コマンドの発行が許可されているかどうかを確認できます。
import com.google.android.managementapi.approles.model.AppRolesSetRequest
import com.google.android.managementapi.approles.model.AppRolesSetResponse
import com.google.android.managementapi.common.model.Role
...
override fun onAppRolesSet(request: AppRolesSetRequest): AppRolesSetResponse {
val canWipeLocally =
request.roles.any { role ->
role.roleType == Role.RoleType.COMPANION_APP &&
role.extraCapabilities.localDeviceWipeCommand ==
Role.ExtraCapabilities.LocalDeviceWipeCommand.LOCAL_DEVICE_WIPE_COMMAND_ALLOWED
}
Log.i(TAG, "onAppRolesSet: canWipeLocally=$canWipeLocally")
return AppRolesSetResponse.getDefaultInstance()
}
追加の機能を付与できるのは IT 管理者のみです。EnvironmentClient に渡すロールに extraCapabilities を設定すると、呼び出しは InvalidArgumentException で失敗します。
アプリロール ポリシーを使用してデバイスをプロビジョニングする
アプリ デベロッパーは、EMM を使用するか、Android Management API クイックスタートに沿って、アプリロールをアプリケーションに割り当てるテストを行うことができます。AMAPI Colab ノートブックを使用すると、企業の登録、ポリシーの作成、デバイスのプロビジョニングを行うことができます。
アプリロールを使用してアプリのポリシーを設定する
ApplicationPolicy.roles を使用して、アプリに割り当てるアプリロールを含む policy を設定します。
次の例は、MTD アプリのロールを構成する方法を示しています。
{
"applications": [
{
"packageName": "com.example.mtd",
"installType": "FORCE_INSTALLED",
"roles": [
{ "roleType": "MOBILE_THREAT_DEFENSE_ENDPOINT_DETECTION_RESPONSE" }
]
}
]
}
extraCapabilities をサポートしているのは COMPANION_APP ロールのみです。コンパニオン アプリがデバイスまたは仕事用プロファイルをローカルでワイプできるようにするには、そのロールの extraCapabilities.localDeviceWipeCommand を LOCAL_DEVICE_WIPE_COMMAND_ALLOWED に設定します。
ポリシーで指定されたロールを割り当てる前に、デバイス上のアプリの署名鍵証明書のフィンガープリントが Google Play ストアのフィンガープリントと一致していることを確認します。フィンガープリントが異なる場合、ロールはアプリに割り当てられず、NonComplianceReason.APP_SIGNING_CERT_MISMATCH の非準拠が EMM に報告されます。
{
"applications": [
{
"packageName": "com.example.mtd",
"installType": "FORCE_INSTALLED",
"signingKeyCerts": [
{ "signingKeyCertFingerprintSha256": "base64-encoded-sha256" }
],
"roles": [
{ "roleType": "MOBILE_THREAT_DEFENSE_ENDPOINT_DETECTION_RESPONSE" }
]
}
]
}
アプリに管理対象設定がある場合、IT 管理者はアプリケーション ポリシーで、関連する restriction の初期設定を行うことができます。
{
"applications": [
{
"packageName": "com.example.mtd",
"installType": "FORCE_INSTALLED",
"roles": [
{ "roleType": "MOBILE_THREAT_DEFENSE_ENDPOINT_DETECTION_RESPONSE" }
],
"managedConfiguration": {
"<key>": "<value>"
}
}
]
}
バッテリーの免除ステータスを確認する
Mobile Threat Defense(MTD)ロールを持つアプリは、標準のバックグラウンド電力制限から自動的に除外されます。ただし、この除外は、システムの電源許可リストではなく、アプリ スタンバイ バケットによって実装されます。
アプリの除外が有効になっているかどうかを確認するには:
import android.app.usage.UsageStatsManager
import android.content.Context
// UsageStatsManager.STANDBY_BUCKET_EXEMPTED is annotated as a @SystemApi. We can redefine it for clarity.
// Define this at the top level of your file, or inside a companion object
private const val STANDBY_BUCKET_EXEMPTED = 5
private fun isAppExemptedFromAppStandbyBucket(): Boolean =
(getSystemService(Context.USAGE_STATS_SERVICE) as? UsageStatsManager)
?.appStandbyBucket == STANDBY_BUCKET_EXEMPTED