在網路應用程式中使用 App Check 保護自訂後端資源

您可以透過 App Check 保護應用程式的非 Google 自訂後端資源，例如自行管理的後端。如要這麼做，請完成下列兩項操作：

  • 如本頁所述，修改應用程式用戶端，在每次傳送至後端的要求中加入 App Check 權杖。
  • 修改後端，要求每個要求都附上有效的 App Check 權杖，詳情請參閱「從自訂後端驗證 App Check 權杖」。

事前準備

使用 reCAPTCHA Enterprise 提供者或自訂提供者，將 App Check 新增至應用程式。

透過後端要求傳送 App Check 權杖

在應用程式用戶端中，每次提出要求前，請先使用 appCheck().getToken() 取得有效且未過期的 App Check 權杖。App Check 程式庫會在必要時重新整理權杖。

取得有效權杖後，請將權杖連同要求傳送至後端。具體做法由您決定，但請勿將 App Check 權杖做為網址的一部分傳送 (包括查詢參數)，否則權杖可能會意外洩漏或遭到攔截。下列範例會透過自訂 HTTP 標頭傳送權杖，這是建議的做法。

Web

import { initializeAppCheck, getToken } from 'firebase/app-check';

const appCheck = initializeAppCheck(
    app,
    { provider: provider } // ReCaptchaV3Provider or CustomProvider
);

const callApiWithAppCheckExample = async () => {
  let appCheckTokenResponse;
  try {
      appCheckTokenResponse = await getToken(appCheck, /* forceRefresh= */ false);
  } catch (err) {
      // Handle any errors if the token was not retrieved.
      return;
  }

  // Include the App Check token with requests to your server.
  const apiResponse = await fetch('https://yourbackend.example.com/yourApiEndpoint', {
      headers: {
          'X-Firebase-AppCheck': appCheckTokenResponse.token,
      }
  });

  // Handle response from your backend.
};
appcheck_nonfirebase.js

Web

const callApiWithAppCheckExample = async () => {
  let appCheckTokenResponse;
  try {
      appCheckTokenResponse = await firebase.appCheck().getToken(/* forceRefresh= */ false);
  } catch (err) {
      // Handle any errors if the token was not retrieved.
      return;
  }

  // Include the App Check token with requests to your server.
  const apiResponse = await fetch('https://yourbackend.example.com/yourApiEndpoint', {
      headers: {
          'X-Firebase-AppCheck': appCheckTokenResponse.token,
      }
  });

  // Handle response from your backend.
};
index.js

重送攻擊防護 (Beta 版)

向已啟用重播保護機制的端點提出要求時，請使用 getLimitedUseToken() 取得權杖，而非 getToken()：

import { getLimitedUseToken } from "firebase/app-check";

// ...

appCheckTokenResponse = await getLimitedUseToken(appCheck);