reCAPTCHA v3
ve CapMonster Cloud

CapMonster Cloud API ile çalışma genellikle şu adımlardan oluşur:

1. reCAPTCHA yönetim paneli sayfasına gidin.

2. Yeni bir site kaydedin ve captcha türü olarak reCAPTCHA v3’ü seçin

3. İki anahtar alın:

• Site key — ortak anahtar (frontend tarafında kullanılır);
• Secret key — gizli anahtar (sunucu tarafında doğrulama için kullanılır)

Ayarlar bölümünü açarak, örneğin reCAPTCHA’nın kullanılabileceği alan adlarını belirleyebilir veya siteyle ilgili sorunlar ya da şüpheli trafik artışı için bildirimler yapılandırabilirsiniz.

4. İstemci tarafı için kod örnekleri

reCAPTCHA v3 kullanmanın en basit yolu, JavaScript API’sini eklemek ve butona gerekli öznitelikleri (attribute) eklemektir.

API’yi ekleme:

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

Form için geri çağırma (callback) fonksiyonu:

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

reCAPTCHA özniteliklerine sahip buton:

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

Tam kontrol için render parametresiyle birlikte grecaptcha.execute kullanın:

Anahtar ile API’yi ekleme:

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

Programatik çağrı:

<script>
  function onClick(e) {
    e.preventDefault();
    grecaptcha.ready(function() {
      grecaptcha.execute('reCAPTCHA_sitekey', {action: 'submit'}).then(function(token) {
          // Doğrulama için token’ı sunucuya gönderin
      });
    });
  }
</script>

Token’ı, doğrulama için hemen sunucuya göndermeniz gerekir.

Önemli notlar:

• Token’ın geçerlilik süresi: reCAPTCHA v3 tarafından döndürülen token 2 dakika boyunca geçerlidir. Bu süre içinde token’ı sunucuya gönderdiğinizden emin olun.
• Sunucu tarafında doğrulama: Sunucu token’ı aldıktan sonra https://www.google.com/recaptcha/api/siteverify adresine şu parametrelerle bir POST isteği göndermelidir:
  – secret: gizli anahtarınız
  – response: istemciden alınan token
  – remoteip (zorunlu değil): kullanıcının IP adresi
• Google sunucusu, doğrulama sonucuna ilişkin bilgileri içeren bir JSON yanıtı döndürür.

Daha ayrıntılı bilgileri doğrudan captcha’nın resmî dokümantasyonunda bulabilirsiniz.

5. Ardından sunucu tarafında yanıtı doğrulayın

PHP örneği

<?php
// reCAPTCHA v3 gizli anahtarınız (Secret Key)
$secret = 'YOUR_SECRET_KEY';

// Token’ı formdan alın
$token = $_POST['recaptcha-token'] ?? '';

// Token’ı doğrulamak için Google’a istek gönderin
$response = file_get_contents(
    "https://www.google.com/recaptcha/api/siteverify?secret={$secret}&response={$token}"
);

$result = json_decode($response, true);

// Başarı durumunu ve güven puanını kontrol edin
if ($result['success'] && $result['score'] >= 0.5 && $result['action'] === 'submit') {
    echo "Doğrulama başarılı";
} else {
    http_response_code(403);
    echo "Doğrulama başarısız";
}
?>

Notlar:

• İstemci tarafında token’ın recaptcha-token adlı gizli bir form alanı üzerinden sunucuya gönderildiğinden emin olun:

<input type="hidden" name="recaptcha-token" id="recaptcha-token">


• score eşiğini, istediğiniz sıkılık seviyesine göre ayarlayabilirsiniz (örneğin 0.3–0.7).
• action === 'submit' kontrolü ek güvenlik sağlar ve token’ın sayfadaki belirli işlem için üretildiğinden emin olmanıza yardımcı olur.