Sık Sorulan Sorular

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

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

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

Evet, hem reCAPTCHA'yı (Enterprise harici sürüm) hem de reCAPTCHA Enterprise'ı kullanabilirsiniz. Genellikle üçüncü taraf çözümünde ortak anahtarınızın yanı sıra gizli anahtarınızı veya API anahtarınızı ister. Gizli anahtarınızı ve API anahtarınızı yalnızca güvenilir üçüncü taraflara sağladığınızdan emin olun.

v2 veya v3'ten reCAPTCHA Enterprise'a nasıl geçiş yapılır?

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

reCAPTCHA v2 mi v3 mü kullanmalıyım?

reCAPTCHA v3, trafikleri hakkında daha fazla veri isteyen site sahipleri için tasarlanmıştır. Daha fazla bilgi için reCAPTCHA v3 geliştirici kılavuzunu inceleyin.

v2'de güvenlik ve kullanılabilirliği destekliyoruz.

reCAPTCHA v2 ve v3 farklılıkları hakkında daha fazla bilgi için sürüm karşılaştırmasına 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 ayarlandığı www.google.com alanını kullanmak istemiyorsanız bunun yerine www.recaptcha.net adresini kullanabilirsiniz.

reCAPTCHA'yı kullanımımda QPS veya günlük sınırlar var mı?

Saniyede 1.000'den veya ayda 1.000.000'den fazla çağrı yapmak istiyorsanız reCAPTCHA Enterprise'ı kullanmanız ya da bu formu doldurup istisna onayı 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, ayın geri kalanı için 0,9 statik puan ve"Ücretsiz kota aşımı" hata mesajı döndürerek açılamayabilir. v3 siteleri kotayı aştığında kullanıcılar tarafından görülebilen bir uyarı yoktur. Bir v2 site anahtarı aylık kotasını aşarsa reCAPTCHA widget'ında kullanıcılara ayın geri kalanında şu veya benzer bir mesaj gösterilebilir: "Bu site reCAPTCHA kotasını aşıyor." Kota uygulanmadan önce site sahiplerine e-posta ile üç kez bilgi verilir ve reCAPTCHA Enterprise'a geçişleri için en az 90 gün süre tanınır. Herhangi bir alan için ayda 1.000.000'den fazla çağrı kullanılıyorsa site anahtarları kotayı aşar. Bu, bu birimin aynı alan üzerindeki birden fazla anahtara yayılmasını da kapsar.

reCAPTCHA rozetini gizlemek istiyorum. Nelere izin verilir?

Kullanıcı işlemleri akışında reCAPTCHA markasına görsel olarak yer verdiğiniz sürece rozeti gizleyebilirsiniz. Lütfen aşağıdaki metni ekleyin:

This site is protected by reCAPTCHA and the Google
    <a href="https://policies.google.com/privacy">Privacy Policy</a> and
    <a href="https://policies.google.com/terms">Terms of Service</a> apply.

Örneğin:

Not: Rozeti gizlemeyi tercih ederseniz lütfen

.grecaptcha-badge { visibility: hidden; }
uygulamasını kullanın

reCAPTCHA ile otomatik testler yapmak istiyorum. Ne yapmalıyım?

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

reCAPTCHA v2 için aşağıdaki test anahtarlarını kullanın. Her zaman "CAPTCHA yok" mesajı 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 için bir uyarı mesajı gösterir.

Sitemde hata ayıklarken reCAPTCHA koduna girmekten nasıl kaçınabilirim?

Sitenizdeki diğer JavaScript kodlarında 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 bir komut dosyası listesini yoksayma başlıklı makaleyi inceleyin. Benzer özellikler başka tarayıcılarda da mevcuttur.

Web sitemin trafiği hakkında nasıl daha fazla bilgi edinebilirim?

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

reCAPTCHA'yı dünya genelinde kullanabilir miyim?

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

  • Öncelikle <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/" adresini kullanan diğer her yerde aynı yöntemi 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 v3'ü nasıl özelleştirebilirim?

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

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

Kısa süre önce reCAPTCHA widget'ım "Geçersiz site anahtarı" göstermeye başladı. Sorun nedir?

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 kaydettirin ve bu sayfadaki instructions uygulayın.

Yakalanmamış bir SecurityError alıyorum: "https://www.google.com" kaynağı olan bir çerçevenin "&ltyour domain&gt" kaynağına sahip bir çerçeveye erişmesi engellendi. Ne yapmalıyım?

Bu durum genellikle reCAPTCHA widget HTML öğesi, son kullanıcı onay kutusunu tıkladıktan bir süre sonra programlı 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. Bunu reCAPTCHA ile çalışacak şekilde nasıl yapılandırabilirim?

CSP3'te belgelenen rastgele olmayan yaklaşımı kullanmanızı öneririz. Tek seferlik rastgele verilerinizi reCAPTCHA api.js komut dosyası etiketine eklediğinizden emin olun. Gerisini biz hallederiz.

Not: reCAPTCHA, desteklediği tarayıcılarda 'strict-dynamic' ile de çalışır.

Alternatif olarak, lütfen aşağıdaki değerleri yönergelere 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/

"Localhost is the list of supported domains" (Yerel barındırıcı, desteklenen alanlar listesinde yok) hatası alıyorum. Ne yapmalıyım?

localhost alanları varsayılan olarak desteklenmez. Bu alanları geliştirme için desteklemeye devam etmek istiyorsanız site anahtarınız için desteklenen alanlar listesine ekleyebilirsiniz. Desteklenen alanlar 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ı sorgulamayı tamamladığında sayfa en alta mı kaydırılıyor?

Bu hata, Apple'a bildirdiğimiz konuyla ilgili olarak gündeme geliyor. Yalnızca iOS 10 sürümüne sahip kullanıcıları ve sadece bazı sitelerdeki kullanıcıları etkiler. Bu durumdan etkileniyorsanız reCAPTCHA widget'ını sayfada daha üst veya daha alta taşımak ya da reCAPTCHA v3'ü kullanmak geçici bir çözümdür.

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

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 amacıyla isteğinizi şu anda işleme alamıyoruz."

Maalesef bu durumun iyi bir kullanıcı olmasının birkaç nedeni olabilir:

  • Kötüye kullanım amaçlı olarak kullanılan paylaşılan bir ağda olabilirsiniz
  • İnternet servis sağlayıcınız kısa süre önce size şüpheli bir IP adresi atamış olabilir
  • Erişmeye çalıştığınız site şu anda ağır saldırı altında olabilir

Bu sorunları gidermek için lütfen normal trafikle ilgili yardım sayfasına göz atın veya daha sonra tekrar deneyin.

Hangi işlem adları geçerlidir?

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