Bermigrasi dari reCAPTCHA Klasik

Dokumen ini menunjukkan cara bermigrasi dari reCAPTCHA Classic ke reCAPTCHA menggunakan kunci situs aktif. Proses migrasi memerlukan waktu 5–10 menit untuk selesai dan tidak memerlukan perubahan kode.

Jika Anda mengakses konsol Admin reCAPTCHA, Anda menggunakan reCAPTCHA Klasik, yang memiliki kemampuan terbatas dan batas ketat pada penggunaan bulanan. Untuk informasi selengkapnya tentang perbandingan fitur, lihat Perbandingan fitur antara versi reCAPTCHA.

Setelah migrasi, Anda menjadi pengguna reCAPTCHA dan akan dikenai biaya jika melebihi 10.000 permintaan per bulan. Untuk mengetahui informasi selengkapnya, lihat harga reCAPTCHA.

Catatan: Kunci Android reCAPTCHA v2 tidak dapat dimigrasikan.

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

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

Sebelum memulai

1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Go to project selector

2. Make sure that billing is enabled for your Google Cloud project.

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

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

   Install the Google Cloud CLI, then initialize it by running the following command:

   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 tidak melihat nama project, klik pemilih project, lalu pilih project Anda.

3. Klik Aktifkan.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. Untuk menetapkan project Google Cloud Anda dalam 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 memverifikasi bahwa reCAPTCHA Enterprise API diaktifkan, jalankan perintah gcloud services list:

            gcloud services list --enabled
          

   Pastikan reCAPTCHA Enterprise API tercantum dalam daftar API yang diaktifkan.

Bermigrasi ke reCAPTCHA

Untuk memigrasikan reCAPTCHA Klasik ke reCAPTCHA, pilih kunci situs aktif dari konsol Admin reCAPTCHA, lalu migrasikan kunci situs. Anda dapat memigrasikan satu atau beberapa kunci situs yang 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 tempat reCAPTCHA Enterprise API diaktifkan:
  • Project Owner (roles/owner)
  • Project Editor (roles/editor)
  • reCAPTCHA Admin (roles/recaptchaenterprise.admin)
  Jika akun pengguna Anda tidak memiliki salah satu peran ini, minta administrator 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 memengaruhi kunci atau endpoint API; tindakan ini menambahkan kunci ke lisensi perusahaan.

   Konsol Google Cloud

   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. Dari bagian Kunci klasik, identifikasi kunci yang ingin Anda migrasikan, 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. Memigrasikan 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 reCAPTCHA Admin.
      • PROJECT-ID: ID project Google Cloud yang reCAPTCHA Enterprise API-nya diaktifkan.

   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: Pemilik Project, Project Editor, atau peran Admin reCAPTCHA Enterprise.

   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. Memigrasikan 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 reCAPTCHA Admin.
      • PROJECT-ID: ID project Google Cloud yang reCAPTCHA Enterprise API-nya diaktifkan.

   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. Memigrasikan kunci situs.

      Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

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

      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 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.

      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 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.

      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 memverifikasi bahwa kunci situs dimigrasikan, lakukan hal berikut:

   Konsol Google Cloud

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

   Buka reCAPTCHA

   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, 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 di konsol Google Cloud. Saat Anda menghapus kunci situs, kunci tersebut akan dihapus dari kedua konsol dan perlindungan yang ditawarkan reCAPTCHA akan dihapus.

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

Langkah selanjutnya

• Menggunakan fitur reCAPTCHA setelah migrasi.