Bermigrasi dari reCAPTCHA Klasik

Dokumen ini menjelaskan cara memigrasikan kunci situs aktif dari reCAPTCHA Classic ke reCAPTCHA di project.Google Cloud Anda dapat memigrasikan kunci situs menggunakan konsol Admin reCAPTCHA (direkomendasikan) atau menggunakan konsol Google Cloud . Proses migrasi memerlukan waktu 5–10 menit dan tidak memerlukan perubahan kode.

Jika Anda mengelola kunci di konsol Admin reCAPTCHA, berarti Anda menggunakan reCAPTCHA Classic. Fitur reCAPTCHA terbaru hanya tersedia untuk kunci situs yang dikelola dalam Google Cloud project. Untuk mengetahui informasi selengkapnya tentang fitur yang tersedia, lihat Membandingkan paket reCAPTCHA.

Perubahan berikut akan terjadi setelah Anda menyelesaikan proses migrasi:

• Kunci situs Anda tersedia di Google Cloud project tanpa perubahan apa pun.
• Integrasi reCAPTCHA yang ada akan terus berfungsi tanpa memerlukan perubahan kode. Anda dapat mempertahankan instrumentasi halaman web dan panggilan backend yang sama. Namun, untuk mengakses fitur seperti Account Defender atau Password Defense, Anda harus mengubah instrumentasi halaman web dan panggilan backend. Untuk mengetahui informasi selengkapnya, lihat Menggunakan fitur reCAPTCHA setelah migrasi.
• Anda akan dikenai biaya jika melebihi kuota bulanan gratis reCAPTCHA, yaitu 10.000 penilaian per bulan. Untuk mengetahui informasi selengkapnya, lihat Informasi penagihan.

Catatan: Kunci reCAPTCHA v2 Android tidak dapat dimigrasikan.

Memigrasikan menggunakan konsol Admin reCAPTCHA

1. Buka konsol Admin reCAPTCHA.

   Buka konsol admin reCAPTCHA

2. Pilih project yang ingin Anda migrasikan kuncinya.

3. Pilih kunci yang akan dimigrasikan.

4. Klik Kirim.

Konsol akan terbuka dengan project Anda dan kunci yang Anda migrasikan. Google Cloud

Catatan: Untuk mengatasi kegagalan migrasi, lihat Memecahkan masalah migrasi.

Memigrasikan menggunakan Google Cloud konsol

Sebelum memulai

Penting: Setelah kunci reCAPTCHA dimigrasikan ke Google Cloud project, kunci tersebut tidak dapat dipindahkan ke Google Cloud project lain. Pastikan Anda memilih project tujuan yang benar untuk kunci Anda.

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

   Peran yang diperlukan untuk memilih atau membuat project

   • Memilih project: Memilih project tidak memerlukan peran IAM tertentu Anda dapat memilih project mana pun yang telah diberi peran.
   • Membuat project: Untuk membuat project, Anda memerlukan peran Pembuat Project (roles/resourcemanager.projectCreator), yang berisi izin resourcemanager.projects.create. Pelajari cara memberikan peran.

   Buka pemilih project

2. Pastikan penagihan diaktifkan untuk Google Cloud project Anda.

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

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

   Instal Google Cloud CLI. Setelah penginstalan, inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:

   gcloud init

   Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus terlebih dahulu login ke gcloud CLI dengan identitas gabungan Anda.

Mengaktifkan reCAPTCHA Enterprise API

Semua paket reCAPTCHA (Essentials, Premium, dan Enterprise) berjalan di reCAPTCHA Enterprise API.

Konsol

1. Di Google Cloud konsol, 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 Anda, klik pemilih project, lalu pilih project Anda.

3. Klik Enable.

gcloud

1. Di konsol, aktifkan Cloud Shell. Google Cloud

   Aktifkan Cloud Shell

   Di bagian bawah konsol Google Cloud , sesi Cloud Shell akan dimulai 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 pada sesi.

2. Untuk menetapkan project Anda di sesi gcloud, jalankan perintah gcloud config set project . Google Cloud Ganti PROJECT_ID dengan Google Cloud project ID 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 Classic ke reCAPTCHA, pilih kunci situs aktif dari konsol Admin reCAPTCHA, lalu 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 untuk kunci situs yang ingin Anda migrasikan.
• Akun pengguna memiliki salah satu peran IAM berikut untuk Google Cloud project yang reCAPTCHA Enterprise API-nya 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 Anda untuk memberikan peran tersebut, atau ikuti petunjuk di Memberikan, mengubah, dan mencabut akses.

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

   Memigrasikan kunci situs tidak memengaruhi kunci atau endpoint API; tindakan ini menambahkan kunci ke lisensi enterprise.

   Google Cloud Konsol

   1. Di Google Cloud konsol, buka halaman reCAPTCHA.

      Buka reCAPTCHA

   2. Pastikan nama project Anda muncul di pemilih resource di bagian atas halaman. Jika Anda tidak melihat nama project Anda, klik pemilih resource, lalu pilih project Anda.

   3. Dari bagian Classic keys, identifikasi kunci yang ingin Anda migrasikan, lalu klik Upgrade key.

      

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

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

      2. Pilih kunci situs. Kunci situs reCAPTCHA berikut didukung untuk migrasi: reCAPTCHA v2 Checkbox, reCAPTCHA v2 Invisible, dan reCAPTCHA v3.

      3. Untuk menyalin kunci situs, klik Copy site key.

   3. Migrasikan kunci situs.

      Gunakan gcloud recaptcha keys migrate perintah 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 yang reCAPTCHA Enterprise API-nya diaktifkan. Google Cloud

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

      2. Pilih kunci situs. Kunci situs reCAPTCHA berikut didukung untuk migrasi: reCAPTCHA v2 Checkbox, reCAPTCHA v2 Invisible, dan reCAPTCHA v3.

      3. Untuk menyalin kunci situs, klik Copy site key.

   2. Migrasikan kunci situs.

      Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

      • PROJECT_ID: ID Google Cloud project yang reCAPTCHA API-nya diaktifkan.
      • 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 gcloud CLI menggunakan 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 menggunakan 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:

   Google Cloud Konsol

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

   Buka reCAPTCHA

   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. Untuk mengetahui informasi tentang respons, lihat Respons dari siteverify method.

Setelah kunci situs dimigrasikan ke reCAPTCHA, penggunaannya akan mulai dicatat untuk ditampilkan di Google Cloud konsol dalam waktu satu jam, termasuk dasbor terkait penggunaan dan skor. Penggunaan sebelum migrasi umumnya tidak ditampilkan di konsol. Google Cloud

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

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

Langkah berikutnya

• Menggunakan fitur reCAPTCHA setelah migrasi.