Membuat kunci reCAPTCHA untuk aplikasi seluler

Halaman ini menjelaskan cara membuat kunci reCAPTCHA (juga dikenal sebagai kunci) untuk memverifikasi interaksi pengguna di aplikasi seluler Anda.

Kunci reCAPTCHA menunjukkan cara reCAPTCHA dikonfigurasi untuk aplikasi seluler (aplikasi).

Sebelum memulai

• Siapkan lingkungan Anda untuk reCAPTCHA.
• Pastikan Anda memiliki peran Identity and Access Management berikut: reCAPTCHA Enterprise Admin (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 mencemari analisis risiko reCAPTCHA dengan data dari lingkungan pengujian.

Cara termudah untuk membuat kunci reCAPTCHA adalah melalui konsol Google Cloud. Atau, Anda dapat menggunakan reCAPTCHA Enterprise API atau Google Cloud CLI.

Konsol

1. Di konsol Google Cloud, buka halaman reCAPTCHA.

   Buka reCAPTCHA

2. Pastikan nama project Anda muncul di pemilih resource di bagian atas halaman.

   Jika tidak melihat nama project, klik pemilih resource, lalu pilih project Anda.

3. Klik Create key.
4. Di kolom Nama tampilan, masukkan nama tampilan untuk kunci.
5. Bergantung pada jenis kunci reCAPTCHA yang ingin Anda buat untuk aplikasi seluler, lakukan tindakan yang sesuai:

Membuat kunci reCAPTCHA untuk aplikasi iOS

Sebaiknya buat satu kunci reCAPTCHA per aplikasi iOS.

1. Dari menu Pilih jenis platform, pilih Aplikasi iOS.
1. Di bagian Daftar ID paket iOS, klik Tambahkan ID paket iOS.

2. Di kolom Bundle ID, masukkan nama ID paket iOS Anda.

3. Opsional: Untuk menambahkan ID paket tambahan, klik Tambahkan ID paket iOS dan masukkan nama ID paket iOS Anda di kolom ID Paket.

4. Opsional: Berikan Setelan Apple Developer.

   Sebaiknya berikan data ini karena reCAPTCHA dapat memberikan skor risiko yang lebih akurat untuk traffic Anda.

   Masukkan informasi berikut:

   • Kunci pribadi (.p8): Kunci ini dibuat di Apple Developer Center 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 mem-build aplikasi Anda.
5. Luaskan Verifikasi ID paket dan jenis kunci.
   1. Untuk melindungi kunci reCAPTCHA untuk ID paket Anda, pastikan tombol Nonaktifkan verifikasi ID paket dinonaktifkan.

   2. Untuk lingkungan non-produksi, jika Anda ingin menentukan skor yang ingin ditampilkan kunci saat penilaian dibuat untuknya, lakukan hal berikut:

      1. Klik tombol Ini adalah kunci pengujian.
      2. Di kotak Score, tentukan skor antara 0 hingga 1,0.
6. Klik Create key.

Kunci yang baru dibuat akan tercantum di halaman kunci reCAPTCHA.

Membuat kunci reCAPTCHA untuk aplikasi Android

1. Dari menu Pilih jenis platform, pilih Aplikasi Android.
   
2. Di bagian Daftar paket Android, klik Tambahkan paket Android.
3. Di kolom Android package, masukkan nama paket Android Anda.
4. Opsional: Untuk menambahkan paket tambahan, klik Tambahkan paket Android dan masukkan nama paket Android lain di kolom Android package.
5. Luaskan Verifikasi nama paket, distribusi aplikasi, dan kunci pengujian.
1. Untuk menerapkan bahwa kunci reCAPTCHA hanya digunakan dalam aplikasi Anda, nonaktifkan tombol Nonaktifkan verifikasi nama paket.
2. 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.

3. Untuk lingkungan non-produksi, jika Anda ingin menentukan skor yang ingin ditampilkan kunci saat penilaian dibuat untuknya, lakukan hal berikut:

   1. Klik tombol Ini adalah kunci pengujian.
   2. Di kotak Score, tentukan skor antara 0 hingga 1,0.
6. Klik Create key.

Kunci yang baru dibuat akan tercantum di halaman kunci reCAPTCHA.

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 nama situs.
• BUNDLE_IDs: ID paket iOS aplikasi yang diizinkan untuk 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 nama situs.
• PACKAGE_NAMES: Nama paket Android 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 nama aplikasi.
• BUNDLE_IDs: ID paket iOS aplikasi yang diizinkan untuk 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

Isi JSON permintaan:

{
  "displayName": "DISPLAY_NAME",
  "iosSettings": {
   "allowedBundleIds":"BUNDLE_IDs"

  }
}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

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

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

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 nama aplikasi.
• PACKAGE_NAMES: Nama paket Android 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

Isi JSON permintaan:

{
  "displayName": "DISPLAY_NAME",
  "androidSettings": {
  "allowedPackageNames":"PACKAGE_NAMES"
  }
}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

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

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

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": {},
}

Catatan: Setelah membuat kunci reCAPTCHA, Anda dapat mengedit atau menghapusnya. Anda tidak dapat memulihkan kunci yang dihapus. Selain itu, Anda tidak dapat memigrasikan kunci reCAPTCHA dari satu project Google Cloud ke project Google Cloud lainnya.

Langkah selanjutnya

• Menginstal kunci di iOS.
• Menginstal kunci di Android.