reCAPTCHA s3

reCAPTCHA v3, kullanıcıların herhangi bir işlem sorunu yaşamadan her istek için bir puan döndürür. Puan, sitenizle kurulan etkileşimlere dayanır ve siteniz için uygun bir işlem yapmanızı sağlar. reCAPTCHA v3 anahtarlarını reCAPTCHA Yönetici Konsolu'na kaydedin.

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

Web sitenizdeki yerleşim

reCAPTCHA v3, kullanıcılarınızı hiçbir zaman kesintiye uğratmaz. Bu nedenle, dönüşümü etkilemeden istediğiniz zaman çalıştırabilirsiniz. reCAPTCHA, sitenizle kurulan etkileşimler hakkında en fazla bağlama sahip olduğunda en iyi performansı gösterir. Bu durum, hem meşru hem de kötüye kullanım amaçlı davranışlarla ilişkilidir. Bu nedenle, analizler için sayfaların arka planının yanı sıra formlarda veya işlemlerde de reCAPTCHA doğrulaması eklemenizi öneririz.

Aynı sayfada reCAPTCHA'yı istediğiniz sayıda işleme uygulayabilirsiniz.

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

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

Görevi 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üklemesine render parametresi eklemeniz gerekir.

  1. JavaScript anahtarınızı 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 numaralı telefonu arayı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, hemen doğrulama isteğiyle arka ucunuza gönderin.

Puanı yorumlama

reCAPTCHA v3 bir puan döndürür (1.0 çok iyi bir etkileşim, 0.0 büyük olasılıkla bir bottur). Puana bağlı olarak, sitenizin bağlamında değişken işlemler yapabilirsiniz. Her site farklıdır ancak sitelerin puanı nasıl kullandığına dair bazı örnekleri aşağıda bulabilirsiniz. Aşağıdaki örneklerde olduğu gibi, sitenizi daha iyi korumak için trafiği engellemek yerine kamera arkası işlemleri gerçekleştirin.

Kullanım alanı Öneri
ana sayfa İzin verenleri filtrelerken yönetici konsolunda trafiğinizin tutarlı bir görünümünü inceleyin.
login Düşük puanlarla kimlik bilgisi doldurma saldırılarını önlemek için 2 faktörlü kimlik doğrulama veya e-posta doğrulaması yapılmasını isteyin.
social Kötüye kullanan kullanıcılardan gelen yanıtlanmamış arkadaşlık isteklerini sınırlayın ve denetleme amacıyla riskli yorumlar gönderin.
e-ticaret Gerçek satışlarınızı botların önüne taşıyın ve riskli işlemleri belirleyin.

reCAPTCHA, sitenizde gerçek bir trafik görerek öğrenir. Bu nedenle, bir hazırlık ortamındaki veya uygulandıktan kısa bir süre sonra skorlar, üretimden farklı olabilir. reCAPTCHA v3 hiçbir zaman kullanıcı akışını kesintiye uğratmayacağından önce herhangi bir işlem yapmadan reCAPTCHA'yı çalıştırabilir, ardından yönetici konsolundaki trafiğinize göz atarak eşiklere karar verebilirsiniz. Varsayılan olarak 0, 5 eşiği kullanabilirsiniz.

İşlemler

reCAPTCHA v3 yeni bir kavramı kullanıma 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'ndaki ilk on işleminiz için verilerin ayrıntılı dökümü
  • Kötüye kullanım davranışı değişiklik gösterebileceği için 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 nesnesidir:

{
  "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ından kaçınmak için grecaptcha kodu çağıran komut dosyalarınızdan önce api.js ekleyin veya v2 API'de tanımlı yüklü geri çağırmayı kullanmaya devam edin.
  2. execute çağrısını Kaydetme, Şifre Sıfırlama, Satın Alma veya Oynama gibi ilgi çekici veya hassas işlemlere bağlamayı deneyin.
  3. Güvenilir Türler ile uyumlu kod yüklemek için https://www.google.com/recaptcha/api.js?trustedtypes=true kullanın.