Web uygulamalarında reCAPTCHA Enterprise ile Uygulama Kontrolü'nü kullanmaya başlayın

Bu sayfada, App Check reCAPTCHA Enterprise sağlayıcısı. App Check özelliğini etkinleştirerek projenizin Firebase kaynaklarına yalnızca uygulamanız erişebilir. Bkz. Bu özelliğe genel bakış.

App Check, reCAPTCHA Enterprise puana dayalı site anahtarlarını kullanır. Bu anahtarlar: görmemesini sağlayabilirsiniz. reCAPTCHA Enterprise sağlayıcısı, istedikleri zaman bir sorunu çözmelerine yardımcı olur.

App Check uygulamasını kendi özel sağlayıcınızla kullanmak istiyorsanız Özel bir App Check sağlayıcısı uygulayın.

1. Firebase projenizi oluşturun

  1. Henüz yapmadıysanız Firebase'i JavaScript projenize ekleyin olabilir.

  2. reCAPTCHA Enterprise'ı açın. bölümüne gidip aşağıdaki işlemleri yapın:

    1. reCAPTCHA Enterprise API'yi etkinleştirmeniz istenirse etkinleştirin.
    2. Web sitesi türünde bir anahtar oluşturun. Her işlem için ayrı bir web uygulamanızı barındırır. "Onay kutusu sorgulaması kullan"dan ayrıl seçenek seçilmedi.

  3. App Check uygulamasını reCAPTCHA Enterprise ile kullanmak için uygulamalarınızı kaydedin içerik sağlayıcısındaki App Check Firebase konsolu. Aldığınız site anahtarını önceki adım.

    Genellikle projenizdeki tüm uygulamaları kaydetmeniz gerekir çünkü bir kez bir Firebase ürünü için zorunlu kılmayı etkinleştirdiğinizde, yalnızca kayıtlı uygulamalar arka uç kaynaklarına erişmek için kullanılabilir.

  4. İsteğe bağlı: Uygulama kayıt ayarlarında özel bir geçerlilik süresi ayarlayın. Sağlayıcı tarafından verilen App Check jeton için (TTL). TTL'yi ayarlayabilirsiniz. 30 dakika ile 7 gün arasında herhangi bir değere ayarlayabilirsiniz. Bu değeri değiştirirken, dikkate almanız gerekir:

    • Güvenlik: Daha kısa TTL'ler daha güçlü güvenlik sağlar, çünkü bir jetonun sızdırıldığı veya ele geçirildiği bir pencerenin ele alacağız.
    • Performans: Daha kısa TTL'ler, uygulamanızın onay sürecini daha fazla yapacağı anlamına gelir. alabilir. Uygulama onay işlemi, ağa gecikmeyi eklediğinden her gerçekleştirildiğinde kısa bir TTL, performansı etkileyebilir. en iyi yoludur.
    • Kota ve maliyet: Daha kısa TTL'ler ve sık yapılan yeniden onay süreleri daha hızlı sunmamızı sağlar ve ücretli hizmetler için maliyeti daha yüksek olabilir. Bkz. Kotalar ve kontrol edin.

    Şu alanın varsayılan TTL'si: 1 saat çoğu uygulama için makul bir değerdir. App Check kitaplığının yenilendiğini unutmayın jeton sayısını TTL'nin yaklaşık yarısına kadar uzatabilirsiniz.

2. App Check kitaplığını uygulamanıza ekleyin

Henüz eklemediyseniz Firebase'i web uygulamanıza ekleyin. Emin olun App Check kitaplığını içe aktarın.

3. Başlat: App Check

Herhangi bir dosyaya erişmeden önce aşağıdaki ilk kullanıma hazırlama kodunu uygulamanıza ekleyin Firebase hizmetleri. reCAPTCHA Enterprise site anahtarınızı iletmeniz gerekir. Cloud Console'da oluşturduğunuz dosyayı activate() konumuna ekleyin.

Web

import { initializeApp } from "firebase/app";
import { initializeAppCheck, ReCaptchaEnterpriseProvider } from "firebase/app-check";

const app = initializeApp({
  // Your Firebase configuration object.
});

// Create a ReCaptchaEnterpriseProvider instance using your reCAPTCHA Enterprise
// site key and pass it to initializeAppCheck().
const appCheck = initializeAppCheck(app, {
  provider: new ReCaptchaEnterpriseProvider(/* reCAPTCHA Enterprise site key */),
  isTokenAutoRefreshEnabled: true // Set to true to allow auto-refresh.
});

Web

firebase.initializeApp({
  // Your Firebase configuration object.
});

// Create a ReCaptchaEnterpriseProvider instance using your reCAPTCHA Enterprise
// site key and pass it to activate().
const appCheck = firebase.appCheck();
appCheck.activate(
  new firebase.appCheck.ReCaptchaEnterpriseProvider(
    /* reCAPTCHA Enterprise site key */
  ),
  true // Set to true to allow auto-refresh.
);

Sonraki adımlar

App Check kitaplığı uygulamanıza yüklendikten sonra kitaplığı dağıtın.

Güncellenen istemci uygulaması, App Check jeton göndermeye başlayacak. Firebase'e istek gönderir, ancak Firebase ürünleri için jeton gerekmez App Check Firebase konsolu.

Metrikleri izleyin ve yaptırımı etkinleştirin

Ancak, zorunlu kılmayı etkinleştirmeden önce, bu işlemin Mevcut güvenli kullanıcılarınızı kesintiye uğratabilir. Öte yandan, benzer bir Uygulama kaynaklarınızın şüpheli kullanımı durumunda, zorunlu kılma ayarını etkinleştirerek gerekir.

Bu kararı vermenize yardımcı olmak içinApp Check hizmetler:

App Check zorunlu kılmayı etkinleştir

App Check özelliğinin kullanıcılarınızı nasıl etkileyeceğini anladığınızda Devam ederseniz App Check yaptırımını etkinleştirebilirsiniz:

Hata ayıklama ortamlarında App Check kullanın

Uygulamanızı App Check için kaydettikten sonra App Check normalde geçerli olarak sınıflandıramadığı bir ortamda bulunuyorsa, Örneğin, geliştirme sırasında yerel olarak veya sürekli entegrasyon (CI) aracılığıyla uygulamanızın hata ayıklama derlemesini oluşturmak için App Check gerçek bir onay sağlayıcısı yerine hata ayıklama sağlayıcısı ile çalışıyor.

Web uygulamalarında hata ayıklama sağlayıcısı ile App Check kullanma bölümüne bakın.

Maliyetle ilgili not

App Check, kullanıcının kimliğini doğrulamak için sizin adınıza bir değerlendirme oluşturur web uygulamanızı çalıştıran bir tarayıcı şunu yenilediğinde yanıt jetonu App Check jetonu. Oluşturulan her değerlendirme için projenizden ücret alınacak ücretsiz kotayı aştı. reCAPTCHA fiyatlandırmasına bakın. inceleyebilirsiniz.

Varsayılan olarak web uygulamanız bu jetonu her 1 saatte iki kez yeniler. Alıcı: uygulamanızın App Check jetonları ne sıklıkta yenileyeceğini (ve dolayısıyla sıklıkla yeni değerlendirmeler oluşturulduğu durumlarda) TTL'lerini yapılandırın.