Utilizzare App Check con il provider di debug sulle piattaforme Apple

Se, dopo aver registrato la tua app per App Check, vuoi eseguirla in un ambiente che App Check normalmente non classificherebbe come valido, come un simulatore o un dispositivo durante lo sviluppo o da un ambiente di integrazione continua (CI), puoi creare una build di debug della tua app che utilizzi il provider di debug App Check anziché un provider di attestazione reale.

Utilizzare il provider di debug in fase di sviluppo

Per utilizzare il provider di debug durante l'esecuzione interattiva dell'app (ad esempio durante lo sviluppo):

1. Nella compilazione di debug, prima di utilizzare qualsiasi servizio di backend Firebase, crea e imposta la fabbrica del provider di debug App Check:

   Swift

   let providerFactory = AppCheckDebugProviderFactory()
   AppCheck.setAppCheckProviderFactory(providerFactory)
   
   FirebaseApp.configure()

   Objective-C

   FIRAppCheckDebugProviderFactory *providerFactory =
         [[FIRAppCheckDebugProviderFactory alloc] init];
   [FIRAppCheck setAppCheckProviderFactory:providerFactory];
   
   // Use Firebase library to configure APIs
   [FIRApp configure];

2. Attiva il logging di debug nel progetto Xcode (v11.0 o successiva):

   1. Apri Prodotto > Schema > Modifica schema.
   2. Seleziona Esegui dal menu a sinistra e poi la scheda Argomenti.
   3. Nella sezione Argomenti passati al momento dell'avvio, aggiungi -FIRDebugEnabled.

3. Avvia l'app. Quando l'SDK tenta di inviare una richiesta al backend, verrà registrato un token di debug locale. Ad esempio:

   [Firebase/AppCheck][I-FAA001001] Firebase App Check Debug Token:
   123a4567-b89c-12d3-e456-789012345678

4. Nella sezione App Check della console Firebase, scegli Gestisci token di debug dal menu overflow della tua app. Dopodiché, registra il token di debug che hai eseguito nel passaggio precedente.

   

Dopo aver registrato il token, i servizi di backend di Firebase lo accetteranno come valido.

Poiché questo token consente l'accesso alle risorse Firebase senza un dispositivo valido, è fondamentale mantenerlo privato. Non eseguirne il commit in un repository pubblico e, se un token registrato viene compromesso, revocalo immediatamente nella console Firebase.

Utilizzare il provider di debug in un ambiente CI

Per utilizzare il provider di debug in un ambiente di integrazione continua (CI), segui questi passaggi:

1. Nella sezione App Check della console Firebase, scegli Gestisci token di debug dal menu overflow della tua app. Poi, crea un nuovo token di debug. Ti servirà nel passaggio successivo.

   Poiché questo token consente di accedere alle risorse Firebase senza un dispositivo valido, è fondamentale mantenerlo privato. Non eseguirne il commit in un repository pubblico e, se un token registrato viene compromesso, revocalo immediatamente nella console Firebase.

   

2. Aggiungi il token di debug che hai appena creato al key store sicuro del tuo sistema CI (ad esempio, i secret criptati di GitHub Actions o le variabili criptate di Travis CI).

3. Se necessario, configura il sistema CI in modo da rendere disponibile il token di debug all'interno dell'ambiente CI come variabile di ambiente. Assegna alla variabile un nome come APP_CHECK_DEBUG_TOKEN_FROM_CI.

4. In Xcode, aggiungi una variabile di ambiente allo schema di test con il nome FIRAAppCheckDebugToken e un valore simile a $(APP_CHECK_DEBUG_TOKEN).

5. Configura lo script di test CI in modo da passare il token di debug come variabile di ambiente. Ad esempio:

   xcodebuild test -scheme YourTestScheme -workspace YourProject.xcworkspace \
   APP_CHECK_DEBUG_TOKEN=$(APP_CHECK_DEBUG_TOKEN_FROM_CI)

6. Nella compilazione di debug, prima di utilizzare qualsiasi servizio di backend Firebase, crea e imposta la fabbrica del provider di debug App Check:

   Swift

   let providerFactory = AppCheckDebugProviderFactory()
   AppCheck.setAppCheckProviderFactory(providerFactory)
   
   FirebaseApp.configure()

   Objective-C

   FIRAppCheckDebugProviderFactory *providerFactory =
         [[FIRAppCheckDebugProviderFactory alloc] init];
   [FIRAppCheck setAppCheckProviderFactory:providerFactory];
   
   // Use Firebase library to configure APIs
   [FIRApp configure];

Quando l'app viene eseguita in un ambiente CI, i servizi di backend di Firebase accetteranno il token inviato come valido.