Halaman ini menjelaskan cara menggunakan recall perangkat untuk menyimpan dan mengambil data kustom dengan perangkat tertentu. Anda dapat mengambil data kustom lagi nanti dengan andal saat aplikasi diinstal di perangkat yang sama, bahkan setelah perangkat direset. Dengan begitu, Anda dapat mendeteksi dan mencegah perangkat digunakan kembali berdasarkan tindakan atau perilaku yang Anda tentukan, sekaligus menjaga privasi pengguna.
Bagaimana cara kerja penarikan perangkat?
Panggilan kembali perangkat memberi aplikasi kemampuan untuk menyimpan dan memanggil kembali data kustom yang terkait dengan perangkat tertentu tanpa mengorbankan privasi pengguna. Data tersebut disimpan di server Google, sehingga aplikasi Anda dapat memanggil kembali data kustom secara akurat, bahkan setelah aplikasi diinstal ulang atau perangkat direset. Misalnya, Anda dapat menggunakan fitur ini untuk menarik perangkat tempat Anda menemukan bukti penyalahgunaan berat, perangkat yang telah menukarkan item bernilai tinggi (seperti uji coba gratis), atau perangkat yang digunakan berulang kali untuk membuat akun baru untuk tujuan penyalahgunaan. Pengambilan data spesifik perangkat menjaga privasi pengguna karena aplikasi yang memintanya hanya dapat mengambil data terbatas yang dikaitkan dengan perangkat, tanpa mengakses ID perangkat atau pengguna apa pun. Setelah mengaktifkan recall perangkat, Anda dapat melakukan hal berikut:
- Membaca data per perangkat: Anda dapat membaca tiga nilai kustom atau bit untuk setiap perangkat saat Anda mendapatkan verdict integritas. Anda dapat menentukan makna Anda sendiri untuk nilai ini; misalnya, Anda dapat memperlakukan nilai sebagai tiga tanda terpisah atau menggabungkannya untuk mewakili delapan label kustom.
- Mengubah data per perangkat: Setelah mendapatkan token integritas, Anda dapat menggunakan token tersebut untuk melakukan panggilan sisi server ke server Google Play guna mengubah satu atau beberapa nilai. Anda memiliki waktu hingga 14 hari untuk menggunakan token. Hal ini memungkinkan Anda mengubah nilai jika, misalnya, penyalahgunaan hanya terlihat dalam periode dua minggu setelah Anda pertama kali melakukan pemeriksaan integritas. Saat Anda mengubah nilai, bulan dan tahun saat perubahan dilakukan juga akan disimpan.
Prasyarat dan pertimbangan penarikan perangkat
Recall perangkat hanya dapat digunakan untuk menyimpan dan mengingat informasi guna melindungi keamanan aplikasi dan memitigasi penyalahgunaan, penipuan, dan akses tidak sah. Anda tidak boleh menggunakan pengingat perangkat untuk mengambil sidik jari atau melacak setiap pengguna atau perangkat dan Anda tidak boleh menggunakan pengingat perangkat untuk melacak karakteristik pengguna atau perangkat sensitif seperti data gender, usia, atau lokasi.
Penarikan perangkat memiliki prasyarat berikut:
- Recall perangkat dapat digunakan di ponsel, tablet, perangkat foldable, TV, Auto, dan Wear OS. Di Wear, recall perangkat hanya tersedia di perangkat yang dilengkapi dengan Wear OS 5 atau yang lebih tinggi. Pengingat perangkat tidak didukung di emulator.
- Recall perangkat mengharuskan versi terbaru layanan Google Play Store dan Google Play diinstal dan diaktifkan di perangkat.
- Recall perangkat mengharuskan akun pengguna memiliki lisensi Play. Jika tidak, verdict tidak akan dievaluasi.
Penarikan perangkat memiliki pertimbangan waktu berikut:
- Setelah memverifikasi token integritas, Anda memiliki waktu hingga 14 hari untuk menggunakannya untuk menyimpan data recall perangkat kustom.
- Recall perangkat menyertakan stempel waktu sehingga Anda dapat mempertimbangkan data yang baru saja diubah sebagai prioritas yang lebih tinggi daripada data yang diubah sejak lama. Pertimbangkan untuk mengabaikan atau mereset data setelah jangka waktu yang cukup lama untuk mempertimbangkan bahwa perangkat dapat berpindah tangan atau diperbaiki dan dijual kembali.
- Bit recall untuk perangkat akan disimpan selama 3 tahun setelah akses baca atau tulis terakhir.
- Jika Anda perlu menghapus semua data yang terkait dengan perangkat, aplikasi Anda dapat mereset ketiga nilai di perangkat tersebut ke salah (false). Tindakan ini akan otomatis mereset stempel waktu.
Untuk developer dengan beberapa aplikasi dan developer yang mentransfer aplikasi, recall perangkat berfungsi sebagai berikut:
- Semua aplikasi di akun developer Google Play Anda memiliki akses ke tiga nilai yang sama per perangkat. Dengan kata lain, jika salah satu aplikasi Anda mengubah salah satu nilai, semua aplikasi Anda akan membaca nilai yang diubah saat diinstal di perangkat yang sama.
- Jika aplikasi ditransfer dari satu akun developer ke akun developer lain, recall perangkat akan mencerminkan data per perangkat akun developer baru, bukan data per perangkat akun developer lama.
Mengaktifkan pengambilan data spesifik perangkat
Jika sudah siap, aktifkan recall perangkat di Konsol Play:
- Login ke Konsol Play.
- Pilih aplikasi yang akan menggunakan recall perangkat.
- Di bagian Rilis pada menu kiri, buka Integritas aplikasi.
- Di samping Play Integrity API, klik Setelan.
- Di bagian Respons pada halaman, klik Ubah respons.
- Aktifkan Panggilan balik perangkat.
- Klik Simpan perubahan.
Saat Anda mengaktifkan atau menonaktifkan penarikan perangkat, respons pengujian Play Integrity API yang telah Anda siapkan di Konsol Play akan dihapus dan Anda perlu membuatnya lagi.
Membaca nilai penarikan perangkat
Penarikan perangkat berfungsi dalam permintaan klasik dan standar Play Integrity API. Dalam permintaan standar, recall perangkat dimuat ulang dalam panggilan pemanasan. Dengan kata lain, setelah mengubah data per perangkat, Anda harus melakukan pemanasan lain untuk melihat nilai yang diperbarui. Setelah penarikan perangkat diaktifkan, Anda akan dapat membaca nilai penarikan perangkat dalam verdict integritas.
Mengubah nilai recall perangkat
Anda dapat mengubah nilai recall perangkat dengan melakukan panggilan API server ke server
yang mirip dengan mendekode verdict integritas. Menetapkan
bit ke true juga akan memperbarui tanggal penulisannya (meskipun sudah true).
Menetapkan bit ke false akan mereset tanggal penulisannya menjadi kosong. Setiap bit yang
tidak ditentukan dalam permintaan akan tetap tidak berubah. Ada penundaan penyebaran
kecil antara menulis bit dan dapat membacanya kembali dalam verdict. Penundaan
ini dapat berlangsung hingga 30 detik, meskipun biasanya jauh lebih singkat. Permintaan
tulis recall perangkat harus lebih jarang daripada permintaan token integritas
Anda. Permintaan tersebut tidak dihitung dalam kuota permintaan token integritas Anda, tetapi
tunduk pada batas kapasitas defensif non-publik.
playintegrity.googleapis.com/v1/PACKAGE_NAME/deviceRecall:write -d \
'{
"integrityToken": "INTEGRITY_TOKEN",
"newValues": {
"bitFirst": true,
"bitThird": false
}
}'