Bu sayfada, özel App Check sağlayıcınızı 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.
App Check'ü yerleşik sağlayıcılardan biriyle kullanmak istiyorsanız App Check ile reCAPTCHA Enterprise belgelerine bakın.
Başlamadan önce
Henüz yapmadıysanız Firebase'i JavaScript projenize ekleyin.
Özel App Check sağlayıcınızın sunucu tarafı mantığını uygulayın.
1. 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.
2. App Check sağlayıcı nesnesini oluşturma
Özel sağlayıcınız için bir App Check sağlayıcı nesnesi oluşturun. Bu nesne
Bu özellik, özel olarak ayarladığınız bilgileri toplayan bir getToken()
yöntemine sahip olmalıdır.
App Check sağlayıcı, orijinallik belgesini zorunlu kılıp
App Check jeton karşılığında jeton edinme hizmeti. İlgili içeriği oluşturmak için kullanılan
App Check SDK, jeton önbelleğine alma işlemini işlediğinden
getToken()
uygulanması.
Web
import { CustomProvider } from "firebase/app-check"; const appCheckCustomProvider = new CustomProvider({ getToken: () => { return new Promise((resolve, _reject) => { // TODO: Logic to exchange proof of authenticity for an App Check token and // expiration time. // ... const appCheckToken = { token: tokenFromServer, expireTimeMillis: expirationFromServer * 1000 }; resolve(appCheckToken); }); } });
Web
const appCheckCustomProvider = { getToken: () => { return new Promise((resolve, _reject) => { // TODO: Logic to exchange proof of authenticity for an App Check token and // expiration time. // ... const appCheckToken = { token: tokenFromServer, expireTimeMillis: expirationFromServer * 1000 }; resolve(appCheckToken); }); } };
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:
Web
import { initializeApp } from "firebase/app"; import { initializeAppCheck } from "firebase/app-check"; const app = initializeApp({ // Your firebase configuration object }); const appCheck = initializeAppCheck(app, { provider: appCheckCustomProvider, // Optional argument. If true, the SDK automatically refreshes App Check // tokens as needed. isTokenAutoRefreshEnabled: true });
Web
firebase.initializeApp({ // Your firebase configuration object }); const appCheck = firebase.appCheck(); appCheck.activate( appCheckCustomProvider, // Optional argument. If true, the SDK automatically refreshes App Check // tokens as needed. true);
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. Ö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:
- 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 zorunlu kılmayı etkinleştir
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:
- Realtime Database, Cloud Firestore, Cloud Storage, Firebase Data Connect (Önizleme), Authentication (beta) ve Vertex AI in Firebase (Önizleme) için App Check yaptırımını etkinleştirin.
- 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.