Sık Sorulan Sorular

reCAPTCHA Enterprise'ı kullanmalı mıyım?

reCAPTCHA Enterprise,ayda 10.000'e kadar ücretsiz değerlendirme ve ek özellikler sunar. Anlık analiz gibi diğer özellikler, çoğu geliştirici için en iyi başlangıç noktasıdır. Buradan başlayın.

reCAPTCHA'yı üçüncü taraf çözümleriyle kullanabilir miyim?

Evet, hem reCAPTCHA'yı (Enterprise olmayan sürüm) hem de reCAPTCHA Enterprise'ı kullanabilirsiniz. Üçüncü taraf çözümü genellikle ortak anahtarınızı ve gizli anahtarınızı ya da API anahtarınızı ister. Gizli anahtarınızı ve API anahtarınızı yalnızca güvenilir üçüncü taraflarla paylaştığınızdan emin olun.

v2 veya v3'ten reCAPTCHA Enterprise'a nasıl geçilir?

Taşıma işlemi 5-10 dakika sürer ve kod değişikliği gerektirmez.

reCAPTCHA s2'yi mi yoksa v3'ü mü kullanmalıyım?

reCAPTCHA s3, trafiği hakkında daha fazla veri isteyen site sahipleri içindir. Daha fazla bilgi için reCAPTCHA s3 geliştirici kılavuzuna bakın.

2. sürüm için güvenlik ve kullanılabilirliği destekliyoruz.

reCAPTCHA s2 ve v3 arasındaki farklar hakkında daha fazla bilgi için sürümlerin karşılaştırması bölümüne bakın.

reCAPTCHA çerez kullanır mı?

reCAPTCHA, risk analizini sağlamak amacıyla yürütüldüğünde gerekli bir çerezi (_GRECAPTCHA) ayarlar. Başka çerezlerin ayarlanmış olabileceği www.google.com alanını kullanmak istemiyorsanız bunun yerine www.recaptcha.net adresini kullanabilirsiniz.

reCAPTCHA kullanımımda saniye başına sorgu sayısı (QPS) veya günlük sınırlar var mı?

Saniyede 1.000'den fazla veya ayda 1.000.000'dan fazla çağrı yapmak istiyorsanız reCAPTCHA Enterprise'ı kullanmanız veya bu formu doldurup istisna onayını beklemeniz gerekir. Bir site anahtarı 1.000 QPS'yi aşarsa bazı istekler işlenmeyebilir. Bir v3 site anahtarı aylık kotasını aşarsa `site_verify` başarısız olabilir ve ayın geri kalanı için 0, 9 statik puanı ile `"Ücretsiz kota aşıldı."` hata mesajı döndürebilir. v3 siteleri kotayı aştığında kullanıcıya gösterilen bir uyarı yoktur. Bir v2 site anahtarı aylık kotasını aşarsa ayın geri kalanında kullanıcılara reCAPTCHA widget'ında aşağıdaki veya benzer bir mesaj gösterilebilir: "Bu site reCAPTCHA kotasını aşıyor." Kota uygulanmadan önce site sahipleri e-posta yoluyla üç kez bilgilendirilir ve reCAPTCHA Enterprise'a geçiş yapmaları için en az 90 gün süre tanınır. Herhangi bir alan için ayda 1.000.000'dan fazla çağrı kullanılıyorsa site anahtarlarının kotayı aştığı kabul edilir. Bu hacim, aynı alan adındaki birden fazla anahtara yayılmışsa da bu durum geçerlidir.

reCAPTCHA rozetini gizlemek istiyorum. Nelere izin verilir?

reCAPTCHA markasını kullanıcı işlemleri akışında görünür bir şekilde eklediğiniz sürece rozeti gizleyebilirsiniz. Lütfen aşağıdaki metni ekleyin:

This site is protected by reCAPTCHA.

Örneğin:

Not: Rozeti gizlemeyi seçerseniz lütfen

.grecaptcha-badge { visibility: hidden; }

reCAPTCHA ile otomatik testler çalıştırmak istiyorum. Ne yapmalıyım?

reCAPTCHA s3 için test ortamlarına yönelik ayrı bir anahtar oluşturun. reCAPTCHA s3 gerçek trafiği görmeye dayandığından puanlar doğru olmayabilir.

reCAPTCHA v2 için aşağıdaki test anahtarlarını kullanın. Her zaman CAPTCHA'sız sonuç alırsınız ve tüm doğrulama istekleri başarılı olur.

  • Site anahtarı: 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI
  • Gizli anahtar: 6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe

reCAPTCHA widget'ı, üretim trafiği için kullanılmadığından emin olmak amacıyla bir uyarı mesajı gösterir.

Sitemde hata ayıklama yaparken reCAPTCHA koduna girmeyi nasıl önleyebilirim?

Sitenizdeki diğer JavaScript'lerde hata ayıklarken reCAPTCHA koduna girmemek için reCAPTCHA komut dosyasını /recaptcha__.+\.js$ tarayıcınızın yoksayılanlar listesine ekleyin. Chrome ile ilgili talimatlar için Özel komut dosyası listesini yoksayma başlıklı makaleyi inceleyin. Diğer tarayıcılarda da benzer özellikler mevcuttur.

Web sitemin trafiği hakkında daha fazla bilgiyi nasıl görebilirim?

reCAPTCHA, Yönetici Konsolu'nda günlük istatistikleri raporlar.

reCAPTCHA'yı dünya genelinde kullanabilir miyim?

Evet, "www.google.com" adresine erişilemediği durumlarda lütfen kodunuzda "www.recaptcha.net" adresini kullanın.

  • İlk olarak, <script src="https://www.google.com/recaptcha/api.js"></script> kodunu <script src="https://www.recaptcha.net/recaptcha/api.js"></script> ile değiştirin.
  • Ardından, sitenizde "www.google.com/recaptcha/" kullanılan diğer her yere aynı işlemi uygulayın.

reCAPTCHA widget'ını veya rozetini özelleştirebilir miyim?

Evet. reCAPTCHA, aşağıda gösterildiği gibi açık ve koyu olmak üzere iki tema sunar. Tema seçmek için grecaptcha.render parametresinde data-theme özelliğini ayarlamanız yeterlidir.

Açık tema:

Koyu tema:

reCAPTCHA s3'ü nasıl özelleştirebilirim?

Görünmez reCAPTCHA için kullanılabilen JavaScript API, v3 için de çalışır. Rozeti yeniden konumlandırma veya temayı değiştirme gibi seçeneklere erişmek için JavaScript API'yi kullanarak reCAPTCHA'yı v3 site anahtarıyla açıkça oluşturmanız yeterlidir.

reCAPTCHA v3'ü bu yöntemle oluştururken size parametresini 'invisible' olarak ayarlamayı ve grecaptcha.execute çağrısı yaparken site anahtarı yerine grecaptcha.render tarafından döndürülen istemci kimliğini kullanmayı unutmayın.

Son zamanlarda reCAPTCHA widget'ım "Geçersiz site anahtarı" hatası vermeye başladı. Neler oluyor?

Bu hatayı görüyorsanız reCAPTCHA site anahtarınız artık geçerli değildir. Etkinleştirmek için lütfen yeni bir anahtar kaydedin ve ilgili sayfadaki talimatları uygulayın.

"Uncaught SecurityError: blocked a frame with origin 'https://www.google.com' from accessing a frame with origin '<alan adınız>'" hatası alıyorum. Ne yapmalıyım?

Bu durum genellikle, son kullanıcı onay kutusunu tıkladıktan bir süre sonra reCAPTCHA widget'ı HTML öğesi programatik olarak kaldırılırsa ortaya çıkar. reCAPTCHA widget'ını sıfırlamak için grecaptcha.reset() JavaScript işlevini kullanmanızı öneririz.

Web sitemde İçerik Güvenliği Politikası (İGP) kullanıyorum. reCAPTCHA ile çalışacak şekilde nasıl yapılandırabilirim?

CSP3 ile belgelenen tek seferlik rastgele sayı tabanlı yaklaşımı kullanmanızı öneririz. Tek seferlik rastgele sayınızı reCAPTCHA api.js komut dosyası etiketine eklediğinizden emin olun. Gerisini biz hallederiz.

Not: reCAPTCHA, destekleyen tarayıcılarda "strict-dynamic" ile de çalışır.

Alternatif olarak, lütfen yönergelere aşağıdaki değerleri ekleyin:

  • script-src https://www.google.com/recaptcha/, https://www.gstatic.com/recaptcha/
  • frame-src https://www.google.com/recaptcha/, https://recaptcha.google.com/recaptcha/
  • connect-src https://www.google.com/recaptcha/

"Localhost, desteklenen alanlar listesinde değil" hatası alıyorum. Ne yapmalıyım?

localhost alanları varsayılan olarak desteklenmez. Geliştirme için bunları desteklemeye devam etmek istiyorsanız site anahtarınızın desteklenen alanlar listesine ekleyebilirsiniz. Desteklenen alan adları listenizi güncellemek için reCAPTCHA Enterprise konsoluna veya reCAPTCHA konsoluna gidin. Geliştirme ve üretim için ayrı anahtarlar kullanmanızı ve geliştirme sitesi anahtarınızda yalnızca localhost'a izin vermenizi öneririz.

Yalnızca iOS 10'da, kullanıcı testi tamamladığında sayfa en alta kaydırılıyor mu?

Bu, Apple tarafında odaklanmayla ilgili bir hatadır ve kendilerine bildirilmiştir. Yalnızca iOS 10'daki kullanıcıları ve yalnızca bazı siteleri etkiler. Bu durumdan etkilendiyseniz geçici bir çözüm olarak reCAPTCHA widget'ını sayfada daha yukarı veya aşağı taşıyabilir ya da reCAPTCHA s3'ü kullanabilirsiniz.

Bilgisayarım veya ağım otomatik sorgular gönderiyor olabilir mi?

Bu sayfaya reCAPTCHA widget'ından yönlendirildiyseniz "Maalesef bilgisayarınız veya ağınız otomatik sorgular gönderiyor olabilir. Kullanıcılarımızı korumak için isteğinizi şu anda işleme alamıyoruz."

Bu durum, iyi niyetli kullanıcıların da başına gelebilir. Bunun birkaç nedeni vardır:

  • Kötüye kullanılan ortak bir ağda olabilirsiniz.
  • İnternet servis sağlayıcınız yakın zamanda size şüpheli bir IP adresi atamış olabilir.
  • Erişmeye çalıştığınız site şu anda yoğun bir saldırı altında olabilir

Bu sorunları gidermek için lütfen olağan dışı trafik yardım sayfasına bakın veya daha sonra tekrar deneyin.

Hangi işlem adları geçerlidir?

İşlemler yalnızca alfanümerik karakterler, eğik çizgiler ve alt çizgiler içerebilir. İşlemler kullanıcıya özel olmamalıdır.