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 build di debug, prima di utilizzare qualsiasi servizio di backend Firebase, crea e Imposta il valore di 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 nel menu a sinistra, quindi seleziona la scheda Argomenti.
   3. Nella sezione Argomenti passati al momento dell'avvio, aggiungi -FIRDebugEnabled.

3. Avvia l'app. Un token di debug locale viene registrato quando l'SDK tenta di invia una richiesta al backend. 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. Quindi, registra il token di debug che hai registrato nell'esperienza precedente passaggio.

   

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

Perché 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.

Utilizza il provider di debug in un ambiente CI

Per utilizzare il provider di debug in un ambiente di integrazione continua (CI), esegui la seguenti:

1. Nella sezione App Check Nella console Firebase, scegli Gestisci token di debug dal menu extra. Quindi, crea un nuovo token di debug. Ti servirà nel passaggio successivo.

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

   

2. Aggiungi il token di debug appena creato all'archivio chiavi sicuro del sistema CI (ad esempio, i secret criptati delle Azioni GitHub o le variabili criptate di Travis CI).

3. Se necessario, configura il sistema CI per rendere disponibile il token di debug nell'ambiente CI come variabile di ambiente. Assegna un nome alla variabile ad esempio 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.