Kunci seluler di reCAPTCHA memungkinkan Anda mengonfigurasi identitas aplikasi dan parameter risiko untuk deployment Android dan iOS. Buat kunci seluler khusus untuk membantu mengamankan komunikasi klien-server dan mencegah traffic bot otomatis di aplikasi seluler.
Kunci reCAPTCHA merepresentasikan cara reCAPTCHA dikonfigurasi untuk aplikasi seluler.
Sebelum memulai
- Menyiapkan lingkungan Anda untuk Google Cloud Fraud Defense.
- Pastikan Anda memiliki peran Identity and Access Management berikut: Admin reCAPTCHA Enterprise (
roles/recaptchaenterprise.admin).
Membuat kunci reCAPTCHA
Anda hanya dapat membuat kunci berbasis skor untuk aplikasi seluler.
Sebaiknya lakukan hal berikut saat membuat kunci reCAPTCHA untuk aplikasi seluler:
- Buat satu kunci reCAPTCHA untuk setiap aplikasi seluler.
Untuk Android, buat kunci terpisah untuk skenario berikut:
- Paket Android hanya tersedia di Google Play Store.
- Paket Android hanya tersedia di app store non-Google Play Store.
Buat kunci reCAPTCHA terpisah untuk lingkungan staging dan produksi. Jika tidak, Anda berisiko mengotori analisis risiko reCAPTCHA dengan data dari lingkungan pengujian Anda.
Cara termudah untuk membuat kunci reCAPTCHA adalah melalui konsolGoogle Cloud . Atau, Anda dapat menggunakan reCAPTCHA Enterprise API atau Google Cloud CLI.
Konsol
Di konsol Google Cloud , buka halaman Google Cloud Fraud Defense.
Pastikan nama project Anda muncul di pemilih resource di bagian atas halaman.
Jika tidak melihat nama project, klik pemilih resource, lalu pilih project Anda.
- Pilih tab Keys.
- Klik Create key.
- Di kolom Display name, masukkan nama tampilan untuk kunci.
- Bergantung pada jenis kunci reCAPTCHA yang ingin Anda buat untuk aplikasi seluler, lakukan tindakan yang sesuai:
- Untuk Application type, pilih iOS.
- Di bagian daftar ID paket iOS, klik Tambahkan ID paket iOS.
Di kolom Bundle ID, masukkan nama ID paket iOS Anda.
- Opsional: Untuk menambahkan ID paket tambahan, klik Add iOS bundle ID, lalu masukkan nama ID paket iOS Anda di kolom Bundle ID.
- Untuk melindungi kunci reCAPTCHA untuk ID paket Anda, pastikan tombol
Nonaktifkan verifikasi ID paket dinonaktifkan. Jika Anda menonaktifkan verifikasi ID paket, Anda harus memverifikasi kolom
tokenProperties.iosBundleIddalam penilaian yang Anda buat. Opsional: Berikan Apple Developer settings.
Sebaiknya berikan data ini karena memungkinkan Fraud Defense memberikan penilaian risiko yang lebih akurat untuk traffic Anda.
Masukkan informasi berikut:
- Kunci pribadi (.p8): Kunci ini dibuat di Apple Pusat Developer di bagian Certificates, Identifiers & Profiles.
- ID kunci: ID kunci developer Apple (string 10 karakter).
- ID Tim: ID tim Apple (string 10 karakter) yang memiliki profil penyediaan yang digunakan untuk membangun aplikasi Anda.
- Opsional: Klik Langkah Berikutnya (opsional).
-
Untuk lingkungan non-produksi, jika Anda ingin menentukan skor yang Anda inginkan untuk ditampilkan oleh kunci saat penilaian dibuat untuknya, lakukan hal berikut:
- Di Additional settings, klik tombol Are you creating this key for testing purposes only?.
- Gunakan penggeser Set score untuk menentukan skor antara 0 hingga 1,0.
- Klik Create key.
- Untuk Application type, pilih Android.
- Di bagian Android package list, klik Add Android package.
- Di kolom Android package, masukkan nama paket Android Anda.
- Opsional: Untuk menambahkan paket tambahan, klik Add Android package dan masukkan nama paket Android lain di kolom Android package.
- Untuk menerapkan bahwa kunci reCAPTCHA hanya digunakan dalam aplikasi Anda, nonaktifkan tombol Nonaktifkan verifikasi nama paket. Jika Anda menonaktifkan verifikasi nama paket, Anda harus memverifikasi kolom
tokenProperties.androidPackageNamedalam penilaian yang Anda buat. - Jika Anda ingin membuat kunci untuk aplikasi yang tersedia di app store lain selain Google Play Store, aktifkan Dukung aplikasi yang didistribusikan di luar Google Play Store.
- Opsional: Klik Langkah Berikutnya (opsional).
-
Untuk lingkungan non-produksi, jika Anda ingin menentukan skor yang Anda inginkan untuk ditampilkan oleh kunci saat penilaian dibuat untuknya, lakukan hal berikut:
- Di Additional settings, klik tombol Are you creating this key for testing purposes only?.
- Gunakan penggeser Set score untuk menentukan skor antara 0 hingga 1,0.
- Klik Create key.
Membuat kunci reCAPTCHA untuk aplikasi iOS
Sebaiknya buat satu kunci reCAPTCHA per aplikasi iOS.
Kunci yang baru dibuat akan tercantum di halaman reCAPTCHA keys.
Membuat kunci reCAPTCHA untuk aplikasi Android
Kunci yang baru dibuat akan tercantum di halaman reCAPTCHA keys.
gcloud (iOS)
Untuk membuat kunci reCAPTCHA, gunakan perintah gcloud recaptcha keys create.
Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:
- DISPLAY_NAME: Nama untuk kunci. Biasanya berupa nama situs.
- BUNDLE_IDs: ID paket iOS aplikasi yang diizinkan menggunakan kunci. Tentukan beberapa ID paket sebagai daftar yang dipisahkan koma.
Jalankan perintah gcloud recaptcha keys create:
Linux, macOS, atau Cloud Shell
gcloud recaptcha keys create \ --display-name=DISPLAY_NAME \ --ios --bundle-ids=BUNDLE_IDs
Windows (PowerShell)
gcloud recaptcha keys create ` --display-name=DISPLAY_NAME ` --ios --bundle-ids=BUNDLE_IDs
Windows (cmd.exe)
gcloud recaptcha keys create ^ --display-name=DISPLAY_NAME ^ --ios --bundle-ids=BUNDLE_IDs
Respons berisi kunci reCAPTCHA yang baru dibuat.
gcloud (Android)
Untuk membuat kunci reCAPTCHA, gunakan perintah gcloud recaptcha keys create.
Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:
- DISPLAY_NAME: Nama untuk kunci. Biasanya berupa nama situs.
- PACKAGE_NAMES: Nama paket Android dari aplikasi yang diizinkan untuk menggunakan kunci. Tentukan beberapa nama paket sebagai daftar yang dipisahkan koma.
Jalankan perintah gcloud recaptcha keys create:
Linux, macOS, atau Cloud Shell
gcloud recaptcha keys create \ --display-name=DISPLAY_NAME \ --android --package-names=PACKAGE_NAMES
Windows (PowerShell)
gcloud recaptcha keys create ` --display-name=DISPLAY_NAME ` --android --package-names=PACKAGE_NAMES
Windows (cmd.exe)
gcloud recaptcha keys create ^ --display-name=DISPLAY_NAME ^ --android --package-names=PACKAGE_NAMES
Respons berisi kunci reCAPTCHA yang baru dibuat.
REST (iOS)
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- DISPLAY_NAME: Nama untuk kunci. Biasanya berupa nama aplikasi.
- BUNDLE_IDs: ID paket iOS aplikasi yang diizinkan menggunakan kunci. Tentukan beberapa ID paket sebagai daftar yang dipisahkan koma.
Metode HTTP dan URL:
POST https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys
Meminta isi JSON:
{
"displayName": "DISPLAY_NAME",
"iosSettings": {
"allowedBundleIds":"BUNDLE_IDs"
}
}
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Simpan isi permintaan dalam file bernama request.json,
dan jalankan perintah berikut:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys"
PowerShell
Simpan isi permintaan dalam file bernama request.json,
dan jalankan perintah berikut:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys" | Select-Object -Expand Content
Anda akan melihat respons JSON seperti berikut:
{
"name": "projects/project-id/keys/6LfhtywnAAAAABY3sCS2duZ6A55kmDXz-PNEgKgT",
"displayName": "DISPLAY_NAME",
"iosSettings": {
"allowAllBundleIds": false,
"allowedBundleIds": [
BUNDLE_IDS
]
},
"labels": {},
}
REST (Android)
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- DISPLAY_NAME: Nama untuk kunci. Biasanya berupa nama aplikasi.
- PACKAGE_NAMES: Nama paket Android dari aplikasi yang diizinkan untuk menggunakan kunci. Tentukan beberapa nama paket sebagai daftar yang dipisahkan koma.
Metode HTTP dan URL:
POST https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys
Meminta isi JSON:
{
"displayName": "DISPLAY_NAME",
"androidSettings": {
"allowedPackageNames":"PACKAGE_NAMES"
}
}
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Simpan isi permintaan dalam file bernama request.json,
dan jalankan perintah berikut:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys"
PowerShell
Simpan isi permintaan dalam file bernama request.json,
dan jalankan perintah berikut:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys" | Select-Object -Expand Content
Anda akan melihat respons JSON seperti berikut:
{
"name": "projects/project-id/keys/6LcioSknAAAAABrjlMuZv2fjIGYMqwaAFC9izhoy",
"displayName": "DISPLAY_NAME",
"androidSettings": {
"allowAllPackageNames": false,
"allowedPackageNames": [
PACKAGE_NAMES
],
"supportNonGoogleAppStoreDistribution": false
},
"labels": {},
}