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.
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
Ketika environmentDetails.appAccessRiskVerdict.appsDetected
berisi
"UNKNOWN_CAPTURING"
atau "UNKNOWN_CONTROLLING"
, artinya ada data yang tidak diketahui
aplikasi 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 yang 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
Ketika environmentDetails.appAccessRiskVerdict.appsDetected
berisi salah satu dari
"KNOWN_CAPTURING"
, "KNOWN_CONTROLLING"
,"UNKNOWN_CAPTURING"
atau
"UNKNOWN_CONTROLLING"
, artinya ada aplikasi yang berjalan di perangkat yang
dapat berupa 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 pada
perangkat seluler.
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)
.
Langkah-langkah berikut menguraikan cara menggunakan Play Integrity API untuk menampilkan dialog GET_LICENSED:
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());
Di server, dekripsi token integritas dan periksa kolom
appLicensingVerdict
. Token akan tampak seperti berikut:// Licensing issue { ... accountDetails: { appLicensingVerdict: "UNLICENSED" } }
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; }
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. }
Dialog ditampilkan di atas aktivitas yang disediakan. Saat pengguna menutup dialog, Tugas akan selesai dengan kode respons.
(Opsional) Minta token lain untuk menampilkan dialog lebih lanjut. Jika membuat permintaan standar, Anda harus melakukan persiapan ulang penyedia token untuk mendapatkan verdict baru.