修復

本頁面說明如何處理完整性判定結果的問題。

在要求提供完整性權杖時，您可以選擇向使用者顯示 Google Play 對話方塊。如果完整性判定結果出現一或多個問題，您就可以顯示這個對話方塊。對話方塊會顯示在應用程式頂端，並提示使用者解決問題。對話方塊關閉後，您可以向 Integrity API 提出另一項要求，驗證問題是否已修正。

注意：無論完整性權杖的內容為何，可向使用者顯示的完整性對話方塊類型都沒有硬性規定。您應檢查伺服器上的完整性權杖內容，藉此判斷應顯示哪種對話方塊。

完整性對話方塊

GET_LICENSED (類型代碼 1)

判定結果問題

發生 appLicensingVerdict == "UNLICENSED" 的情形。這表示使用者帳戶未經授權。也就是說，他們不是從 Google Play 安裝或購買應用程式。

修復

您可以顯示 GET_LICENSED 對話方塊，提示使用者利用 Google Play 取得應用程式。如果使用者接受，使用者帳戶就會獲得授權 (appLicensingVerdict == "LICENSED")。系統會將應用程式新增至使用者的 Google Play 程式庫，而 Google Play 可代您提供應用程式更新。

使用者體驗範例

CLOSE_UNKNOWN_ACCESS_RISK (類型代碼 2)

判定結果問題

當 environmentDetails.appAccessRiskVerdict.appsDetected 包含 "UNKNOWN_CAPTURING" 或 "UNKNOWN_CONTROLLING"，表示其中不明 於裝置上執行的應用程式可以擷取螢幕畫面， 控制裝置

修復

您可以顯示 CLOSE_UNKNOWN_ACCESS_RISK 對話方塊，提示使用者關閉 可能擷取螢幕畫面或控制裝置的不明應用程式。 如果使用者輕觸 Close all 按鈕，這類應用程式都會關閉。

使用者體驗範例

CLOSE_ALL_ACCESS_RISK (類型代碼 3)

判定結果問題

當 environmentDetails.appAccessRiskVerdict.appsDetected 包含任一 "KNOWN_CAPTURING"、"KNOWN_CONTROLLING"、"UNKNOWN_CAPTURING"或 "UNKNOWN_CONTROLLING"，表示裝置上有執行中的應用程式 可能是擷取螢幕畫面或控制裝置

修復

您可以顯示 CLOSE_ALL_ACCESS_RISK 對話方塊，提示使用者關閉全部 找出可能擷取螢幕畫面或控制裝置的應用程式。 如果使用者輕觸 Close all 按鈕，這類應用程式都會關閉 裝置。

使用者體驗範例

要求完整性對話方塊

當用戶端要求完整性權杖時，您可以使用 StandardIntegrityToken (標準 API) 和 IntegrityTokenResponse (傳統 API) 中提供的方法： showDialog(Activity activity, int integrityDialogTypeCode)。

注意：如要使用完整性對話方塊，您必須使用 Integrity API Android 程式庫 1.3.0 以上版本。Play Core 原生 SDK 和 Unity 外掛程式尚未支援此功能。

下列步驟概述如何使用 Play Integrity API 顯示「GET_LICENSED」對話方塊：

1. 透過應用程式要求完整性權杖，然後將權杖傳送至伺服器。使用「標準」或「傳統」要求都可以。

   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());
   

2. 在伺服器上解密完整性權杖，然後檢查 appLicensingVerdict 欄位。如下所示：

   // Licensing issue
   {
     ...
     accountDetails: {
       appLicensingVerdict: "UNLICENSED"
     }
   }
   

3. 如果權杖包含 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;
   }
   

4. 從伺服器擷取要求的程式碼後，在應用程式中使用該程式碼呼叫 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: TaskI<nt >=
       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.
     TaskI<nteger >integrityDialogResponseCode =
         tokenResponse.showDialog(activity, showDialogType);
     // Handle response code, call the Integrity API again to confirm that
     // verdicts have been resolved.
   }
   

5. 對話方塊會顯示在系統提供的活動頂端。使用者關閉對話方塊後，工作就會完成，並顯示回應代碼。

6. (選用) 要求其他權杖，以便顯示任何後續對話方塊。如果您提出標準要求，需再次替權杖供應工具暖機，才能取得最新判定結果。