Web uygulamalarında Uygulama Kontrolü'nü özel bir sağlayıcıyla kullanmaya başlayın

Bu sayfada, özel kodunuzu kullanarak bir web uygulamasında App Check App Check sağlayıcı. App Check özelliğini etkinleştirdiğinizde, projenizin Firebase kaynaklarına yalnızca uygulamanızın erişebildiğinden emin olun.

App Check ürününü yerleşik sağlayıcılardan biriyle kullanmak istiyorsanız şuraya bakın: şunun için dokümanlar: reCAPTCHA Enterprise ile App Check.

Başlamadan önce

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şturun

Ö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);
    });
  }
});
appcheck_custom_provider.js

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);
    });
  }
};
index.js

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    
});
appcheck_initialize_custom_provider.js

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

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.