Mendeteksi penyalahgunaan berulang menggunakan pengambilan data spesifik perangkat (beta)

Halaman ini menjelaskan cara menggunakan pengambilan data spesifik perangkat untuk menyimpan dan mengambil data kustom dengan perangkat tertentu. Anda dapat memanggil kembali data kustom tersebut secara akurat di lain waktu saat aplikasi Anda diinstal di perangkat yang sama, bahkan setelah perangkat direset. Dengan fitur ini, Anda dapat mendeteksi dan mencegah perangkat digunakan kembali berdasarkan tindakan atau perilaku yang Anda tentukan, sekaligus menjaga privasi pengguna.

Bagaimana cara kerja pengambilan data spesifik perangkat?

Pengambilan data spesifik perangkat memberi aplikasi kemampuan untuk menyimpan dan mengambil 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 Anda secara akurat, bahkan setelah aplikasi diinstal ulang atau perangkat direset. Misalnya, Anda dapat menggunakan fitur ini untuk menarik perangkat yang menunjukkan 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 terkait dengan perangkat, tanpa mengakses ID perangkat atau pengguna. Setelah mengaktifkan pengambilan data spesifik 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 arti Anda sendiri untuk nilai-nilai ini; misalnya, Anda dapat memperlakukan nilai sebagai tiga flag terpisah atau Anda dapat 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 pengambilan data spesifik perangkat

Pengambilan data spesifik perangkat hanya boleh digunakan untuk menyimpan dan mengambil informasi guna melindungi keamanan aplikasi serta untuk memitigasi penyalahgunaan, penipuan, dan akses tidak sah. Anda tidak boleh menggunakan pengambilan data spesifik perangkat untuk membuat sidik jari atau melacak pengguna atau perangkat individual dan Anda tidak boleh menggunakan pengambilan data spesifik perangkat untuk melacak karakteristik pengguna atau perangkat yang sensitif seperti gender, usia, atau data lokasi.

Pengambilan data spesifik perangkat memiliki prasyarat berikut:

  • Pengambilan data spesifik perangkat dapat digunakan di ponsel, tablet, perangkat foldable, TV, Auto, dan Wear OS. Di Wear, pengambilan data spesifik perangkat hanya tersedia di perangkat yang dilengkapi dengan Wear OS 5 atau yang lebih tinggi. Pengambilan data spesifik perangkat tidak didukung di emulator.
  • Pengambilan data spesifik perangkat mengharuskan versi terbaru Google Play Store dan layanan Google Play diinstal dan diaktifkan di perangkat.
  • Pengambilan data spesifik perangkat mengharuskan akun pengguna memiliki lisensi Play. Jika tidak, verdict tidak akan dievaluasi.

Pengambilan data spesifik perangkat memiliki pertimbangan waktu berikut:

  • Setelah memverifikasi token integritas, Anda memiliki waktu hingga 14 hari untuk menggunakannya guna menyimpan data pengambilan data spesifik perangkat kustom.
  • Pengambilan data spesifik perangkat menyertakan stempel waktu sehingga Anda dapat menganggap data yang baru diubah sebagai prioritas yang lebih tinggi daripada data yang diubah lama sebelumnya. Pertimbangkan untuk mengabaikan atau mereset data setelah jangka waktu yang cukup lama untuk memperhitungkan bahwa perangkat dapat berpindah tangan atau diperbarui dan dijual kembali.
  • Bit pengambilan 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 false. Tindakan ini akan otomatis mereset stempel waktu.

Untuk developer dengan beberapa aplikasi dan developer yang mentransfer aplikasi, pengambilan data spesifik 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, pengambilan data spesifik 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 pengambilan data spesifik perangkat di Konsol Play:

  1. Login ke Konsol Play.
  2. Pilih aplikasi yang akan menggunakan pengambilan data spesifik perangkat.
  3. Buka Dilindungi dengan Google Play dari menu kiri.
  4. Di samping Play Integrity API, klik Kelola.
  5. Di bagian Respons pada halaman, klik Ubah respons.
  6. Aktifkan Pengambilan data spesifik perangkat.
  7. Klik Simpan perubahan.

Saat Anda mengaktifkan atau menonaktifkan pengambilan data spesifik perangkat, respons pengujian Play Integrity API yang telah Anda siapkan di Konsol Play akan dihapus dan Anda perlu membuatnya lagi.

Membaca nilai pengambilan data spesifik perangkat

Pengambilan data spesifik perangkat berfungsi dalam permintaan klasik dan standar Play Integrity API. Dalam permintaan standar, pengambilan data spesifik perangkat diperbarui dalam panggilan warmup. Dengan kata lain, setelah mengubah data per perangkat, Anda harus melakukan pemanasan lagi untuk melihat nilai yang diperbarui. Setelah pengambilan data spesifik perangkat diaktifkan, Anda akan dapat membaca nilai pengambilan data spesifik perangkat dalam verdict integritas.

Mengubah nilai pengambilan data spesifik perangkat

Anda dapat mengubah nilai pengambilan data spesifik perangkat dengan melakukan panggilan API server ke server yang mirip dengan pendekodean 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 tidak akan berubah. Ada sedikit penundaan propagasi antara penulisan bit dan kemampuan untuk membacanya kembali dalam verdict. Penundaan ini dapat berlangsung hingga 30 detik, meskipun umumnya jauh lebih singkat. Permintaan tulis pengambilan data spesifik perangkat harus lebih jarang daripada permintaan token integritas. Penginstalan tersebut tidak diperhitungkan dalam kuota permintaan token integritas, tetapi tunduk pada batas kapasitas yang terpisah.

playintegrity.googleapis.com/v1/PACKAGE_NAME/deviceRecall:write -d \
'{
  "integrityToken": "INTEGRITY_TOKEN",
  "newValues": {
    "bitFirst": true,
    "bitThird": false
  }
}'
newValues.BitFirst = true // ForceSendFields optional for value true
newValues.BitSecond = false // ForceSendFields required for value false
newValues.BitThird = nil // do not set ForceSendFields for unspecified bits
newValues.ForceSendFields = []string{"BitSecond"}