Web Key Alma

• Google ReCaptcha Anahtar Oluşturma sayfasına gidin.

• "Go to reCAPTCHA" butonuna tıklayın.

• "Select a project" butonuna basarak devam edin.

• Proje yoksa New Project butonu ile yeni bir proje oluşturun. 

• Proje adını girerek "Create" butonuna tıklayın.

• Açılan sayfada "Enable" butonuna basın.

• Ardından "Create Key" butonuna tıklayın.
  
  • Display Name alanı, key’lerin listelendiği ekranda nasıl görünmesi isteniyorsa o şekilde doldurulmalıdır.
  • Application Type alanı için Website seçeneği seçilir.
  • Domain List alanına, eklenen sitenin domain adresi girilir. (İsteğe bağlı olarak devre dışı bırakılabilir; ancak güvenlik açısından önerilmez.)
  • Gerekli adımlar tamamlandıktan sonra Next Step butonuna tıklanır.

• Burada isteğe bağlı olarak oluşturulan key ile ilgili seçenekler aktif edilir.

• Bu örnekte test amaçlı bir key oluşturulduğu için aşağıdaki seçimler yapılmıştır. Kendi key’inizi oluştururken ilgili alanları ihtiyaçlarınıza ve kullanım senaryonuza göre değerlendirerek seçim yapabilirsiniz.

• Gerekli adımlar tamamlandıktan sonra sayfanın alt kısmında yer alan Create Key butonuna tıklanarak key oluşturulur. Açılan ekranda geri ok simgesine tıklayarak oluşturduğunuz key’i key listesi sayfasında görüntüleyebilirsiniz.

• Oluşturulan key, sayfada listelenecektir.

Android Key Alma

• ReCaptcha sayfasında key’lerin listelendiği alanda bulunan Create Key butonuna tıklayın.
• Display Name alanını, key’in listede nasıl görünmesini istiyorsanız o şekilde doldurun.
• Application Type alanı için Android seçeneğini seçin.
• Domain List alanına, eklediğiniz sitenin domain adresi girilir. (Domain List alanına ilişkin detaylı açıklamayı bu rehberin sonraki adımlarında bulabilirsiniz.)

• Android seçimi yapıldıktan sonra açılan alana, Kuika platformunda oluşturduğunuz projenin Configuration Manager → Android sekmesinde bulunan Bundle ID bilgisini girin.

• Done butonuna tıklayarak Bundle ID bilgisini kaydedin.

• Gerekli adımları tamamladıktan sonra Next Step butonuna tıklayın.

• Açılan ekranda, oluşturulan key için isteğe bağlı seçenekleri ihtiyaçlarınıza göre belirleyin.

• Son olarak Create Key butonuna tıklayarak key’i oluşturun.

• Oluşturulan key’i görüntülemek için açılan sayfada geri ok simgesine tıklayın. Key, key listesi sayfasında görüntülenecektir.

iOS Key Alma

• ReCaptcha sayfasında key’lerin listelendiği alanda bulunan Create Key butonuna tıklayın.
• Display Name alanını, key’in listede nasıl görünmesini istiyorsanız o şekilde doldurun.
• Application Type alanı için iOS app seçeneğini seçin.
• Domain List alanına, eklediğiniz sitenin domain adresi girilir. (Domain List alanına ilişkin detaylı açıklamayı bu rehberin sonraki adımlarında bulabilirsiniz.)

• Açılan alana, Kuika platformunda oluşturduğunuz projenin Configuration Manager → iOS sekmesinde bulunan Bundle ID bilgisini girin.

• Done butonuna tıklayarak Bundle ID bilgisini kaydedin.

Apple Developer Ayarları

Bundle ID kaydedildikten sonra sayfanın alt kısmında yer alan Apple Developer Settings alanını yapılandırmanız gerekir. Bu bilgiler Apple Developer hesabı üzerinden alınacaktır.

• Aşağıdaki bağlantıya gidin: https://developer.apple.com/account/resources/authkeys/list
• Certificates, Identifiers & Profiles bölümünde Keys sekmesine geçin.

• Yeni bir Private Key (.p8) oluşturmak için + butonuna tıklayın.

• Key Name alanını doldurun ve listeden gerekli seçeneği işaretleyin.

• Register butonuna tıklayın.

• Açılan ekranda Download butonuna tıklayarak .p8 uzantılı dosyayı indirin.

.p8 dosyası yalnızca bir kez indirilebilir. Her private key için tek indirme hakkı bulunmaktadır.

Private Key Bilgilerinin Eklenmesi

• İndirilen .p8 dosyasını, iOS key oluşturma sayfasındaki ilgili alana Browse seçeneği ile yükleyin.

• Key Identifier alanı için, Certificates, Identifiers & Profiles → Keys sekmesinde oluşturduğunuz key’in KEY ID değerini kullanın.
• Team ID alanı için, aynı sayfada sağ üst bölümde adınızın altında yer alan Team ID kodunu girin.

Key Oluşturma

• Apple ayarlarını tamamladıktan sonra Next Step butonuna tıklayın.

• Açılan ekranda, oluşturulan key için isteğe bağlı seçenekleri ihtiyaçlarınıza göre belirleyin.

• Son olarak Create Key butonuna tıklayarak key’i oluşturun.

Key oluşturulduktan sonra açılan sayfada geri ok simgesine tıklayarak oluşturulan key’i key listesi sayfasında görüntüleyebilirsiniz.

Bu aşamaya kadar Web, Android ve iOS key’leri oluşturduk. Şimdi aldığımız key’leri Kuika platformunda kullanacağız. 

Eğer mobil uygulama için kullanacaksanız öncelikle mobil uygulama oluşturmanız gerekmektedir. Mobil uygulama oluşturmak için ilgili içeriğimize ulaşabilirsiniz. 

WEB Entegrasyonu

1. "Configuration Manager" modülüne gidin.

2. "App Settings" sekmesinde ve "Google Recaptcha" alanını bulun. Detaylı bilgi için Configuration Manager içeriğimizi inceleyebilirsiniz. 
3. "Add New" butonuna tıklayın.

4. Açılan pencerede "Name" alanını isteğe göre doldurun.

5. "Site Key" ve "Secret Key" alanlarını, Google tarafından oluşturulan Web Key içindeki değerlerden alın.
6. Details sayfasında Integrations sekmesine gidilir ve Integrate with a third-party service or plugin butonuna tıklanır.

7. Google Recaptcha sayfasına geri dönüp oluşturduğumuz web key içinde Key Details butonuna tıklanır.

8. Details sayfasında Integrations sekmesine gelinir ve “Integrate with a third-party service or plugin” butonuna tıklanır.

9. Gelen penceredeki ise Secret Key olur.
   
   • "ID" değeri -> "Site Key"
   • "Secret Key" değeri -> "Secret Key"

10. Gerekli bilgileri girdikten sonra Configuration Manager modülündeki alana kaydedin. Android ve iOS uygulamalar için de benzer adımları takip ederek konfigürasyon oluşturabilirsiniz. 

Android Entegrasyonu

1. "Configuration Manager" modülüne gidin.

2. "Android" sekmesinde sayfanın en altına inerek "Google Recaptcha" alanını bulun.
3. "Add New" butonuna tıklayın.
4. "Name" alanını isteğe göre doldurun.

5. "Site Key" alanına, oluşturduğunuz Android Key’in "ID" değerini girin.
6. Gerekli bilgileri girdikten sonra kaydedin.

iOS Entegrasyonu

1. "Configuration Manager" modülüne gidin.

2. "iOS" sekmesinde sayfanın en altına inerek "Google Recaptcha" alanını bulun.
3. "Add New" butonuna tıklayın.
4. "Name" alanını isteğe göre doldurun.

5. "Site Key" alanına, oluşturduğunuz iOS Key’in "ID" değerini girin.
6. Gerekli bilgileri girdikten sonra kaydedin.

Hata ve Sorun Giderme

• Doğrulama başarısız oluyorsa: Google Console’da key yapılandırmalarını kontrol edin.
• API çağrılarında hata alıyorsanız: Secret Key’in doğru girildiğinden emin olun.
• reCAPTCHA elementi görünmüyorsa: UI tarafındaki entegrasyonu kontrol edin ve eksik aksiyonları tamamlayın.

Bu adımları takip ederek Google reCAPTCHA’yı başarılı bir şekilde Kuika platformuna entegre edebilir, uygulamanızın güvenliğini artırabilir ve yalnızca gerçek kullanıcıların giriş yapmasını sağlayabilirsiniz.