Puan tabanlı reCAPTCHA anahtarları oluşturma

Uygulamanızı Firebase konsoluna kaydedip reCAPTCHA Enterprise sağlayıcısını kullanmak için uygulamanızın reCAPTCHA anahtarını sağlamanız gerekir. App Check, puan tabanlı reCAPTCHA anahtarlarını kullandığı için kullanıcılar tarafından görünmez. Bu, reCAPTCHA Enterprise sağlayıcının kullanıcıların herhangi bir zamanda bir zorluğu çözmesini gerektirmeyeceği anlamına gelir.

Bu sayfada, aşağıdaki platformlarda kullanılmak üzere bu puan tabanlı anahtarların nasıl oluşturulacağı açıklanmaktadır: web, Android ve Apple. Ayrıca reCAPTCHA Enterprise web uygulamaları ve mobil uygulamalar ile ilgili dokümanlarda daha ayrıntılı talimatlar bulabilirsiniz.

Flutter için projenizin hedeflediği platformlarla ilgili talimatları uygulayabilirsiniz.

Başlamadan önce

Aşağıdaki platformlardaki uygulamalar için puan tabanlı reCAPTCHA anahtarlar oluşturmadan önce bu şartları ve önerileri inceleyin: Web, Android ve Apple.

Gerekli IAM izinleri

Aşağıdaki IAM rolüne sahip olduğunuzdan emin olun: reCAPTCHA Enterprise Yöneticisi (roles/recaptchaenterprise.admin).

Genel öneriler

Bir Firebase projesi için oluşturabileceğiniz reCAPTCHA anahtarlarının sayısıyla ilgili bir sınır yoktur. Firebase projeleri için yaygın kurulumlarda reCAPTCHA anahtarları oluşturmaya yönelik genel öneriler aşağıda verilmiştir:

  • Kayıtlı Firebase uygulamalarınızın her biri için bir anahtar oluşturun. Örneğin:

    • Aynı Firebase projesini paylaşan bir iOS, Android ve web uygulamanız varsa projenizde üç anahtar olmalıdır.

    • Aynı Firebase projesini paylaşan aynı platformda birden fazla uygulamanız varsa projenizde bu uygulamaların her biri için bir anahtar olmalıdır.

  • Geliştirme, hazırlık ve üretim uygulamaları için ayrı anahtarlar oluşturun (Bu varyantların her biri zaten ayrı bir Firebase projesi kullanıyor olmalıdır). Aksi takdirde, reCAPTCHA Enterprise risk analizini üretim dışı ortamlarınızdaki verilerle kirletme riskiyle karşılaşırsınız.

Web

Puan tabanlı anahtar oluşturmak için Google Cloud konsolunu, gcloud CLI veya REST API'yi kullanabilirsiniz.

Web siteleri için reCAPTCHA anahtarı, belirttiğiniz alan adlarına ve alt alan adlarına özgüdür. Web sitenizi birden fazla alandan sunuyorsanız birden fazla alan belirtebilirsiniz. Bir alan adı (örneğin, examplepetstore.com) belirtirseniz alt alan adlarını (örneğin, subdomain.examplepetstore.com) belirtmeniz gerekmez.

Google Cloud konsolu

  1. Google Cloud konsolunda Sahtekarlığa Karşı Koruma sayfasına gidin (reCAPTCHA anahtarlarını burada ayarlarsınız).

  2. Doğru projede olduğunuzdan emin olun (ekranın üst kısmındaki proje seçiciye bakın).

  3. Anahtar oluştur'u tıklayın.

  4. Görünen ad alanına anahtar için bir görünen ad girin.

  5. Application type (Uygulama türü) için Web'i seçin.

  6. Alanınız ve alt alanlarınızın anahtarını korumak için Alan doğrulamasını devre dışı bırak açma/kapatma düğmesinin kapalı olduğundan emin olun.

  7. Alan listesi bölümünde aşağıdakileri yapın:

    1. Alan ekle'yi tıklayın.

    2. Alan alanına alanınızın adını girin.

    3. (İsteğe bağlı) Ek bir alan eklemek için Alan ekle'yi tıklayın ve başka bir alan adı girin.

      • App Check 250'den fazla alanda yayınlanan web uygulamalarını desteklemez.

      • Üretimde kullanılan (veya kullanılacak olan) bir reCAPTCHA anahtarına asla localhost alanını eklemeyin.

  8. (İsteğe bağlı) Üretim dışı uygulamanız için bir test anahtarı oluşturuyorsanız ve anahtarın, uygulama için herhangi bir değerlendirme oluşturulduğunda döndürmesini istediğiniz bir puan belirtmek istiyorsanız şunları yapın:

    1. Ek ayarlar adımına erişmek için Sonraki adım (isteğe bağlı)'ı tıklayın.

    2. Giriş sorgulamalarını kullanacak mısınız? ayarını açmayın.

    3. Bu anahtarı yalnızca test amacıyla mı oluşturuyorsunuz? seçeneğini etkinleştirin, ardından 0 ile 1,0 arasında bir puan belirtmek için Puanı ayarla kaydırma çubuğunu kullanın.

  9. Anahtar oluştur'u tıklayın.

Yeni oluşturulan anahtar, Google Cloud konsolundaki reCAPTCHA anahtarları sayfasında listelenir.

gcloud CLI

gcloud CLI kullanarak puana dayalı bir anahtar oluşturmak için reCAPTCHA Enterprise belgelerindeki talimatları uygulayın.

REST

REST API'yi kullanarak puana dayalı bir anahtar oluşturmak için reCAPTCHA Enterprise belgelerindeki talimatları uygulayın.

Android

Puan tabanlı anahtar oluşturmak için Google Cloud konsolunu, gcloud CLI veya REST API'yi kullanabilirsiniz.

Google Cloud konsolu

  1. Google Cloud konsolunda Sahtekarlığa Karşı Koruma sayfasına gidin (reCAPTCHA anahtarlarını burada ayarlarsınız).

  2. Doğru projede olduğunuzdan emin olun (ekranın üst kısmındaki proje seçiciye bakın).

  3. Anahtar oluştur'u tıklayın.

  4. Görünen ad alanına anahtar için bir görünen ad girin.

  5. Application type (Uygulama türü) için Android'i seçin.

  6. Android uygulamanızın anahtarını korumak için Paket adı doğrulamasını devre dışı bırak açma/kapatma düğmesinin kapalı olduğundan emin olun.

  7. Android paketi liste bölümünde aşağıdakileri yapın:

    1. Android paketi ekle'yi tıklayın.

    2. Android paketi alanına Android uygulamanızın paket adını girin (örneğin, com.example.my_app).

      • Firebase projenizde Firebase Android uygulamanızı oluştururken sağladığınız paket adını girdiğinizden emin olun. Paket adı değeri büyük/küçük harfe duyarlıdır.

      • App Check için her paket adı yalnızca tek bir reCAPTCHA anahtarıyla eşleşebilir.

  8. Google Play Store dışında diğer uygulama mağazalarında da bulunan bir uygulama için anahtar oluşturmak istiyorsanız Google Play Store dışında dağıtılan uygulamaları destekle açma/kapatma düğmesini etkinleştirin.

  9. (İsteğe bağlı) Üretim dışı uygulamanız için bir test anahtarı oluşturuyorsanız ve anahtarın, uygulama için herhangi bir değerlendirme oluşturulduğunda döndürmesini istediğiniz bir puan belirtmek istiyorsanız şunları yapın:

    1. Ek ayarlar adımına erişmek için Sonraki adım (isteğe bağlı)'ı tıklayın.

    2. Giriş sorgulamalarını kullanacak mısınız? ayarını açmayın.

    3. Bu anahtarı yalnızca test amacıyla mı oluşturuyorsunuz? seçeneğini etkinleştirin, ardından 0 ile 1,0 arasında bir puan belirtmek için Puanı ayarla kaydırma çubuğunu kullanın.

  10. Anahtar oluştur'u tıklayın.

Yeni oluşturulan anahtar, Google Cloud konsolundaki reCAPTCHA anahtarları sayfasında listelenir.

gcloud CLI

gcloud CLI kullanarak puana dayalı bir anahtar oluşturmak için reCAPTCHA Enterprise belgelerindeki talimatları uygulayın.

REST

REST API'yi kullanarak puana dayalı bir anahtar oluşturmak için reCAPTCHA Enterprise belgelerindeki talimatları uygulayın.

Apple platformları

Puan tabanlı anahtar oluşturmak için Google Cloud konsolunu, gcloud CLI veya REST API'yi kullanabilirsiniz.

Google Cloud konsolu

  1. Google Cloud konsolunda Sahtekarlığa Karşı Koruma sayfasına gidin (reCAPTCHA anahtarlarını burada ayarlarsınız).

  2. Doğru projede olduğunuzdan emin olun (ekranın üst kısmındaki proje seçiciye bakın).

  3. Anahtar oluştur'u tıklayın.

  4. Görünen ad alanına anahtar için bir görünen ad girin.

  5. Application type (Uygulama türü) için iOS'i seçin.

  6. Apple platformları uygulamanızın anahtarını korumak için Paket kimliği doğrulamasını devre dışı bırak açma/kapatma düğmesinin kapalı olduğundan emin olun.

  7. iOS paket kimliği listesi bölümünde aşağıdakileri yapın:

    1. iOS paketi kimliği ekle'yi tıklayın.

    2. Paket Kimliği alanına uygulamanızın paket kimliğini girin (örneğin, com.example.my_app).

      • Firebase projenizde Firebase Apple uygulamanızı oluştururken sağladığınız paket kimliğini girdiğinizden emin olun. Paket kimliği değeri büyük/küçük harfe duyarlıdır.

      • App Check için her paket kimliği yalnızca tek bir reCAPTCHA anahtarıyla eşleşebilir.

    3. (İsteğe bağlı) Ek bir paket kimliği eklemek için iOS paketi kimliği ekle'yi tıklayın ve başka bir paket kimliği girin.

  8. Apple Geliştirici ayarlarını sağlayın.

    reCAPTCHA Enterprise'ın trafiğiniz için daha doğru risk puanları sağlamasına olanak tanıdığı için bu verileri sağlamanızı önemle tavsiye ederiz.

    Aşağıdaki bilgileri girin:

    • Özel anahtar (.p8): Bu, Apple Developer Center'daki Certificates, Identifiers & Profiles (Sertifikalar, Tanımlayıcılar ve Profiller) bölümünde oluşturulur.

    • Anahtar tanımlayıcısı: Apple geliştirici anahtar tanımlayıcısı (10 karakterlik dize).

    • Ekip kimliği: Uygulamanızı oluşturmak için kullanılan temel hazırlık profilinin sahibi olan Apple ekip kimliği (10 karakterlik dize).

  9. (İsteğe bağlı) Üretim dışı uygulamanız için bir test anahtarı oluşturuyorsanız ve anahtarın, uygulama için herhangi bir değerlendirme oluşturulduğunda döndürmesini istediğiniz bir puan belirtmek istiyorsanız şunları yapın:

    1. Ek ayarlar adımına erişmek için Sonraki adım (isteğe bağlı)'ı tıklayın.

    2. Giriş sorgulamalarını kullanacak mısınız? ayarını açmayın.

    3. Bu anahtarı yalnızca test amacıyla mı oluşturuyorsunuz? seçeneğini etkinleştirin, ardından 0 ile 1,0 arasında bir puan belirtmek için Puanı ayarla kaydırma çubuğunu kullanın.

  10. Anahtar oluştur'u tıklayın.

Yeni oluşturulan anahtar, Google Cloud konsolundaki reCAPTCHA anahtarları sayfasında listelenir.

gcloud CLI

gcloud CLI kullanarak puana dayalı bir anahtar oluşturmak için reCAPTCHA Enterprise belgelerindeki talimatları uygulayın.

REST

REST API'yi kullanarak puana dayalı bir anahtar oluşturmak için reCAPTCHA Enterprise belgelerindeki talimatları uygulayın.