reCAPTCHA s3

reCAPTCHA v3, kullanıcılarla anlaşmazlık yaşamadan her istek için bir puan döndürür. Bu puan, sitenizdeki etkileşimlere dayanır ve siteniz için uygun işlemi yapmanızı sağlar. reCAPTCHA v3 anahtarlarını reCAPTCHA Yönetici Konsolu'nda kaydedin.

Bu sayfada, web sayfanızda reCAPTCHA v3'ü nasıl etkinleştireceğiniz ve özelleştireceğiniz açıklanmaktadır.

Web sitenizdeki yerleşim

reCAPTCHA v3, kullanıcılarınızın işini kesintiye uğratmaz. Bu nedenle, dönüşümü etkilemeden istediğiniz zaman çalıştırabilirsiniz. reCAPTCHA, hem meşru hem de kötüye kullanım amaçlı davranışları görme yoluyla sitenizle kurulan etkileşimler hakkında en fazla bağlama sahip olduğunda en iyi şekilde çalışır. Bu nedenle, formlar veya işlemler ile analiz sayfalarının arka planına da reCAPTCHA doğrulaması eklemenizi öneririz.

Aynı sayfada istediğiniz sayıda işlemde reCAPTCHA yürütebilirsiniz.

Meydan okumayı otomatik olarak bir düğmeye bağla

Sayfanızda reCAPTCHA v3 kullanmanın en kolay yöntemi, gerekli JavaScript kaynağını dahil etmek ve html düğmenize birkaç özellik eklemektir.

  1. JavaScript API'yi yükleyin.

     <script src="https://www.google.com/recaptcha/api.js"></script>

  2. Jetonu işlemek için bir geri çağırma işlevi ekleyin.

     <script>
   function onSubmit(token) {
     document.getElementById("demo-form").submit();
   }
 </script>

  3. HTML düğmenize özellikler ekleyin.

    <button class="g-recaptcha" 
        data-sitekey="reCAPTCHA_site_key" 
        data-callback='onSubmit' 
        data-action='submit'>Submit</button>

İstemi programatik olarak çağırın

reCAPTCHA'nın ne zaman çalışacağı üzerinde daha fazla kontrol sahibi olmak istiyorsanız grecaptcha nesnesinde execute yöntemini kullanabilirsiniz. Bunun için reCAPTCHA komut dosyası yüküne render parametresi eklemeniz gerekir.

  1. JavaScript API'yi site anahtarınızla yükleyin.

    <script src="https://www.google.com/recaptcha/api.js?render=reCAPTCHA_site_key"></script>

  2. Korumak istediğiniz her işlemde grecaptcha.execute çağırın.

       <script>
      function onClick(e) {
        e.preventDefault();
        grecaptcha.ready(function() {
          grecaptcha.execute('reCAPTCHA_site_key', {action: 'submit'}).then(function(token) {
              // Add your logic to submit to your backend server here.
          });
        });
      }
  </script>

  3. Jetonu doğrulama isteğiyle birlikte hemen arka ucunuza gönderin.

Puanı yorumlama

reCAPTCHA v3 bir puan döndürür (1.0 büyük olasılıkla iyi bir etkileşim, 0.0 ise büyük olasılıkla bottur). Puana bağlı olarak, siteniz için çeşitli işlemler yapabilirsiniz. Her site farklıdır, ancak sitelerin puanı nasıl kullandığına ilişkin bazı örnekleri aşağıda bulabilirsiniz. Aşağıdaki örneklerde olduğu gibi, sitenizi daha iyi korumak için trafiği engellemek yerine arka planda işlem yapın.

Kullanım alanı Öneri
ana sayfa Yönetici Konsolu'nda, toplayıcıları filtrelerken trafiğinizin tutarlı bir görünümünü görün.
giriş Düşük puanlarda, kimlik bilgisi doldurma saldırılarını önlemek için 2 faktörlü kimlik doğrulama veya e-posta doğrulaması zorunlu kılınır.
social Kötüye kullanan kullanıcılardan gelen cevapsız arkadaşlık isteklerini sınırlandırın ve riskli yorumları denetlemeye gönderin.
e-ticaret Gerçek satışlarınızı botların önüne getirin ve riskli işlemleri belirleyin.

reCAPTCHA, sitenizdeki gerçek trafiği görerek öğrenir. Bu nedenle, bir hazırlık ortamındaki veya uygulamadan hemen sonra elde edilen puanlar, üretimden farklı olabilir. reCAPTCHA v3 kullanıcı akışını kesintiye uğratmadığından önce herhangi bir işlem yapmadan reCAPTCHA'yı çalıştırabilir, ardından Yönetici Konsolu'nda trafiğinize bakarak eşiklere karar verebilirsiniz. Varsayılan olarak 0, 5 eşiği kullanabilirsiniz.

İşlemler

reCAPTCHA s3 yeni bir kavram sunuyor: işlemler. reCAPTCHA'yı yürüttüğünüz her yerde bir işlem adı belirttiğinizde aşağıdaki yeni özellikleri etkinleştirirsiniz:

  • Yönetici Konsolu'nda en sık kullandığınız on işlemle ilgili verilerin ayrıntılı bir dökümü
  • Kötüye kullanım davranışları değişiklik gösterebileceğinden işlemin bağlamına göre uyarlanabilir risk analizi.

Daha da önemlisi, reCAPTCHA yanıtını doğrularken işlem adının beklediğiniz ad olduğunu doğrulamanız gerekir.

Site Doğrulama Yanıtı

reCAPTCHA v2 veya görünmez reCAPTCHA'da olduğu gibi yanıt jetonunu doğrulama isteğinde bulunun.

Yanıt bir JSON nesnesi olur:

{
  "success": true|false,      // whether this request was a valid reCAPTCHA token for your site
  "score": number             // the score for this request (0.0 - 1.0)
  "action": string            // the action name for this request (important to verify)
  "challenge_ts": timestamp,  // timestamp of the challenge load (ISO format yyyy-MM-dd'T'HH:mm:ssZZ)
  "hostname": string,         // the hostname of the site where the reCAPTCHA was solved
  "error-codes": [...]        // optional
}

İpuçları

  1. grecaptcha.ready(), reCAPTCHA kitaplığı yüklendiğinde işlevinizi çalıştırır. api.js ile yarış koşullarını önlemek için grecaptcha çağrısı yapan komut dosyalarınızın önüne api.js kodunu ekleyin veya v2 API ile tanımlanan onload geri çağırmayı kullanmaya devam edin.
  2. execute çağrısını Kayıt, Şifre Sıfırlama, Satın Alma veya Oyna gibi ilginç ya da hassas işlemlere bağlamayı deneyin.
  3. Güvenilir Türler ile uyumlu kodu yüklemek için https://www.google.com/recaptcha/api.js?trustedtypes=true değerini kullanın.