Abilita l'applicazione di App Check per le funzioni cloud

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

Per iniziare ad applicare i requisiti del token App Check nelle tue Cloud Functions 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 respinte.

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 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 implementate queste modifiche, le tue Cloud Functions richiamabili richiederanno token App Check validi. Gli SDK del client Cloud Functions allegano automaticamente un token App Check quando richiami una funzione richiamabile.