Questa pagina mostra come abilitare App Check in un'app Unity utilizzando i provider predefiniti: Play Integrity su Android e Device Check o App Attest sulle piattaforme Apple. Quando attivi App Check, contribuisci a garantire che solo la tua app possa accedere alle risorse Firebase del tuo progetto. Consulta una panoramica di questa funzionalità.
1. Configura il progetto Firebase
Aggiungi Firebase al tuo progetto Unity se non l'hai già fatto.
Nella console Firebase, vai a Sicurezza > App Check.
Nella scheda App, registra le tue app per utilizzare App Check con i fornitori Play Integrity, DeviceCheck o App Attest.
In genere devi registrare tutte le app del progetto, perché una volta attivata l'applicazione per un prodotto Firebase, solo le app registrate potranno accedere alle risorse di backend del prodotto.
Per istruzioni dettagliate su come registrarsi con ciascun fornitore, consulta la documentazione specifica per Android e iOS.
(Facoltativo): nelle impostazioni di registrazione dell'app, imposta una durata (TTL) personalizzata per i token App Check emessi dal provider. Puoi impostare il TTL su qualsiasi valore compreso tra 30 minuti e 7 giorni. Quando modifichi questo valore, tieni presente i seguenti compromessi:
- Sicurezza: i TTL più brevi offrono una maggiore sicurezza, perché riducono il periodo di tempo in cui un token compromesso o intercettato può essere utilizzato in modo illecito da un malintenzionato.
- Rendimento: TTL più brevi significano che la tua app eseguirà l'attestazione più di frequente. Poiché il processo di attestazione dell'app aggiunge latenza alle richieste di rete ogni volta che viene eseguito, un TTL breve può influire sulle prestazioni dell'app.
- Quota e costi: TTL più brevi e riattestazioni frequenti esauriscono la quota più rapidamente e, per i servizi a pagamento, potrebbero costare di più. Consulta Quote e limiti.
Il TTL predefinito è ragionevole per la maggior parte delle app. Tieni presente che la libreria App Check aggiorna i token a circa metà della durata TTL.
2. Aggiungere la libreria App Check alla tua app
Includi la libreria App Check nel tuo insieme di dipendenze, seguendo le istruzioni di configurazione per App Check.
3. Inizializzare App Check
Aggiungi il seguente codice di inizializzazione alla tua app in modo che venga eseguito prima di utilizzare qualsiasi servizio Firebase, inclusa la creazione di app Firebase.
Android
Aggiungi la dichiarazione using per
Firebase.AppCheck:using Firebase.AppCheck
Inizializza la libreria App Check con il provider Play Integrity:
FirebaseAppCheck.SetAppCheckProviderFactory( PlayIntegrityProviderFactory.Instance);
iOS+
Aggiungi la dichiarazione using per
Firebase.AppCheck:using Firebase.AppCheck
Inizializza la libreria App Check con il provider Device Check o App Attest:
FirebaseAppCheck.SetAppCheckProviderFactory( DeviceCheckProviderFactory.Instance);
Passaggi successivi
Una volta installata la libreria App Check nella tua app, inizia a distribuire l'app aggiornata agli utenti.
L'app client aggiornata inizierà a inviare token App Check insieme a ogni richiesta inviata a Firebase, ma i prodotti Firebase non richiederanno la validità dei token finché non attivi l'applicazione nella sezione App Check della console Firebase.
Monitorare le metriche e attivare l'applicazione
Prima di attivare l'applicazione, però, devi assicurarti che questa operazione non interrompa l'attività degli utenti legittimi esistenti. D'altra parte, se noti un utilizzo sospetto delle risorse della tua app, potresti voler attivare l'applicazione prima.
Per prendere questa decisione, puoi esaminare le metriche di App Check per i servizi che utilizzi:
- Monitora le metriche delle richieste di App Check per Realtime Database, Cloud Firestore e Cloud Storage.
- Monitora le metriche delle richieste App Check per Cloud Functions.
Abilitare l'applicazione di App Check
Quando avrai compreso l'impatto di App Check sui tuoi utenti e sarai pronto per procedere, potrai attivare l'applicazione di App Check:
- Abilita l'applicazione di App Check per Realtime Database, Cloud Firestore e Cloud Storage.
- Attiva l'applicazione di App Check per Cloud Functions.
Utilizzare App Check negli ambienti di debug
Se, dopo aver registrato la tua app per App Check, vuoi eseguirla in un ambiente che normalmente non classificherebbe come valido, ad esempio su un computer, un emulatore durante lo sviluppo o da un ambiente di integrazione continua (CI), puoi creare una build di debug della tua app che utilizza il provider di debug di App Check anziché un vero provider di attestazione.
Consulta Utilizzare App Check con il provider di debug nelle app Unity.