Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Abilita l'applicazione di App Check per le funzioni cloud

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Quando capisci in che modo App Check influirà sui tuoi utenti e sei pronto per procedere, puoi abilitare l'applicazione di App Check.

Per iniziare ad applicare i requisiti del token App Check nelle tue funzioni cloud richiamabili, modifica le tue funzioni per verificare la presenza di token App Check validi, come mostrato di seguito. Una volta abilitata l'applicazione, tutte le richieste non verificate verranno rifiutate.

  1. Aggiorna la dipendenza firebase-functions del tuo progetto alla versione 4.0.0 o successiva:

    npm install firebase-functions@">=4.0.0"
    

    E aggiorna la dipendenza firebase-admin del tuo progetto alla versione 9.8.0 o successiva:

    npm install firebase-admin@">=9.8.0"
    
  2. Imposta l'opzione di runtime enforceAppCheck per la tua funzione su true :

    exports.yourCallableFunction = functions.
      .runWith({
        enforceAppCheck: true  // Requests without valid App Check tokens will be rejected.
      })
      .https.onCall((data, context) => {
        // Your function logic follows.
      });
    
  3. Aggiungi un controllo per context.app alla tua funzione. La tua funzione dovrebbe fallire se context.app non è definito.

    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.
    });
    
  4. Ridistribuisci le tue funzioni:

    firebase deploy --only functions
    

Una volta distribuite queste modifiche, le tue funzioni cloud richiamabili richiederanno token App Check validi. Gli SDK client di Cloud Functions allegano automaticamente un token App Check quando si richiama una funzione richiamabile.