Dokumen ini menjelaskan cara mengidentifikasi versi kunci reCAPTCHA Anda
(v2 atau v3), memetakan terminologi konsol Admin reCAPTCHA lama ke
konsolGoogle Cloud , dan mengambil kunci situs dan kunci rahasia yang diperlukan oleh platform
sistem pengelolaan konten (CMS) dan plugin pihak ketiga, seperti integrasi WordPress atau
Shopify.
Memetakan terminologi lama ke konsol Google Cloud
Jika Anda hanya mengelola kunci di konsol Admin reCAPTCHA, berarti Anda menggunakan reCAPTCHA Klasik. Jika Anda mengelola kunci di halaman Google Cloud Fraud Defense di konsol Google Cloud , berarti Anda menggunakan Fraud Defense. Kedua konsol mendukung kunci situs v2 dan v3.
Banyak platform dan plugin CMS merujuk ke kunci reCAPTCHA menggunakan
nomor versi lama, seperti v2 Checkbox, v2 Invisible, dan v3.Google Cloud console menggunakan deskriptor berbasis platform, bukan nomor versi.
Tabel berikut memetakan terminologi CMS dan Konsol Admin lama ke terminologi konsolGoogle Cloud :
| Terminologi CMS atau Konsol Admin | Google Cloud console (Platform details) | Edit key (kolom Type) | Mekanisme verifikasi dan kompatibilitas CMS |
|---|---|---|---|
| Berbasis skor (v3) | Website • score |
Website • Score |
Verifikasi berbasis skor yang lancar. Gunakan untuk plugin CMS yang memerlukan reCAPTCHA v3. |
| Tantangan (v2) | Website • checkbox |
Website • Checkbox challenge |
Mengharuskan pengguna memilih kotak centang "Saya bukan robot". Gunakan untuk plugin CMS yang memerlukan Kotak Centang reCAPTCHA v2. |
| Tidak terlihat (v2) | Website • invisible |
Website • Invisible integration |
Menganalisis risiko di latar belakang dan mungkin menampilkan verifikasi. Gunakan untuk plugin CMS yang memerlukan reCAPTCHA v2 Tidak Terlihat. |
| T/A | Website • policy-based challenge |
Website • Policy-based challenge |
Memicu verifikasi berdasarkan nilai minimum skor yang dikonfigurasi. Memerlukan
integrasi CreateAssessment kustom. |
| T/A | iOS |
iOS app |
Kunci seluler iOS tanpa verifikasi. |
| T/A | Android |
Android app |
Kunci seluler Android tanpa tantangan. |
Melihat versi kunci Anda di konsol Google Cloud
Untuk melihat versi kunci Anda di konsol Google Cloud , lakukan hal berikut:
Di konsol Google Cloud , buka halaman Fraud Defense.
Pilih tab Keys.
Jika kunci Anda berada dalam tampilan Kartu, beralihlah ke tampilan Tabel.
Periksa kolom Detail platform untuk kunci Anda. Misalnya,
Website • scoresesuai denganv3, danWebsite • checkboxsesuai denganv2 Checkbox.Opsional. Di tampilan Cards, klik Key details pada kartu kunci, lalu pilih Edit key. Kolom Type menampilkan konfigurasi kunci, seperti
Website • Scoreuntukv3atauWebsite • Checkbox challengeuntukv2 Checkbox.
Menemukan kunci situs dan kunci rahasia
Plugin pihak ketiga dan platform CMS sering kali memerlukan kunci situs dan kunci rahasia untuk integrasi reCAPTCHA:
- Kunci situs: Di konsol Google Cloud , ID Kunci sesuai dengan kunci situs.
- Kunci rahasia: Konsol Google Cloud tidak menampilkan kunci rahasia secara default karena autentikasi Google Cloud biasanya menggunakan kunci API atau peran Identity and Access Management. Namun, Anda dapat mengambil kunci rahasia lama untuk plugin yang memerlukannya. Beberapa dokumentasi atau library pihak ketiga mungkin menyebut kunci rahasia lama sebagai kunci pribadi.
Mengambil kunci rahasia di konsol Google Cloud
Untuk mengambil kunci situs dan kunci rahasia, lakukan hal berikut:
Di konsol Google Cloud , buka halaman Fraud Defense.
Pilih tab Keys.
Di bagian reCAPTCHA Keys, buka kunci yang memerlukan kunci rahasia:
- Jika Anda berada dalam tampilan Kartu, klik Detail kunci pada kartu kunci. ID Kunci ditampilkan di bagian atas halaman.
- Jika Anda berada dalam tampilan Tabel, ID Kunci akan terlihat di tabel. Klik kunci untuk membuka halaman detailnya.
Salin ID Kunci yang ditampilkan di bagian atas halaman. Nilai ini adalah kunci situs Anda.
Buka tab Integration.
Bergantung pada status kunci, lakukan salah satu tindakan berikut:
- Jika kunci dikonfigurasi untuk penggunaan lama, klik Gunakan kunci lama.
- Jika kunci tidak terintegrasi dengan layanan lama, klik Integrate with a third-party service or plugin.
Dialog akan muncul dengan kunci rahasia Anda. Salin nilai ini dengan aman. Perlakukan rahasia ini sebagai data sensitif.
Atau, di halaman Key details, klik Edit key, lalu klik Reveal di samping kolom Secret key.
Mengintegrasikan dengan WordPress, Shopify, atau platform CMS lainnya
Jika Anda menggunakan pembuat situs, platform e-commerce, atau plugin CMS, platform atau plugin tersebut akan memuat skrip reCAPTCHA dan memverifikasi token pengguna secara otomatis. Anda tidak perlu menginstal library klien reCAPTCHA atau menulis kode backend kustom.
Untuk mengonfigurasi reCAPTCHA di CMS atau plugin pihak ketiga, lakukan hal berikut:
- Periksa versi reCAPTCHA yang diperlukan oleh CMS atau plugin Anda: Buka setelan integrasi reCAPTCHA di CMS atau plugin Anda, lalu periksa jenis kunci yang didukung (biasanya reCAPTCHA v3 atau Kotak Centang reCAPTCHA v2).
Pilih atau buat kunci pencocokan:
- Jika Anda sudah memiliki kunci, lihat versi kunci Anda untuk mengonfirmasi bahwa versi tersebut cocok dengan versi yang dipilih di plugin Anda (
Website • scoreuntukv3, atauWebsite • checkboxuntukv2 Checkbox). - Jika Anda memerlukan kunci baru, buat kunci untuk situs Anda yang cocok dengan versi yang diperlukan, dan tambahkan domain situs Anda (misalnya,
example.com) ke Daftar domain kunci.
- Jika Anda sudah memiliki kunci, lihat versi kunci Anda untuk mengonfirmasi bahwa versi tersebut cocok dengan versi yang dipilih di plugin Anda (
Salin kunci situs dan kunci rahasia lama Anda: Ikuti langkah-langkah di bagian Mengambil kunci rahasia diGoogle Cloud konsol untuk mendapatkan ID Kunci (kunci situs) dan kunci rahasia Anda.
Masukkan kunci di setelan CMS atau plugin Anda:
- Tempelkan ID Kunci ke kolom Kunci situs.
- Tempelkan kunci rahasia ke kolom Secret key (atau kunci pribadi), lalu simpan setelan Anda.
Mengintegrasikan situs kustom menggunakan penilaian
Metode CreateAssessment memberikan analisis risiko dan kode alasan yang mendetail,
serta memungkinkan akses ke fitur Fraud Defense lanjutan. Anda dapat
memanggil metode CreateAssessment menggunakan library klien
reCAPTCHA atau REST API.
Untuk mengetahui informasi selengkapnya, lihat Membuat penilaian untuk situs Anda.
Metode SiteVerify lama
Meskipun kami merekomendasikan metode CreateAssessment untuk integrasi baru dan kustom, beberapa sistem yang ada atau plugin pihak ketiga masih mengandalkan metode SiteVerify lama. Metode ini memerlukan kunci rahasia yang terkait dengan kunci reCAPTCHA Anda.
Jika Anda perlu berintegrasi dengan sistem yang memerlukan SiteVerify
API lama, lihat Memverifikasi token respons pengguna dengan SiteVerify
lama.