Kuika’nın ReCaptcha elementi, uygulamaları otomatik işlemlerden ve botlardan korumak için kullanılır. Kullanıcı dostu bir doğrulama süreci sunarak yalnızca gerçek kullanıcıların erişimini sağlar. Özellikle formlar ve giriş ekranlarında güvenliği artırmak için idealdir.

Kullanım Alanları

• Giriş Ekranları → Bot girişlerini engellemek.
• Kayıt Formları → Spam hesapların oluşmasını önlemek.
• Yorum / İletişim Formları → Otomatik mesajlara karşı koruma sağlamak.
• Ödeme Adımları → Gerçek kullanıcı doğrulamasını ek güvenlik katmanı olarak sağlamak.

Kullanım Senaryosu – Kayıt Formu Koruma

Bir kayıt formunda kullanıcı, bilgilerini doldurduktan sonra formu göndermeden önce ReCaptcha doğrulaması yapar.

• Eğer doğrulama geçerse → Form gönderilir.
• Eğer doğrulama başarısızsa → Kullanıcıya hata mesajı gösterilir.

UI Design Modülü İşlemleri

1. UI Design modülüne gidin.
2. Sol kenardaki Elements > Interactive kategorisinden ReCaptcha elementini seçin.
3. Ekrana sürükleyip bırakın.

ReCaptcha Kullanımı İçin Gereken Ayarlar

ReCaptcha elementini kullanabilmek için, her platform (Web, Android, iOS) için ayrı Site Key ve Secret Key alınmalıdır. Bu anahtarlar Google ReCaptcha Console üzerinden oluşturulur ve Kuika’daki Configuration Manager modülüne eklenir.

Google Console ReCaptcha Key Alma

• Web için
  
  • Google ReCaptcha sayfasına gidin → “Create Key” seçin.
  • Platform Type: Website.
  • Domain ekleyin → Site Key ve Secret Key oluşturun.
• Android için
  
  • Platform Type: Android app.
  • Bundle ID girin.
  • Site Key oluşturun ve kaydedin.
• iOS için
  
  • Platform Type: iOS app.
  • Bundle ID girin.
  • Apple Developer hesabına girerek .p8 Private Key dosyası oluşturun.
  • Key ID ve Team ID bilgilerini alın.
  • ReCaptcha key oluşturun.

Kuika ReCaptcha Entegrasyonu

1. Configuration Manager modülüne gidin.
2. İlgili platformu seçin (Web / Android / iOS).
3. Google Recaptcha alanında → Add New tıklayın.

• Name → İsteğe göre doldurun.
• Site Key → Google Console’daki Site Key.
• Secret Key → Google Console’daki Secret Key.

4. Kaydedin.

ReCaptcha Doğrulama Aksiyonları

1. UI Design modülünde ReCaptcha elementini seçin.
2. Sağ kenarda ADD VALIDATION butonuyla doğrulama ekleyin.
3. Doğrulama yapılacak butona:
   
   • OnClick → Verification → Verify ReCaptcha Token ekleyin.
   • Eğer çıkış yapılması gerekiyorsa → OnClick → Logout ekleyin.

Senaryo Adımı Tamamlandığında

• Kullanıcı formu doldurduğunda ReCaptcha doğrulaması çalışır.
• Doğrulama geçerse → işlem devam eder.
• Başarısızsa → kullanıcıya uyarı verilir ve işlem iptal olur.

Kısıtlamalar

• Web, Android ve iOS için ayrı key’ler alınmalıdır.
• .p8 dosyası yalnızca bir kez indirilebilir, kaybolmaması gerekir.
• Yanlış domain veya Bundle ID girildiğinde doğrulama çalışmaz.

Hata ve Sorun Giderme

• Doğrulama başarısızsa → Google Console’daki domain/bundle ayarlarını kontrol edin.
• API hatası → Secret Key’in yanlış girilmiş olması muhtemeldir.
• ReCaptcha elementi görünmüyorsa → UI tarafındaki entegrasyonu kontrol edin.

İpuçları ve Best Practices

Sık yapılan hata: Tek key ile tüm platformlarda doğrulama beklenmesi → Her platform için ayrı key gerekir.

• Formlarda ReCaptcha kullanarak hem güvenlik hem de spam koruması sağlanmalıdır.
• Kullanıcı deneyimi için doğrulama mesajlarını kısa ve anlaşılır yapın.