Monitora metriche delle richieste di App Check

Dopo aver aggiunto la libreria App Check alla tua app, ma prima di attivare l'applicazione di App Check, devi assicurarti che questa operazione non interrompa l'attività dei tuoi utenti legittimi esistenti.

Uno strumento importante che puoi utilizzare per prendere questa decisione sono le metriche delle richieste di App Check. Puoi monitorare le metriche di App Check in Google API Console o nella console Firebase.

Monitorare le metriche in Google API Console

Per visualizzare le metriche per il client OAuth iOS, vai alla visualizzazione di modifica del client nella pagina Credenziali. Qui vedrai le metriche a destra della pagina nella sezione Google Identity per iOS. Queste metriche mostrano le metriche delle richieste App Check. Le metriche includono le seguenti informazioni:

• Numero di richieste verificate: richieste con un token App Check valido. Dopo aver abilitato l'applicazione di App Check, solo le richieste di questa categoria andranno a buon fine.
• Numero di richieste non verificate: probabili richieste client obsolete: richieste senza un token App Check; queste richieste potrebbero provenire da una versione precedente della tua app che non include un'implementazione di App Check.
• Numero di richieste non verificate: richieste di origini sconosciute: richieste senza un token App Check che non sembrano provenire dalla tua app.
• Numero di richieste non verificate: richieste non valide: richieste con un token App Check non valido, probabilmente provenienti da un client non autentico che cerca di passare per la tua app o da ambienti emulati.

Monitorare le metriche nella console Firebase

Puoi visualizzare le metriche per i tuoi progetti nel loro complesso o per i singoli client OAuth:

• Per visualizzare le metriche delle richieste di App Check per il tuo progetto, apri la sezione App Check della console Firebase ed espandi la sezione Google Identity per iOS. Ad esempio:

  

• Per visualizzare le metriche delle richieste App Check per un client OAuth specifico, apri la pagina Client OAuth della console Firebase ed espandi la sezione corrispondente al client.

Le metriche delle richieste sono suddivise in quattro categorie:

• Le richieste verificate sono quelle che hanno un token App Check valido. Dopo aver abilitato l'applicazione di App Check, solo le richieste di questa categoria andranno a buon fine.

• Le richieste client obsolete sono quelle a cui manca un token App Check. Queste richieste potrebbero provenire da una versione precedente dell'SDK Firebase prima che App Check fosse incluso nell'app.

• Le richieste di origine sconosciuta sono quelle senza un token App Check e che non sembrano provenire dall'SDK Firebase. Queste potrebbero provenire da richieste effettuate con chiavi API rubate o richieste contraffatte effettuate senza l'SDK Firebase.

• Le richieste non valide sono quelle che hanno un token App Check non valido, probabilmente provenienti da un client non autentico che cerca di passare per la tua app o da ambienti emulati.

La distribuzione di queste categorie per la tua app deve informarti quando decidi di attivare l'applicazione. Di seguito sono riportate alcune linee guida:

• Se quasi tutte le richieste recenti provengono da client verificati, valuta la possibilità di attivare l'applicazione per iniziare a proteggere gli endpoint di autenticazione.

• Se una parte significativa delle richieste recenti proviene da client probabilmente obsoleti, per evitare interruzioni per gli utenti, valuta la possibilità di attendere che un maggior numero di utenti aggiorni la tua app prima di attivare l'applicazione. L'applicazione di App Check su un'app rilasciata interromperà le versioni precedenti dell'app che non sono integrate con l'SDK App Check.

• Se la tua app non è ancora stata lanciata, devi attivare l'applicazione di App Check immediatamente, poiché non sono in uso client obsoleti.

Passaggi successivi

Quando avrai compreso l'impatto di App Check sui tuoi utenti e sarai pronto per procedere, potrai attivare l'applicazione di App Check.