Perbaikan

Halaman ini menjelaskan cara menangani masalah terkait verdict integritas.

Saat token integritas diminta, Anda memiliki opsi untuk menampilkan dialog Google Play kepada pengguna. Anda dapat menampilkan dialog jika ada satu atau beberapa masalah dengan verdict integritas. Dialog akan ditampilkan di bagian atas aplikasi, dan meminta pengguna untuk menyelesaikan penyebab masalah. Setelah dialog ditutup, Anda dapat memverifikasi bahwa masalah telah diperbaiki dengan mengirim permintaan lain ke Integrity API.

Catatan: Semua jenis dialog integritas dapat ditampilkan kepada pengguna, apa pun konten token integritas. Anda harus memeriksa konten token integritas di server untuk menentukan dialog mana yang harus ditampilkan.

Dialog integritas

GET_LICENSED (Kode Jenis 1)

Masalah verdict

Saat appLicensingVerdict == "UNLICENSED". Artinya, akun pengguna tidak berlisensi. Dengan kata lain, mereka tidak menginstal atau membeli aplikasi tersebut dari Google Play.

Perbaikan

Anda dapat menampilkan dialog GET_LICENSED untuk meminta pengguna menginstal aplikasi Anda dari Google Play. Jika pengguna menyetujui permintaan, akun pengguna akan menjadi berlisensi (appLicensingVerdict == "LICENSED"). Aplikasi ditambahkan ke koleksi Google Play pengguna dan Google Play dapat mengirimkan update aplikasi atas nama Anda.

Contoh UX

CLOSE_UNKNOWN_ACCESS_RISK (Kode Jenis 2)

Masalah verdict

Jika environmentDetails.appAccessRiskVerdict.appsDetected berisi "UNKNOWN_CAPTURING" atau "UNKNOWN_CONTROLLING", artinya ada aplikasi tidak dikenal yang berjalan di perangkat yang dapat merekam layar atau mengontrol perangkat.

Perbaikan

Anda dapat menampilkan dialog CLOSE_UNKNOWN_ACCESS_RISK untuk meminta pengguna menutup semua aplikasi tidak dikenal yang dapat merekam layar atau mengontrol perangkat. Jika pengguna mengetuk tombol Close all, semua aplikasi tersebut akan ditutup.

Contoh UX

CLOSE_ALL_ACCESS_RISK (Kode Jenis 3)

Masalah verdict

Jika environmentDetails.appAccessRiskVerdict.appsDetected berisi salah satu dari "KNOWN_CAPTURING", "KNOWN_CONTROLLING","UNKNOWN_CAPTURING", atau "UNKNOWN_CONTROLLING", berarti ada aplikasi yang berjalan di perangkat yang dapat merekam layar atau mengontrol perangkat.

Perbaikan

Anda dapat menampilkan dialog CLOSE_ALL_ACCESS_RISK untuk meminta pengguna menutup semua aplikasi yang dapat merekam layar atau mengontrol perangkat. Jika pengguna mengetuk tombol Close all, semua aplikasi tersebut akan ditutup di perangkat.

Contoh UX

Meminta dialog integritas

Saat klien meminta token integritas, Anda dapat menggunakan metode yang ditawarkan dalamStandardIntegrityToken (API Standar) dan IntegrityTokenResponse (API Klasik): showDialog(Activity activity, int integrityDialogTypeCode).

Catatan: Untuk menggunakan dialog integritas, Anda harus menggunakan library Android Integrity API versi 1.3.0 atau yang lebih tinggi. Fitur ini belum didukung oleh plugin Unity.

Langkah-langkah berikut menguraikan cara menggunakan Play Integrity API untuk menampilkan dialog GET_LICENSED:

1. Minta token integritas dari aplikasi Anda, lalu kirim token tersebut ke server Anda. Anda dapat menggunakan permintaan Standar atau Klasik.

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

   Native

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

2. Di server, dekripsi token integritas dan periksa kolom appLicensingVerdict. Token akan tampak seperti berikut:

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

3. Jika token berisi appLicensingVerdict: "UNLICENSED", balas klien aplikasi Anda dengan memintanya menampilkan dialog pemberian lisensi:

   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;
   } 

   Native

   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;
   }

4. Di aplikasi Anda, panggil showDialog dengan kode yang diminta yang diambil dari server Anda:

   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.
   } 

   Native

   // 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.
   }

5. Dialog ditampilkan di atas aktivitas yang disediakan. Saat pengguna menutup dialog, Tugas akan selesai dengan kode respons.

6. (Opsional) Minta token lain untuk menampilkan dialog lebih lanjut. Jika membuat permintaan standar, Anda harus melakukan persiapan ulang penyedia token untuk mendapatkan verdict baru.