新機能: Play Integrity API に、新しいセキュリティ脅威からアプリとユーザーを保護するための新機能が追加されました。ベータ版を終了したアプリアクセスリスクを使用すると、画面をキャプチャしたりデバイスを操作したりする可能性のある他のアプリが実行されているかどうかを確認できます。すべての新機能について詳しくは、Google I/O 2024 のAndroid のユーザーセキュリティを強化する動画セッションをご覧ください。

このページは Cloud Translation API によって翻訳されました。

改善

このページでは、完全性判定の結果に関する問題への対処方法について説明します。

完全性トークンがリクエストされたときに、ユーザーに Google Play ダイアログを表示できます。完全性判定の結果に 1 つ以上の問題がある場合は、アプリの上部にダイアログを表示して、問題の原因を解消するようユーザーに促すことができます。ダイアログを閉じると、Integrity API への別のリクエストで問題が修正されたことを確認できます。

完全性ダイアログ

GET_LICENSED（タイプコード 1）

判定に関する問題

appLicensingVerdict == "UNLICENSED" の場合は、ユーザーアカウントにライセンスが付与されていないことを意味します。つまり、Google Play からアプリをインストールまたは購入していないということです。

改善

GET_LICENSED ダイアログを表示して、Google Play からアプリを入手するようユーザーに促すことができます。ユーザーが承諾すると、ユーザーアカウントにライセンスが付与されます（appLicensingVerdict == "LICENSED"）。アプリがユーザーの Google Play ライブラリに追加され、Google Play を通じてアプリアップデートを配信できるようになります。

UX の例

Google Play の GET_LICENSED ダイアログ

CLOSE_UNKNOWN_ACCESS_RISK（タイプコード 2）

判定に関する問題

environmentDetails.appAccessRiskVerdict.appsDetected に "UNKNOWN_CAPTURING" または "UNKNOWN_CONTROLLING" が含まれている場合、画面をキャプチャしたりデバイスを操作したりする可能性のある不明なアプリがデバイス上で実行されていることを意味します。

改善

CLOSE_UNKNOWN_ACCESS_RISK ダイアログを表示して、画面をキャプチャまたはデバイスを制御している可能性のある不明なアプリをすべて閉じるようユーザーに求める。ユーザーが Close all ボタンをタップすると、そのようなアプリがすべて閉じられます。

UX の例

未知のアクセスリスクを閉じるダイアログ

CLOSE_ALL_ACCESS_RISK（タイプコード 3）

判定に関する問題

environmentDetails.appAccessRiskVerdict.appsDetected に "KNOWN_CAPTURING"、"KNOWN_CONTROLLING"、"UNKNOWN_CAPTURING"、"UNKNOWN_CONTROLLING" のいずれかが含まれている場合、画面をキャプチャしたりデバイスを制御したりする可能性があるアプリがデバイス上で実行されていることを意味します。

改善

CLOSE_ALL_ACCESS_RISK ダイアログを表示して、画面をキャプチャまたはデバイスを制御している可能性のあるアプリをすべて閉じるようユーザーに求めることができます。ユーザーが Close all ボタンをタップすると、デバイス上のそのようなアプリがすべて終了します。

UX の例

すべてのアクセスリスクを閉じるダイアログ

完全性ダイアログをリクエストする

クライアントが完全性トークンをリクエストすると、StandardIntegrityToken（標準 API）と IntegrityTokenResponse（クラシック API）で提供されているメソッド showDialog(Activity activity, int integrityDialogTypeCode) を使用できます。

Play Integrity API を使用して GET_LICENSED ダイアログを表示する手順は次のとおりです。

アプリから完全性トークンをリクエストし、そのトークンをサーバーに送信します。標準リクエストまたはクラシックリクエストを使用できます。

Kotlin

// Request an integrity token
val tokenResponse: StandardIntegrityToken = requestIntegrityToken()
// Send token to app server and get response on what to do next
val yourServerResponse: YourServerResponse = sendToServer(tokenResponse.token())

Java

// Request an integrity token
StandardIntegrityToken tokenResponse = requestIntegrityToken();
// Send token to app server and get response on what to do next
YourServerResponse yourServerResponse = sendToServer(tokenResponse.token());

Unity

// Request an integrity token
StandardIntegrityToken tokenResponse = RequestIntegrityToken();
// Send token to app server and get response on what to do next
YourServerResponse yourServerResponse = sendToServer(tokenResponse.Token);

ネイティブ

/// Request an integrity token
StandardIntegrityToken* response = requestIntegrityToken();
/// Send token to app server and get response on what to do next
YourServerResponse yourServerResponse = sendToServer(StandardIntegrityToken_getToken(response));

サーバーで、完全性トークンを復号し、appLicensingVerdict フィールドを確認します。次のようになります。
```
// Licensing issue
{
  ...
  accountDetails: {
      appLicensingVerdict: "UNLICENSED"
  }
}
```

トークンに appLicensingVerdict: "UNLICENSED" が含まれている場合は、アプリクライアントに返信し、ライセンスダイアログを表示するようリクエストします。

Kotlin

private fun getDialogTypeCode(integrityToken: String): Int{
  // Get licensing verdict from decrypted and verified integritytoken
  val licensingVerdict: String = getLicensingVerdictFromDecryptedToken(integrityToken)

  return if (licensingVerdict == "UNLICENSED") {
          1 // GET_LICENSED
      } else 0
}

Java

private int getDialogTypeCode(String integrityToken) {
  // Get licensing verdict from decrypted and verified integrityToken
  String licensingVerdict = getLicensingVerdictFromDecryptedToken(integrityToken);

  if (licensingVerdict.equals("UNLICENSED")) {
    return 1; // GET_LICENSED
  }
  return 0;
}

Unity

private int GetDialogTypeCode(string IntegrityToken) {
  // Get licensing verdict from decrypted and verified integrityToken
  string licensingVerdict = GetLicensingVerdictFromDecryptedToken(IntegrityToken);

  if (licensingVerdict == "UNLICENSED") {
    return 1; // GET_LICENSED
  }
  return 0;
}

ネイティブ

private int getDialogTypeCode(string integrity_token) {
  /// Get licensing verdict from decrypted and verified integrityToken
  string licensing_verdict = getLicensingVerdictFromDecryptedToken(integrity_token);

  if (licensing_verdict == "UNLICENSED") {
    return 1; // GET_LICENSED
  }
  return 0;
}

アプリで、サーバーから取得したコードを使用して、showDialog を呼び出します。

Kotlin

// Show dialog as indicated by the server
val showDialogType: Int? = yourServerResponse.integrityDialogTypeCode()
if (showDialogType != null) {
  // Call showDialog with type code, the dialog will be shown on top of the
  // provided activity and complete when the dialog is closed.
  val integrityDialogResponseCode: Task<Int> =
  tokenResponse.showDialog(activity, showDialogType)
  // Handle response code, call the Integrity API again to confirm that
  // verdicts have been resolved.
}

Java

// Show dialog as indicated by the server
@Nullable Integer showDialogType = yourServerResponse.integrityDialogTypeCode();
if (showDialogType != null) {
  // Call showDialog with type code, the dialog will be shown on top of the
  // provided activity and complete when the dialog is closed.
  Task<Integer> integrityDialogResponseCode =
      tokenResponse.showDialog(activity, showDialogType);
  // Handle response code, call the Integrity API again to confirm that
  // verdicts have been resolved.
}

Unity

IEnumerator ShowDialogCoroutine() {
  int showDialogType = yourServerResponse.IntegrityDialogTypeCode();

  // Call showDialog with type code, the dialog will be shown on top of the
  // provided activity and complete when the dialog is closed.
  var showDialogTask = tokenResponse.ShowDialog(showDialogType);

  // Wait for PlayAsyncOperation to complete.
  yield return showDialogTask;

  // Handle response code, call the Integrity API again to confirm that
  // verdicts have been resolved.
}

ネイティブ

// Show dialog as indicated by the server
int show_dialog_type = yourServerResponse.integrityDialogTypeCode();
if (show_dialog_type != 0) {
  /// Call showDialog with type code, the dialog will be shown on top of the
  /// provided activity and complete when the dialog is closed.
  StandardIntegrityErrorCode error_code =
      IntegrityTokenResponse_showDialog(response, activity, show_dialog_type);

  /// Proceed to polling iff error_code == STANDARD_INTEGRITY_NO_ERROR
  if (error_code != STANDARD_INTEGRITY_NO_ERROR)
  {
      /// Remember to call the *_destroy() functions.
      return;
  }

  /// Use polling to wait for the async operation to complete.
  /// Note, the polling shouldn't block the thread where the IntegrityManager
  /// is running.

  IntegrityDialogResponseCode* response_code;
  error_code = StandardIntegrityToken_getDialogResponseCode(response, response_code);

  if (error_code != STANDARD_INTEGRITY_NO_ERROR)
  {
      /// Remember to call the *_destroy() functions.
      return;
  }

  /// Handle response code, call the Integrity API again to confirm that
  /// verdicts have been resolved.
}

ダイアログは提供されたアクティビティの上に表示されます。ユーザーがダイアログを閉じると、タスクはレスポンスコードを返して完了します。
（省略可）さらにダイアログを表示するには、別のトークンをリクエストします。標準リクエストを実行する場合は、トークンプロバイダを再度ウォームアップして、新しい判定結果を取得する必要があります。

エラーコードを処理する

その他のツールとサポート