Halaman ini menjelaskan cara menyiapkan aplikasi atau game untuk menggunakan Play Integrity API. Anda harus mengaktifkan respons dari API, lalu perlu mengintegrasikan API ke aplikasi dan server backend aplikasi Anda. Pelaporan, fitur pengujian, dan opsi konfigurasi tambahan tersedia setelah Anda menautkan project Google Cloud yang Anda gunakan untuk Play Integrity API di Konsol Google Play.
Mengaktifkan respons Play Integrity API
Setiap aplikasi atau SDK yang memanggil Play Integrity API harus memanfaatkan project Google Cloud untuk memantau penggunaan API. Aplikasi di Google Play dapat menautkan project Cloud di Konsol Google Play untuk mengaktifkan respons Play Integrity API. Jika ingin membuat project Cloud baru atau aplikasi Anda didistribusikan secara eksklusif di luar Google Play, Anda dapat mengaktifkan respons Play Integrity API dari Konsol Google Cloud.
Menyiapkan di Konsol Google Play (direkomendasikan)
Dengan mengaktifkan respons Play Integrity API di Konsol Google Play, Anda akan mendapatkan akses ke pelaporan API, fitur pengujian, dan opsi konfigurasi tambahan. Opsi ini hanya tersedia untuk aplikasi yang didistribusikan di Google Play. Buka Rilis > Integritas aplikasi. Di bagian Play Integrity API, pilih Tautkan project Cloud. Pilih project Cloud yang ingin ditautkan ke aplikasi Anda dan tindakan ini akan mengaktifkan respons Play Integrity API. Sekarang Anda dapat mengintegrasikan Play Integrity API ke dalam aplikasi.
Menyiapkan di Konsol Google Cloud
Di Konsol Google Cloud, buat project Cloud baru atau pilih project Cloud yang sudah ada dan ingin Anda gunakan dengan Play Integrity API. Buka APIs and services. Pilih enable APIs and services. Cari Play Integrity API, lalu enable. Sekarang Anda dapat mengintegrasikan Play Integrity API ke dalam aplikasi Anda.
Menyiapkan petunjuk untuk penyedia SDK
Penyedia SDK harus menggunakan project Google Cloud mereka sendiri untuk memanggil Play Integrity API, sehingga penggunaan API diatribusikan ke SDK, bukan ke masing-masing aplikasi yang menggunakan SDK. Artinya, aplikasi yang menggunakan SDK Anda tidak perlu menyiapkan Play Integrity API, dan permintaan Anda ke Play Integrity API akan otomatis mengurangi penggunaan API SDK Anda.
Anda dapat mengaktifkan respons Play Integrity API dari Konsol Google Cloud. Di Konsol Google Cloud, buat project Cloud baru atau pilih project Cloud yang sudah ada dan ingin Anda gunakan dengan Play Integrity API. Buka APIs and services. Pilih enable APIs and services. Cari Play Integrity API, lalu enable. Sekarang Anda dapat mengintegrasikan Play Integrity API ke dalam SDK.
Penyedia SDK yang ingin meningkatkan permintaan harian maksimum mereka harus melengkapi
formulir permintaan
kuota. Dalam
komentar opsional, nyatakan bahwa Anda membuat permintaan peningkatan
untuk SDK, dan sertakan koordinat Maven (groupId:artifactId) atau URL
ke SDK Anda.
Meningkatkan permintaan Play Integrity API harian
Aplikasi Anda akan tunduk pada jumlah maksimum 10.000 total permintaan per aplikasi per hari. Anda dapat meminta untuk meningkatkan jumlah maksimum harian ini jika aplikasi perlu menangani peningkatan jumlah pengguna dengan mengikuti petunjuk di bawah.
Meningkatkan jumlah maksimum permintaan harian Anda
Agar memenuhi syarat untuk meningkatkan jumlah maksimum permintaan klasik harian, aplikasi Anda harus tersedia di Google Play selain saluran distribusi lainnya. Jika aplikasi Anda membuat permintaan klasik, meskipun dengan jumlah maksimum harian yang ditingkatkan, Anda harus terus membatasi panggilan API per pengguna menjadi tindakan yang jarang dan bernilai tinggi untuk menghemat baterai dan data pengguna.
Untuk meminta peningkatan jumlah maksimum permintaan harian, lakukan hal berikut:
- Tautkan project Google Cloud yang Anda gunakan untuk Play Integrity API di Konsol Play.
- Pastikan Anda mengimplementasikan logika API dengan benar, termasuk strategi coba lagi yang direkomendasikan.
- Minta penambahan kuota menggunakan formulir ini.
Diperlukan waktu hingga satu minggu untuk meningkatkan kuota Play Integrity API. Jadi. sebaiknya Anda memantau penggunaan Play Integrity API di Konsol Google Play atau di Konsol Google Cloud, tempat Anda juga dapat menetapkan peringatan kuota untuk menghindari gangguan pada layanan Anda.
Peningkatan kuota permintaan klasik akan otomatis diterapkan ke panggilan klien untuk membuat token integritas dan panggilan server untuk mendekripsi dan memverifikasi token integritas. Peningkatan kuota permintaan standar diterapkan ke panggilan server untuk mendekripsi dan memverifikasi token integritas.
Mengintegrasikan Play Integrity API ke dalam aplikasi Anda
Untuk mengintegrasikan Play Integrity API ke dalam aplikasi atau SDK Anda, lakukan salah satu hal berikut, bergantung pada lingkungan pengembangan Anda:
Kotlin atau Java
Library Android terbaru untuk Play Integrity API tersedia dari
Repositori Maven
Google.
Tambahkan dependensi berikut ke file build.gradle aplikasi Anda:
implementation 'com.google.android.play:integrity:1.2.0'
Unity
Instal Plugin Google Play Integrity untuk Unity 1.1.0 atau yang lebih tinggi. Untuk mengetahui petunjuknya, lihat cara menginstal paket Google untuk Unity.
- Semua versi 2019.x, 2020.x, dan yang lebih baru didukung.
- Jika Anda menggunakan Unity 2018.x, versi 2018.4 atau yang lebih baru didukung.
- Jika Anda menggunakan Unity 2017.x, versi 2017.4 atau yang lebih baru didukung.
- Unity 5.x dan yang lebih lama tidak didukung.
Native
Instal Play Core Native SDK 1.12.1 atau yang lebih tinggi. Untuk mengetahui petunjuknya, lihat panduan penyiapan lingkungan pengembangan Play Core Native.
Mengonfigurasi respons API (opsional)
Respons API berikut ditampilkan dalam respons Play Integrity API secara default:
| Respons API | Label | Deskripsi |
|---|---|---|
| Integritas perangkat | MEETS_DEVICE_INTEGRITY |
Aplikasi berjalan di perangkat Android yang didukung oleh layanan Google Play. Perangkat lulus pemeriksaan integritas sistem dan memenuhi persyaratan kompatibilitas Android. |
| Tanpa label (nilai kosong) | Aplikasi berjalan di perangkat yang memiliki tanda-tanda serangan (seperti hooking API) atau penyusupan sistem (seperti di-root), atau aplikasi tidak berjalan di perangkat fisik (seperti emulator yang tidak lulus pemeriksaan integritas Google Play). | |
| Detail akun | LICENSED |
Pengguna memiliki hak aplikasi. Dengan kata lain, pengguna menginstal atau membeli aplikasi Anda di Google Play. Pengguna tetap memiliki hak aplikasi setelah meng-uninstal aplikasi, sehingga akun pengguna akan tetap memiliki lisensi jika nanti pengguna mendapatkan aplikasi yang sama dengan cara lain. |
UNLICENSED |
Pengguna tidak memiliki hak aplikasi. Hal ini terjadi saat, misalnya, pengguna melakukan sideload pada aplikasi Anda atau tidak menginstalnya dari Google Play. | |
UNEVALUATED |
Detail pemberian lisensi tidak dievaluasi karena persyaratan tidak terpenuhi. Hal ini dapat terjadi karena beberapa alasan, termasuk:
|
|
| Integritas aplikasi | PLAY_RECOGNIZED |
Aplikasi dan sertifikat cocok dengan versi yang didistribusikan oleh Google Play. |
UNRECOGNIZED_VERSION |
Nama paket atau sertifikat tidak cocok dengan data Google Play. | |
UNEVALUATED |
Integritas aplikasi tidak dievaluasi. Persyaratan yang diperlukan tidak terpenuhi, seperti perangkat tidak cukup tepercaya. |
Di Konsol Play, Anda dapat memilih untuk menerima respons API tambahan berikut:
| Respons API | Label | Deskripsi |
|---|---|---|
| Integritas perangkat | MEETS_BASIC_INTEGRITY |
Aplikasi berjalan di perangkat yang telah lulus pemeriksaan integritas sistem dasar. Perangkat mungkin tidak memenuhi persyaratan kompatibilitas Android dan mungkin tidak disetujui untuk menjalankan layanan Google Play. Misalnya, perangkat mungkin menjalankan versi Android yang tidak dikenal, mungkin memiliki bootloader yang tidak terkunci, atau mungkin belum disertifikasi oleh produsen. |
MEETS_STRONG_INTEGRITY |
Aplikasi tersebut berjalan di perangkat Android yang didukung oleh layanan Google Play dan memiliki jaminan kuat atas integritas sistem seperti bukti integritas booting yang didukung hardware. Perangkat lulus pemeriksaan integritas sistem dan memenuhi persyaratan kompatibilitas Android. |
Setelah memilih untuk menerima label tambahan, respons integritas akan
menyertakan beberapa label untuk perangkat yang sama jika setiap kriteria label
terpenuhi. Anda dapat mempersiapkan server backend untuk berperilaku lain, bergantung pada
rentang kemungkinan respons. Misalnya, perangkat yang menampilkan
MEETS_STRONG_INTEGRITY, MEETS_DEVICE_INTEGRITY, dan MEETS_BASIC_INTEGRITY
dapat lebih dipercaya daripada perangkat yang hanya menampilkan MEETS_BASIC_INTEGRITY dan
cara server Anda merespons dapat disesuaikan dengan tepat.
Jika mendistribusikan aplikasi ke Google Play Game untuk PC, Anda akan otomatis diikutsertakan untuk menerima respons API berikut:
| Respons API | Label | Deskripsi |
|---|---|---|
| Integritas perangkat | MEETS_VIRTUAL_INTEGRITY |
Aplikasi berjalan di Android emulator yang didukung oleh layanan Google Play. Emulator lulus pemeriksaan integritas sistem dan memenuhi persyaratan kompatibilitas inti Android. |
Untuk mengubah respons API Anda, buka Konsol Play, lalu buka Rilis > Integritas aplikasi. Di bagian Respons, edit dan simpan perubahan Anda. Opsi ini hanya tersedia untuk aplikasi yang tersedia di Google Play, dan memerlukan penautan project Cloud yang Anda gunakan dengan Play Integrity API di Konsol Play.
Mengonfigurasi setelan permintaan klasik (opsional)
Lewati bagian ini jika Anda hanya berencana untuk membuat permintaan API standar.
Saat Anda membuat permintaan klasik, secara default, server Google Play akan mengelola enkripsi respons yang digunakan aplikasi Anda saat Anda berinteraksi dengan Play Integrity API. Meskipun sebaiknya Anda menggunakan opsi default ini, Anda juga dapat memilih untuk mengelola dan mendownload kunci enkripsi respons dengan mengikuti petunjuk di bawah ini.
Mengizinkan Google mengelola enkripsi respons (default dan direkomendasikan)
Untuk melindungi keamanan aplikasi, sebaiknya Anda mengizinkan Google membuat dan mengelola kunci enkripsi respons. Server backend Anda akan memanggil server Google Play untuk mendekripsi respons.
Mengelola dan mendownload kunci enkripsi respons
Jika ingin mendekripsi verdict integritas secara lokal dalam lingkungan server yang aman, Anda dapat mengelola dan mendownload kunci enkripsi respons. Untuk mengelola dan mendownload kunci enkripsi respons, Anda harus menggunakan Konsol Play, dan aplikasi Anda harus tersedia di Google Play selain di saluran distribusi lainnya. Ikuti petunjuk di bawah untuk beralih dari kunci enkripsi respons yang dikelola Google ke kunci yang dikelola sendiri.
Perlu diingat untuk tidak mendekripsi atau memverifikasi token yang diterima dari dalam aplikasi klien, dan jangan pernah menampilkan kunci dekripsi apa pun ke aplikasi klien.
Sebelum mengubah strategi pengelolaan enkripsi respons di Konsol Play, pastikan server Anda dikonfigurasi dengan benar untuk mendekripsi dan memverifikasi token integritas di server Google Play guna menghindari gangguan.
Beralih antara kunci enkripsi respons yang dikelola Google dan dikelola sendiri
Jika saat ini Google mengelola enkripsi respons, dan Anda ingin beralih untuk mengelola dan mendownload kunci enkripsi respons sendiri, ikuti langkah-langkah berikut:
- Login ke Konsol Play.
- Pilih aplikasi yang menggunakan Play Integrity API.
- Di bagian Rilis pada menu kiri, buka Integritas aplikasi.
- Di samping Play Integrity API, klik Setelan.
- Di bagian Permintaan klasik halaman, di samping Enkripsi respons, klik Edit.
- Di jendela yang muncul, klik Kelola dan download kunci enkripsi respons saya.
- Ikuti petunjuk cara mengupload kunci publik.
- Setelah jendela menunjukkan bahwa upload berhasil, klik Simpan dan kunci yang dienkripsi akan didownload secara otomatis.
- Ubah logika server agar Anda dapat mendekripsi dan memverifikasi token integritas secara lokal, di lingkungan server Anda yang aman, menggunakan kunci enkripsi respons Anda.
- (Opsional) Jika mengelola sendiri kunci enkripsi respons, aplikasi Anda masih dapat melakukan penggantian ke server Google Play untuk mendekripsi dan memverifikasi respons.
Jika Anda mengelola sendiri kunci enkripsi respons dan ingin beralih agar Google mengelola enkripsi respons Anda, ikuti langkah-langkah berikut:
- Ubah logika server Anda agar Anda hanya mendekripsi dan memverifikasi di server Google.
- Login ke Konsol Play.
- Pilih aplikasi yang menggunakan Play Integrity API.
- Di bagian Rilis pada menu kiri, buka Integritas aplikasi.
- Di samping Play Integrity API, klik Setelan.
- Di bagian Permintaan klasik halaman, di samping Enkripsi respons, klik Edit.
- Di jendela yang muncul, klik Izinkan Google mengelola enkripsi respons saya (direkomendasikan).
- Klik Simpan perubahan.