Web uygulamalarında hata ayıklama sağlayıcısıyla Uygulama Kontrolü'nü kullanma

Uygulamanızı Uygulama Kontrolü'ne kaydettikten sonra, uygulamanızı normalde Uygulama Kontrolü'nün geçerli olarak sınıflandırılmayacağı bir ortamda (ör. geliştirme sırasında yerel olarak veya sürekli entegrasyon (CI) ortamından) çalıştırmak isterseniz uygulamanızın, gerçek bir onay sağlayıcısı yerine Uygulama Kontrolü hata ayıklama sağlayıcısını kullanan bir hata ayıklama derlemesi oluşturabilirsiniz.

Uyarı: Hata ayıklama sağlayıcısı, doğrulanmamış cihazlardan Firebase kaynaklarınıza erişime izin verir. Uygulamanızın üretim derlemelerinde hata ayıklama sağlayıcısını kullanmayın ve hata ayıklama derlemelerinizi güvenilmeyen taraflarla paylaşmayın.

localhost'ta hata ayıklama sağlayıcısını kullanma

Uygulamanızı localhost üzerinde çalıştırırken (örneğin, geliştirme sırasında) hata ayıklama sağlayıcısını kullanmak için aşağıdakileri yapın:

Uyarı: reCAPTCHA'nın izin verilen alanlarına localhost ekleyerek localhost hata ayıklamasını etkinleştirmeye çalışmayın. Bu sayede herkes uygulamanızı yerel makinelerinden çalıştırabilir.

1. Uygulama Kontrolü'nü başlatmadan önce hata ayıklama derlemenizde self.FIREBASE_APPCHECK_DEBUG_TOKEN ayarını true yaparak hata ayıklama modunu etkinleştirin. Örnek:

   Web

   self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;
   initializeAppCheck(app, { /* App Check options */ });
   

   Web

   self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;
   firebase.appCheck().activate(/* site key or provider */);
   

   Not: v9'dan önceki Firebase Web SDK sürümlerinde self.FIREBASE_APPCHECK_DEBUG_TOKEN, ilk kullanıma hazırlama/etkinleştirme anında değil, içe aktarma anında okunur. Bunun için kod paketi yüklenmeden önce index.html içinde ayarlanması gerekiyordu. Bu kısıtlamayı önlemek için v9'a yükseltin.

2. Yerel olarak web uygulamanızı ziyaret edin ve tarayıcının geliştirici aracını açın. Hata ayıklama konsolunda bir hata ayıklama jetonu görürsünüz:

   AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678". You will
   need to safelist it in the Firebase console for it to work.

3. Firebase konsolunun Uygulama Kontrolü bölümünde, uygulamanızın taşma menüsünden Hata ayıklama jetonlarını yönet'i seçin. Ardından, önceki adımda günlüğe kaydettiğiniz hata ayıklama jetonunu kaydedin.

   

Jetonu kaydetmenizin ardından Firebase arka uç hizmetleri, jetonu geçerli olarak kabul eder.

Bu jeton, geçerli bir cihaz olmadan Firebase kaynaklarınıza erişim olanağı sağladığı için bu jetonu gizli tutmanız son derece önemlidir. Bu kodu herkese açık bir depoya kaydetmeyin ve kayıtlı bir jetonun güvenliği ihlal edilirse jetonu Firebase konsolundan hemen iptal edin.

Bu jeton tarayıcınızda yerel olarak depolanır ve uygulamanızı aynı makinedeki aynı tarayıcıda her kullandığınızda kullanılır. Jetonu başka bir tarayıcıda veya makinede kullanmak istiyorsanız true yerine jeton dizesi için self.FIREBASE_APPCHECK_DEBUG_TOKEN değerini ayarlayın.

Hata ayıklama sağlayıcısını CI ortamında kullanma

Hata ayıklama sağlayıcısını sürekli entegrasyon (CI) ortamında kullanmak için şunları yapın:

1. Firebase konsolunun Uygulama Kontrolü bölümünde, uygulamanızın taşma menüsünden Hata ayıklama jetonlarını yönet'i seçin. Ardından yeni bir hata ayıklama jetonu oluşturun. Bir sonraki adımda jetona ihtiyacınız olacak.

   Bu jeton, geçerli bir cihaz olmadan Firebase kaynaklarınıza erişim sağladığından jetonları gizli tutmanız çok önemlidir. Bu kodu herkese açık bir depoya kaydetmeyin ve kayıtlı bir jetonun güvenliği ihlal edilirse jetonu Firebase konsolundan hemen iptal edin.

   

2. Az önce oluşturduğunuz hata ayıklama jetonunu CI sisteminizin güvenli anahtar deposuna (örneğin, GitHub İşlemler'in şifrelenmiş gizli anahtarları veya Travis CI'nın şifrelenmiş değişkenleri) ekleyin.

3. Gerekirse CI sisteminizi, hata ayıklama jetonunuzu CI ortamında ortam değişkeni olarak kullanılabilir hale getirecek şekilde yapılandırın. Değişkene APP_CHECK_DEBUG_TOKEN_FROM_CI gibi bir ad verin.

4. Uygulama Kontrolü'nü içe aktarmadan önce, hata ayıklama derlemenizde self.FIREBASE_APPCHECK_DEBUG_TOKEN ayarını hata ayıklama jetonu ortam değişkeninin değerine ayarlayarak hata ayıklama modunu etkinleştirin. Örnek:

   Web

   self.FIREBASE_APPCHECK_DEBUG_TOKEN = process.env.APP_CHECK_DEBUG_TOKEN_FROM_CI;
   initializeAppCheck(app, { /* App Check options */ });
   

   Web

   self.FIREBASE_APPCHECK_DEBUG_TOKEN = process.env.APP_CHECK_DEBUG_TOKEN_FROM_CI;
   firebase.appCheck().activate(/* site key or provider */);
   

Uygulamanız CI ortamında çalıştığında Firebase arka uç hizmetleri, gönderdiği jetonu geçerli olarak kabul eder.