Ativar aplicação de verificação de aplicativo para Cloud Functions

Para começar a aplicar os requisitos de token do App Check em seu Cloud Functions que pode ser chamado, modifique suas funções para verificar se há tokens válidos do App Check.

Antes de você começar

Ativar App Verifique em suas a Apple , Android e Web clientes.

Adicionar suporte ao App Check a uma função

  1. Atualizar do seu projeto firebase-functions dependência para a versão 3.14.0 ou mais recente:

    npm install firebase-functions@">=3.14.0"
    

    E atualizar do seu projeto firebase-admin dependência para a versão 9.8.0 ou mais recente:

    npm install firebase-admin@">=9.8.0"
    
  2. Adicionar um cheque de context.app à sua função. Sua função deve falhar se context.app não está definido.

    exports.yourCallableFunction = functions.https.onCall((data, context) => {
      // context.app will be undefined if the request doesn't include an
      // App Check token. (If the request includes an invalid App Check
      // token, the request will be rejected with HTTP error 401.)
      if (context.app == undefined) {
        throw new functions.https.HttpsError(
            'failed-precondition',
            'The function must be called from an App Check verified app.')
      }
    
      // Your function logic follows.
    });
    
  3. (Opcional) Se você deseja lidar com inválidos App Verifique fichas com sua própria lógica (por exemplo, se você quiser registrar temporariamente, ao invés de rejeitar pedidos inválidos antes de ativar a aplicação integral), definir allowInvalidAppCheckToken a true :

    exports.yourCallableFunction = functions.
      .runWith({
        allowInvalidAppCheckToken: true  // Opt-out: Requests with invalid App
                                         // Check tokens continue to your code.
      })
      .https.onCall((data, context) => {
        // Now, requests with an invalid App Check token are not rejected.
        //
        // context.app will be undefined if the request:
        //   1) Does not include an App Check token
        //   2) Includes an invalid App Check token
        if (context.app == undefined) {
          // You can inspect the raw request header to check whether an App
          // Check token was provided in the request. If you're not ready to
          // fully enable App Check yet, you could log these conditions instead
          // of throwing errors.
          const rawToken = context.rawRequest.header['X-Firebase-AppCheck'];
          if (rawToken == undefined) {
            throw new functions.https.HttpsError(
                'failed-precondition',
                'The function must be called from an App Check verified app.'
            );
          } else {
            throw new functions.https.HttpsError(
                'unauthenticated',
                'Provided App Check token failed to validate.'
            );
          }
        }
    
        // Your function logic follows.
      });
    

    Para habilitar completo App Verifique protecção, definir allowInvalidAppCheckToken para false .

  4. Reimplante suas funções:

    firebase deploy --only functions
    

Depois que essas alterações forem implantadas, suas Cloud Functions que podem ser chamadas exigirão tokens válidos do App Check. Os SDKs do cliente do Cloud Functions anexam automaticamente um token do App Check quando você invoca uma função que pode ser chamada.