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

Bu sayfada, reCAPTCHA Enterprise sağlayıcısını kullanarak bir web uygulamasında App Check'ü nasıl etkinleştireceğiniz gösterilmektedir. App Check seçeneğini etkinleştirdiğinizde, projenizin Firebase kaynaklarına yalnızca uygulamanızın erişebilmesini sağlarsınız. 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 yapabilirsiniz.

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 bunu yapın.
   2. Web sitesi türü anahtarı oluşturun. Web uygulamanızı barındırdığınız alanları belirtmeniz gerekir. "Onay kutusu meydan okuması kullan" seçeneğini seçilmemiş bırakın.

3. Firebase konsolunun App Check bölümünde, uygulamalarınızı reCAPTCHA Enterprise sağlayıcısıyla App Check kullanmak için kaydedin. Önceki adımda aldığınız site anahtarını sağlamanız gerekir.

   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 30 dakika ile 7 gün arasında herhangi bir değere ayarlayabilirsiniz. Bu değeri değiştirirken aşağıdaki dengeleri göz önünde bulundurun:

   • Güvenlik: Daha kısa TTL'ler, sızdırılan veya müdahale edilen jetonun bir saldırgan tarafından kötüye kullanılabileceği süreyi kısalttığı için daha güçlü güvenlik sağlar.
   • 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 ekleme

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

3. App Check başlatılıyor

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

Web

Şu konuda daha fazla bilgi edinin: ağaçta sallanabilir modüler Web API'si Ad alanı API'sinden yükseltme yapın.

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.
);

Not: SDK, varsayılan olarak App Check jetonlarını otomatik olarak yenilemez. Bu işlev, saniye olarak true sağlanarak açıkça etkinleştirilmelidir. bağımsız değişkeni activate() olarak veya firebase.appCheck().setTokenAutoRefreshEnabled(true). Daha fazla bilgi için App Check referans dokümanlarını inceleyin.

Sonraki adımlar

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

Güncellenen istemci uygulaması, Firebase'e gönderdiği her istekle birlikte App Check jetonları göndermeye başlar. Ancak Firebase konsolunun App Check bölümünde yaptırımı etkinleştirene kadar Firebase ürünleri, jetonların geçerli olmasını gerektirmez.

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. Diğer yandan, uygulama kaynaklarınızın şüpheli bir şekilde kullanıldığını görüyorsanız yaptırımı daha erken etkinleştirmek isteyebilirsiniz.

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

• Realtime Database, Cloud Firestore, Cloud Storage, Firebase Data Connect (Önizleme), Authentication (beta) ve Vertex AI in Firebase (Önizleme) için App Check istek metriklerini izleyin.
• Cloud Functions için App Check istek metriklerini izleyin.

App Check yaptırımını etkinleştirme

App Check'ün kullanıcılarınızı nasıl etkileyeceğini anladıktan ve devam etmeye hazır olduğunuzda App Check yaptırımını etkinleştirebilirsiniz:

• Şunun için App Check yaptırımını etkinleştir: Realtime Database, Cloud Firestore, Cloud Storage, Firebase Data Connect (Önizleme), Authentication (beta) ve Vertex AI in Firebase (Önizleme).
• Cloud Functions için App Check yaptırımını etkinleştirin.

Hata ayıklama ortamlarında App Check kullanma

Uygulamanızı App Check'e kaydettikten sonra, uygulamanızı App Check'in normalde geçerli olarak sınıflandırmayacağı bir ortamda (ör. geliştirme sırasında yerel olarak veya sürekli entegrasyon (CI) ortamından) çalıştırmak istiyorsanız gerçek bir doğrulama sağlayıcısı yerine App Check hata ayıklama sağlayıcısını kullanan uygulamanızın hata ayıklama derlemesini oluşturabilirsiniz.

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, web uygulamanızı çalıştıran bir tarayıcı App Check jetonunu her yenilediğinde kullanıcının yanıt jetonunu doğrulamak için sizin adınıza bir değerlendirme oluşturur. Oluşturulan her değerlendirme için projenizden ücret alınacak ücretsiz kotayı aştı. reCAPTCHA fiyatlandırmasına bakın. inceleyebilirsiniz.

Web uygulamanız varsayılan olarak bu jetonu 1 saatte iki kez yeniler. Uygulamanızın App Check jetonlarını ne sıklıkta yenileyeceğini (ve dolayısıyla yeni değerlendirmelerin ne sıklıkta oluşturulacağını) kontrol etmek için TTL'lerini yapılandırın.