Bermigrasi dari reCAPTCHA (versi non-Enterprise)

Dokumen ini menunjukkan cara melakukan migrasi dari reCAPTCHA (versi non-Enterprise) ke reCAPTCHA Enterprise menggunakan kunci situs yang aktif. Proses migrasi dapat selesai dalam waktu 5–10 menit dan tidak memerlukan perubahan kode.

Jika Anda mengakses konsol Admin reCAPTCHA, berarti Anda menggunakan reCAPTCHA versi non-Enterprise, yang memiliki kemampuan terbatas dan batas penggunaan bulanan yang ketat. Untuk mengetahui informasi selengkapnya tentang perbandingan fitur, lihat Perbandingan fitur antar-versi reCAPTCHA.

Setelah migrasi, Anda akan menjadi pengguna reCAPTCHA Enterprise dan akan dikenai biaya jika melebihi 1.000.000 permintaan per bulan. Untuk informasi lebih lanjut, lihat harga reCAPTCHA Enterprise.

Catatan: Kunci Android reCAPTCHA v2 tidak dapat dimigrasikan.

Catatan: Proses migrasi tidak memberikan akses ke fitur reCAPTCHA Enterprise tambahan seperti Autentikasi multi-faktor (MFA) atau deteksi kebocoran sandi. Untuk menggunakan fitur tambahan ini, lihat Menggunakan fitur reCAPTCHA Enterprise setelah migrasi.

Catatan: Kontrol akses di project Google Cloud tujuan mungkin mencegah Anda mengakses kunci di konsol Admin reCAPTCHA setelah dimigrasikan. Dalam hal ini, Anda harus menggunakan konsol Google Cloud.

Sebelum memulai

1. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Buka pemilih project

2. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

   reCAPTCHA Enterprise mengharuskan penagihan ditautkan dan diaktifkan di project untuk migrasi. Anda dapat mengaktifkan penagihan menggunakan kartu kredit atau ID penagihan project Google Cloud yang sudah ada. Jika Anda memerlukan bantuan terkait penagihan, hubungi Dukungan Penagihan Cloud.

3. Jika ingin menjalankan gcloud CLI di luar Google Cloud Console, instal dan lakukan inisialisasi gcloud CLI. Untuk mengetahui petunjuknya, lihat

   Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut:

   gcloud init

Mengaktifkan reCAPTCHA Enterprise API

Konsol

1. Di konsol Google Cloud, buka halaman reCAPTCHA Enterprise API.

   Buka reCAPTCHA Enterprise API

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

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

3. Klik Enable.

gcloud

1. Di konsol Google Cloud, aktifkan Cloud Shell.

   Aktifkan Cloud Shell

   Di bagian bawah Google Cloud Console, Cloud Shell sesi akan terbuka dan menampilkan perintah command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi sesi.

2. Untuk menetapkan project Google Cloud di sesi gcloud, jalankan perintah gcloud config set project. Ganti PROJECT_ID dengan project ID Google Cloud Anda.

          gcloud config set project PROJECT_ID
          

3. Untuk mengaktifkan reCAPTCHA Enterprise API, jalankan perintah gcloud services enable:

            gcloud services enable recaptchaenterprise.googleapis.com
          

4. Untuk memastikan bahwa reCAPTCHA Enterprise API sudah aktif, jalankan perintah gcloud services list:

            gcloud services list --enabled
          

   Pastikan reCAPTCHA Enterprise API tercantum dalam daftar API yang diaktifkan.

Bermigrasi ke reCAPTCHA Enterprise

Migrasi dari reCAPTCHA versi non-Enterprise ke reCAPTCHA Enterprise melibatkan pemilihan kunci situs yang aktif dari konsol Admin reCAPTCHA dan migrasikan kunci situs. Anda dapat memigrasikan satu atau beberapa kunci situs aktif. Namun, Anda hanya dapat memigrasikan satu kunci situs dalam satu waktu.

Untuk menjalankan proses migrasi, Anda harus memiliki akun pengguna reCAPTCHA yang memenuhi persyaratan berikut:

• Di konsol Admin reCAPTCHA, akun pengguna tercantum sebagai pemilik kunci situs yang ingin Anda migrasikan.
• Akun pengguna memiliki salah satu peran IAM berikut untuk project Google Cloud dengan reCAPTCHA Enterprise API yang diaktifkan:
  • Pemilik Project (roles/owner)
  • Editor Project (roles/editor)
  • Admin reCAPTCHA Enterprise (roles/recaptchaenterprise.admin)
  Jika akun pengguna Anda tidak memiliki salah satu peran tersebut, minta administrator Anda untuk memberikan peran tersebut, atau ikuti petunjuk di Memberikan, mengubah, dan mencabut akses.

1. Migrasikan kunci situs menggunakan Konsol Google Cloud, Cloud Shell, Google Cloud CLI, atau reCAPTCHA Enterprise API.

   Memigrasikan kunci situs tidak akan memengaruhi kunci atau endpoint API tersebut; tindakan ini akan menambahkan kunci ke lisensi perusahaan.

   Konsol Google Cloud

   1. Di konsol Google Cloud, buka halaman reCAPTCHA Enterprise.

      Buka reCAPTCHA Enterprise

   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. Dari bagian Kunci klasik, identifikasi kunci yang ingin dimigrasikan, lalu klik Upgrade kunci.

      

   4. Untuk menyelesaikan migrasi kunci yang dipilih, klik Konfirmasi.

   Cloud Shell

   1. Di Konsol Google Cloud, buka Cloud Shell.

      Buka Cloud Shell

   2. Jika diminta, klik Authorize.

   3. Pilih dan salin kunci situs aktif yang telah Anda gunakan untuk mengintegrasikan reCAPTCHA dengan halaman web Anda:

      1. Buka konsol Admin reCAPTCHA lalu klik .

      2. Pilih kunci situs. Kunci situs reCAPTCHA berikut didukung untuk migrasi: Kotak centang reCAPTCHA v2, reCAPTCHA v2 Tidak Terlihat, dan reCAPTCHA v3.

      3. Untuk menyalin kunci situs, klik Salin kunci situs.

   4. Migrasikan kunci situs.

      Gunakan perintah gcloud recaptcha keys migrate seperti yang ditunjukkan dalam contoh berikut:

       gcloud recaptcha keys migrate SITE_KEY --project PROJECT-ID
      

      Berikan nilai berikut:

      • SITE_KEY: kunci situs aktif yang Anda salin dari konsol Admin reCAPTCHA.
      • PROJECT-ID: ID project Google Cloud yang mengaktifkan reCAPTCHA Enterprise API.

   gcloud CLI

   1. Untuk mengonfigurasi autentikasi, jalankan perintah gcloud berikut:

      gcloud auth login
      

      Login dengan akun pengguna reCAPTCHA yang memiliki kunci situs yang dipilih dan memiliki salah satu peran berikut: Project Owner, Project Editor, atau reCAPTCHA Enterprise Admin.

   2. Pilih dan salin kunci situs aktif yang telah Anda gunakan untuk mengintegrasikan reCAPTCHA dengan halaman web Anda:

      1. Buka konsol Admin reCAPTCHA lalu klik .

      2. Pilih kunci situs. Kunci situs reCAPTCHA berikut didukung untuk migrasi: Kotak centang reCAPTCHA v2, reCAPTCHA v2 Tidak Terlihat, dan reCAPTCHA v3.

      3. Untuk menyalin kunci situs, klik Salin kunci situs.

   3. Migrasikan kunci situs.

      Gunakan perintah gcloud recaptcha keys migrate seperti yang ditunjukkan dalam contoh berikut:

       gcloud recaptcha keys migrate SITE_KEY --project PROJECT-ID
      

      Berikan nilai berikut:

      • SITE_KEY: kunci situs aktif yang Anda salin dari konsol Admin reCAPTCHA.
      • PROJECT-ID: ID project Google Cloud yang mengaktifkan reCAPTCHA Enterprise API.

   REST API

   1. Pilih dan salin kunci situs aktif yang telah Anda gunakan untuk mengintegrasikan reCAPTCHA dengan halaman web Anda:

      1. Buka konsol Admin reCAPTCHA lalu klik .

      2. Pilih kunci situs. Kunci situs reCAPTCHA berikut didukung untuk migrasi: Kotak centang reCAPTCHA v2, reCAPTCHA v2 Tidak Terlihat, dan reCAPTCHA v3.

      3. Untuk menyalin kunci situs, klik Salin kunci situs.

   2. Migrasikan kunci situs.

      Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

      • PROJECT_ID: ID project Google Cloud yang mengaktifkan reCAPTCHA Enterprise API.
      • SITE_KEY: kunci situs aktif yang Anda salin dari konsol Admin reCAPTCHA.

      Metode HTTP dan URL:

      POST https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys/SITE_KEY:migrate

      Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

      curl

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

      Jalankan perintah berikut:

      curl -X POST \
           -H "Authorization: Bearer $(gcloud auth print-access-token)" \
           -H "Content-Type: application/json; charset=utf-8" \
           -d "" \
           "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys/SITE_KEY:migrate"

      PowerShell

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

      Jalankan perintah berikut:

      $cred = gcloud auth print-access-token
      $headers = @{ "Authorization" = "Bearer $cred" }
      
      Invoke-WebRequest `
          -Method POST `
          -Headers $headers `
          -Uri "https://recaptchaenterprise.googleapis.com/v1/projects/PROJECT_ID/keys/SITE_KEY:migrate" | Select-Object -Expand Content

      Anda akan melihat respons JSON seperti berikut:

      {
        "name": "projects/PROJECT-ID/keys/6Ldqgs0UAAAAAIn4k7YxEB-LwEh5S9-Gv6IIWB8m",
        "displayName": "My site key",
        "webSettings": {
          "allowAllDomains": false,
          "allowedDomains": [
            recaptcha.net
          ],
          "allowAmpTraffic": false,
          "integrationType": "SCORE",
          "challengeSecurityPreference": "CHALLENGE_SECURITY_PREFERENCE_UNSPECIFIED"
        }
      }
      

2. Untuk memastikan bahwa kunci situs dimigrasikan, lakukan hal berikut:

   Konsol Google Cloud

   Buka halaman reCAPTCHA Enterprise dan temukan kunci situs yang dimigrasikan di bagian Enterprise keys.

   Buka reCAPTCHA Enterprise

   Cloud Shell

   Jalankan perintah gcloud recaptcha keys list dan temukan kunci situs yang dimigrasikan dalam daftar kunci.

   gcloud CLI

   Jalankan perintah gcloud recaptcha keys list dan temukan kunci situs yang dimigrasikan dalam daftar kunci.

Setelah bermigrasi ke reCAPTCHA Enterprise, Anda dapat terus menggunakan metode siteverify untuk menilai token respons reCAPTCHA pengguna.

Catatan: Anda tidak boleh menghapus kunci situs dari konsol Admin reCAPTCHA atau halaman reCAPTCHA Enterprise di Konsol Google Cloud. Saat Anda menghapus kunci situs, kunci tersebut akan dihapus dari kedua konsol dan menghapus perlindungan yang ditawarkan reCAPTCHA Enterprise.

Anda dapat mencabut peran IAM reCAPTCHA Enterprise Admin (roles/recaptchaenterprise.admin) dari akun pengguna reCAPTCHA. Anda dapat meminta administrator untuk mencabut akses, atau mengikuti petunjuk tentang Memberikan, mengubah, dan mencabut akses.

Langkah selanjutnya

• Gunakan fitur reCAPTCHA Enterprise setelah migrasi.