Kullanıcı Kılavuzu

Verify Recaptcha Token

1/8/25
Verify Recaptcha Token

Kuika’nın Verify Recaptcha Token aksiyonu, uygulamanızda güvenlik önlemlerini artırmak için kullanılır. Kullanıcının reCAPTCHA doğrulamasından aldığı token’ı kontrol ederek, işlemi gerçekleştirenin gerçek bir kullanıcı olduğunu doğrulamanıza yardımcı olur. Bu aksiyon sayesinde spam, bot veya kötü niyetli yazılım kaynaklı istekler filtrelenebilir.

Bu aksiyonun doğru çalışabilmesi için, Google reCAPTCHA anahtar bilgilerinin Configuration Manager modülü üzerinden sisteme tanımlanmış olması gerekir. Örneğin, kullanıcı bir kayıt formunu doldurduğunda ve reCAPTCHA doğrulamasını geçtiğinde, bu aksiyon ile reCAPTCHA token’ı Google sunucuları üzerinden doğrulanır. Eğer doğrulama başarılıysa işlem devam eder; başarısızsa sistem, işlemi engelleyerek kötü niyetli kullanımı önler.

Teknik Özellikler

  • reCAPTCHA Token Doğrulama: Kullanıcının istemci tarafında aldığı reCAPTCHA token’ı, sunucu tarafında doğrulanır.
  • Güvenlik Katmanı: Formlar veya işlem tetikleyiciler üzerinde ek güvenlik kontrolü sağlar.
  • Web & Mobil Uygulama Desteği: Aksiyon, hem web hem de mobil uygulamalarla uyumludur.
  • Symbol Picker: Token değeri, Symbol Picker aracılığıyla dinamik kaynaklardan (Form Component, Screen Input, Action Result vb.) alınabilir.

Verify Recaptcha Token Aksiyonu Uygulama Adımları

UI Design’da Aksiyonu Tanımlama

  • Kuika platformunda projenizi açın.
  • UI Design modülüne geçin ve ilgili ekranı seçin.
  • Bir buton oluşturun (örneğin “Gönder” gibi).
  • Butonu seçin ve + ADD ACTION menüsünden, işlem yapılacak olaya göre (Initial Actions, OnClick, OnBlur vb.)  Verification → Verify Recaptcha Token aksiyonunu ekleyin.

Aksiyon Parametrelerini Yapılandırma

  • Token (String - zorunlu): Kullanıcının istemci tarafında tamamladığı reCAPTCHA işlemi sonucunda oluşan token değeridir. Genellikle aşağıdaki veri kaynaklarından biri ile Symbol Picker üzerinden bağlanır:
    • Action Result
    • Current
    • Form Component
    • Screen Input
    • Fixed (sabit değer)

Kullanım Senaryosu: Form Gönderimi Öncesi Bot Kontrolü

Bir üyelik formunu dolduran kullanıcıya reCAPTCHA doğrulaması yaptırılır. Kullanıcı "Üye Ol" butonuna bastığında önce Verify Recaptcha Token aksiyonu çalıştırılır. Token doğrulanırsa üyelik işlemi devam eder, aksi takdirde hata mesajı gösterilir.

Kullanıcı Kaydı Öncesi reCAPTCHA Doğrulama Aksiyonu Ekleme

  • UI Design modülüne girin ve sol kenardaki Elements panelinden bir Button elementini sürükleyip bırakın.
  • Properties panelinde, butonun Label kısmına “Üye Ol” gibi bir ifade girin.
  • İlgili butonu seçin ve + ADD ACTION menüsünden OnClick → Verification → Verify Recaptcha Token aksiyonunu ekleyin.

Verify Recaptcha Token Aksiyonunu Yapılandırma

  • Token: Bu değer dinamik olarak reCAPTCHA bileşeninden alınabilir.

Bu yapılandırmayla, kullanıcı butona tıkladığında reCAPTCHA doğrulaması otomatik olarak gerçekleştirilir. Eğer doğrulama başarılıysa işlem devam eder, değilse durdurulur.

Verify Recaptcha Token Aksiyonu İleri Seviye Özelleştirmeler

  • Koşullu Akış ile Güvenlik Kontrolü: 

Doğrulama sonucuna bağlı olarak

  • Başarılıysa → veri gönderme, kayıt oluşturma, sayfa yönlendirme gibi işlemler yapılabilir.
  • Başarısızsa → kullanıcıya hata mesajı gösterilebilir.
  • reCAPTCHA Versiyon Uyumluluğu:

Google reCAPTCHA v2 ve v3 desteği ile token değerleri uygun biçimde kullanılabilir. Formun yapısına uygun olarak görünür (v2) veya görünmez (v3) doğrulama stratejileri uygulanabilir.

  • Token Kaynağını Dinamik Belirleme:

Token, aşağıdaki yollarla alınabilir:

  • Form elementinden (örneğin bir reCAPTCHA widget)
  • Dış API’den
  • Action Result sonucundan
  • Fixed alanından manuel olarak girilerek test senaryosu çalıştırma

Teknik Riskler 

  • Geçersiz Token Kullanımı: Token süresi geçmiş veya sahte olabilir; doğrulama başarısız olur.
  • İstemci-Sunucu Uyumsuzluğu: Uygulama ortamı reCAPTCHA sürümüyle uyumlu olmalıdır (örneğin, v3 destekliyse v3 token alınmalı).
  • Kapsam Dışı Doğrulama: Aksiyonun sadece gerekli alanlarda çalışması sağlanmalı; her buton veya aksiyona eklenmesi gerekmez.

Verify Recaptcha Token aksiyonu, uygulamanızda reCAPTCHA doğrulamasını entegre ederek güvenlik düzeyini artırmanızı sağlar. Spam ve botlara karşı güçlü bir savunma katmanı sunar ve yalnızca gerçek kullanıcıların işlem yapmasına olanak tanır. Web ve mobil uygulamalardaki desteği sayesinde, her türlü kullanıcı etkileşiminde kolayca uygulanabilir ve gelişmiş güvenlik senaryolarına uyarlanabilir.

İlişkili diğer içerikler

Sözlük

No items found.

Alt Başlıklar