Bu sayfa, reCAPTCHA Enterprise sağlayıcısını kullanarak bir web uygulamasında Uygulama Kontrolü'nü nasıl etkinleştireceğinizi gösterir. Uygulama Kontrolü'nü etkinleştirdiğinizde, projenizin Firebase kaynaklarına yalnızca uygulamanızın erişebilmesini sağlamaya yardımcı olursunuz. Bu özelliğe Genel Bakış'a bakın.
reCAPTCHA Enterprise, ücretsiz kotası olan ücretli bir hizmettir. Uygulama Kontrolü ayrıca ücretsiz bir hizmet olan reCAPTCHA v3'ü de destekler. reCAPTCHA v3 ve reCAPTCHA Enterprise arasındaki farkları öğrenmek için özelliklerin karşılaştırmasına bakın.
Uygulama Kontrolü'nün, kullanıcılara görünmez kılan reCAPTCHA Enterprise puanına dayalı site anahtarları kullandığını unutmayın. reCAPTCHA Enterprise sağlayıcısı, kullanıcıların herhangi bir zamanda bir sorunu çözmesini gerektirmez.
Uygulama Kontrolü'nü kendi özel sağlayıcınızla kullanmak istiyorsanız, bkz. Özel bir Uygulama Kontrolü sağlayıcısı uygulama .
1. Firebase projenizi kurun
Henüz yapmadıysanız , JavaScript projenize Firebase'i ekleyin .
Bulut konsolunun reCAPTCHA Enterprise bölümünü açın ve aşağıdakileri yapın:
- reCAPTCHA Enterprise API'yi etkinleştirmeniz istenirse, bunu yapın.
- Bir Web sitesi türü anahtarı oluşturun. Web uygulamanızı barındırdığınız etki alanlarını belirtmeniz gerekecektir. " Onay kutusu sorgulamasını kullan" seçeneğini işaretlemeden bırakın.
Uygulamalarınızı, Firebase konsolunun Uygulama Kontrolü bölümünde reCAPTCHA Enterprise sağlayıcısı ile Uygulama Kontrolü'nü kullanmak için kaydedin. Önceki adımda aldığınız site anahtarını sağlamanız gerekecek.
Bir Firebase ürünü için zorlamayı etkinleştirdiğinizde, yalnızca kayıtlı uygulamalar ürünün arka uç kaynaklarına erişebileceğinden, genellikle projenizin tüm uygulamalarını kaydetmeniz gerekir.
İsteğe bağlı : Uygulama kaydı ayarlarında, sağlayıcı tarafından verilen Uygulama Kontrolü belirteçleri için özel bir yaşam süresi (TTL) ayarlayın. TTL'yi 30 dakika ile 7 gün arasında herhangi bir değere ayarlayabilirsiniz. Bu değeri değiştirirken aşağıdaki ödünleşimlerin farkında olun:
- Güvenlik: Daha kısa TTL'ler daha güçlü güvenlik sağlar çünkü sızdırılmış veya ele geçirilmiş bir belirtecin bir saldırgan tarafından kötüye kullanılabileceği pencereyi azaltır.
- Performans: Daha kısa TTL'ler, uygulamanızın daha sık doğrulama gerçekleştireceği anlamına gelir. Uygulama doğrulama işlemi, her gerçekleştirildiğinde ağ isteklerine gecikme eklediğinden, kısa bir TTL uygulamanızın performansını etkileyebilir.
- Kota ve maliyet: Daha kısa TTL'ler ve sık sık yeniden doğrulama, kotanızı daha hızlı tüketir ve ücretli hizmetler için potansiyel olarak daha pahalıya mal olur. Kotalar ve sınırlar konusuna bakın.
1 saatlik varsayılan TTL, çoğu uygulama için uygundur. Uygulama Kontrolü kitaplığının belirteçleri TTL süresinin yaklaşık yarısında yenilediğini unutmayın.
2. Uygulama Kontrolü kitaplığını uygulamanıza ekleyin
Henüz yapmadıysanız Firebase'i web uygulamanıza ekleyin . Uygulama Kontrolü kitaplığını içe aktardığınızdan emin olun.
3. Uygulama Kontrolünü Başlatın
Herhangi bir Firebase hizmetine erişmeden önce aşağıdaki başlatma kodunu uygulamanıza ekleyin.
activate() için Bulut konsolunda oluşturduğunuz reCAPTCHA Enterprise site anahtarınızı iletmeniz gerekecektir.
Web version 9
const { initializeApp } = require("firebase/app"); const { initializeAppCheck, ReCaptchaEnterpriseProvider } = require("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 version 8
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
Uygulama Kontrolü kitaplığı uygulamanıza yüklendikten sonra dağıtın.
Güncellenen istemci uygulaması, Firebase'e yaptığı her istekle birlikte Uygulama Kontrolü belirteçleri göndermeye başlayacak, ancak Firebase ürünleri, Firebase konsolunun Uygulama Kontrolü bölümünde zorlamayı etkinleştirene kadar belirteçlerin geçerli olmasını gerektirmeyecek.
Metrikleri izleyin ve yaptırımı etkinleştirin
Ancak, yaptırımı etkinleştirmeden önce, bunu yapmanın mevcut meşru kullanıcılarınızı kesintiye uğratmayacağından emin olmalısınız. Öte 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ı olması için kullandığınız hizmetlere ilişkin Uygulama Kontrolü metriklerine bakabilirsiniz:
- Realtime Database, Cloud Firestore ve Cloud Storage için Uygulama Kontrolü istek ölçümlerini izleyin .
- Cloud Functions için Uygulama Kontrolü istek ölçümlerini izleyin .
Uygulama Kontrolü yaptırımını etkinleştir
Uygulama Kontrolü'nün kullanıcılarınızı nasıl etkileyeceğini anladığınızda ve devam etmeye hazır olduğunuzda, Uygulama Kontrolü yaptırımını etkinleştirebilirsiniz:
- Realtime Database, Cloud Firestore ve Cloud Storage için Uygulama Kontrolü zorlamasını etkinleştirin .
- Cloud Functions için Uygulama Kontrolü zorlamasını etkinleştirin .
Hata ayıklama ortamlarında Uygulama Kontrolü'nü kullanın
Uygulamanızı Uygulama Kontrolü için kaydettirdikten sonra, uygulamanızı, geliştirme sırasında yerel olarak veya bir sürekli entegrasyon (CI) ortamından olduğu gibi, Uygulama Kontrolü'nün normalde geçerli olarak sınıflandırmadığı bir ortamda çalıştırmak istiyorsanız, oluşturabilirsiniz. gerçek bir doğrulama sağlayıcısı yerine Uygulama Kontrolü hata ayıklama sağlayıcısını kullanan uygulamanızın bir hata ayıklama yapısı.
Maliyet hakkında not
Uygulama Kontrolü, web uygulamanızı çalıştıran bir tarayıcı Uygulama Kontrolü belirtecini her yenilediğinde kullanıcının yanıt belirtecini doğrulamak için sizin adınıza bir değerlendirme oluşturur. Projeniz, ücretsiz kotanın üzerinde oluşturulan her değerlendirme için ücretlendirilecektir. Ayrıntılar için reCAPTCHA Enterprise fiyatlandırmasına bakın.
Varsayılan olarak, web uygulamanız bu belirteci her 1 saatte bir yenileyecektir. Uygulamanızın Uygulama Kontrolü belirteçlerini ne sıklıkta yenilediğini (ve dolayısıyla yeni değerlendirmelerin ne sıklıkla oluşturulacağını) kontrol etmek için TTL'lerini yapılandırın .