Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Inizia a utilizzare App Check con reCAPTCHA Enterprise nelle app Flutter

Seleziona la piattaforma:

iOS+ Android Web Flutter

Questa pagina mostra come configurare App Check in un'app Flutter utilizzando il provider reCAPTCHA Enterprise. App Check aiuta a garantire che solo la tua app possa accedere alle risorse di backend del progetto. Per scoprire di più, consulta la nostra panoramica di App Check.

App Check richiede l'utilizzo di chiavi reCAPTCHA basate su punteggio, che le rendono invisibili agli utenti. Ciò significa che il provider reCAPTCHA Enterprise non richiederà mai agli utenti di risolvere una verifica.

Se il tuo caso d'uso richiede funzionalità reCAPTCHA Enterprise non implementate da App Check o se vuoi utilizzare App Check con il tuo provider personalizzato, consulta Implementa un provider App Check personalizzato.

1. Configura il progetto Firebase

Se non l'hai ancora fatto, installa e inizializza Firebase nel tuo progetto Flutter.
Nella console Google Cloud, vai alla pagina Fraud Defense e segui questi passaggi per il provider reCAPTCHA Enterprise:
1. Assicurati di essere nel progetto corretto (vedi il selettore di progetti nella parte superiore dello schermo).
2. Se richiesto, abilita l'API reCAPTCHA Enterprise.
3. Crea una chiave in base alla piattaforma di destinazione:
  iOS+
  Crea una chiave di tipo iOS e specifica l'ID pacchetto della tua app (ad esempio com.example.my_app).
  
  Assicurati di inserire lo stesso ID pacchetto che hai fornito quando hai creato l'app Firebase Apple nel tuo progetto Firebase. Il valore dell'ID pacchetto è sensibile alle maiuscole.
  
  Per App Check, ogni ID pacchetto può corrispondere a una sola chiave reCAPTCHA.
  Android
  Crea una chiave di tipo Android e specifica il nome del pacchetto della tua app (ad esempio com.example.my_app).
  
  Assicurati di inserire lo stesso nome di pacchetto che hai fornito quando hai creato l'app Firebase per Android nel tuo progetto Firebase. Il valore del nome del pacchetto è sensibile alle maiuscole.
  
  Per App Check, ogni nome di pacchetto può corrispondere solo a una singola chiave reCAPTCHA.
  Web
  Crea una chiave di tipo Web e specifica ciascuno dei domini per le tue app web.
  
  App Check non supporta le app web pubblicate su più di 250 domini.
  
  Non aggiungere mai localhost come dominio a una chiave reCAPTCHA di cui è stato eseguito (o verrà eseguito) il deployment in produzione.
  
  Lascia l'opzione "Usa verifica con casella di controllo" deselezionata.
  Per istruzioni dettagliate, consulta Crea chiavi reCAPTCHA basate su punteggio.
4. Prendi nota di ogni chiave. Dovrai aggiungerli al flusso di registrazione nella console Firebase.
Nella console Firebase, vai a Sicurezza > App Check.
Nella scheda App, registra ogni app della piattaforma di destinazione per utilizzare App Check con il provider reCAPTCHA Enterprise. Dovrai fornire la chiave che hai ricevuto nella console Google Cloud.

Importante: assicurati di registrare tutte le app del tuo progetto con un provider di attestazione (come reCAPTCHA Enterprise). Una volta abilitata l'applicazione per un servizio, solo le app registrate potranno accedere al servizio.
Facoltativo: imposta la durata (TTL) del token.

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: TTL più brevi offrono una sicurezza maggiore, perché riducono la finestra in cui un token divulgato o intercettato può essere utilizzato in modo improprio da un utente malintenzionato.
- Prestazioni: TTL più brevi significano che l'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 della tua app.
- Quota e costo: TTL più brevi e riattestazioni frequenti esauriscono la quota più rapidamente e, per i servizi a pagamento, potrebbero comportare costi maggiori. Consulta Quote e limiti.
Il TTL predefinito di 1 ora è ragionevole per la maggior parte delle app. Tieni presente che la libreria App Check aggiorna i token a circa metà della durata del TTL.
Facoltativo: configura le impostazioni avanzate.
Fai clic su Salva.

(Facoltativo) Configura le impostazioni avanzate

Quando un utente apre la tua app, reCAPTCHA Enterprise valuta il livello di rischio dell'interazione dell'utente con la chiave e restituisce un punteggio compreso tra 0,0 e 1,0, con incrementi di 0,1.

Un punteggio pari a 0,0 indica che l'interazione presenta un rischio elevato e potrebbe essere fraudolenta.
Un punteggio pari a 1,0 indica che l'interazione presenta un rischio basso e molto probabilmente è legittima.

App Check ti consente di configurare una soglia di rischio dell'app in modo da poter regolare la tua tolleranza a questo rischio.

Per la maggior parte dei casi d'uso, è consigliato il valore di soglia predefinito di 0,5. Se il tuo caso d'uso richiede una modifica, puoi configurare questo valore per ciascuna delle tue app nella console Firebase (vai a Sicurezza > App Check). Assicurati di espandere ed esaminare alcune considerazioni importanti sulla configurazione della soglia di rischio delle app di seguito.

Visualizza considerazioni importanti sulla soglia di rischio dell'app

App Check utilizza la soglia di rischio dell'app configurata come punteggio reCAPTCHA Enterprise minimo richiesto affinché un'interazione utente venga considerata legittima. Tutti i punteggi reCAPTCHA Enterprise inferiori alla soglia configurata verranno rifiutati. Quando modifichi la soglia di rischio dell'app, tieni presente quanto segue:

Se il tuo progetto Firebase utilizza il piano tariffario Spark senza costi, degli 11 possibili livelli di punteggio reCAPTCHA Enterprise, sono disponibili solo i seguenti quattro livelli di punteggio: 0,1, 0,3, 0,7 e 0,9.

Durante questo periodo, App Check consentirà di conseguenza solo valori di soglia di rischio dell'app pari a 0,1, 0,3, 0,5, 0,7 e 0,9. Per la maggior parte dei casi d'uso, è comunque consigliato un valore di soglia del rischio dell'app pari a 0,5.
- Per abilitare tutti e 11 i livelli di punteggio reCAPTCHA Enterprise, collega un account Cloud Billing al tuo progetto (ovvero esegui l'upgrade del tuo progetto Firebase al piano tariffario Blaze con pagamento a consumo). Una volta eseguito l'upgrade del progetto, App Check ti consentirà di configurare qualsiasi valore di soglia di rischio dell'app compreso tra 0,0 e 1,0, con incrementi di 0,1.
  
  Nota: dopo aver collegato un account Cloud Billing al progetto, viene attivato un controllo di sicurezza automatico per il progetto. Per saperne di più, consulta la documentazione di reCAPTCHA Enterprise.
Per monitorare la distribuzione dei punteggi reCAPTCHA Enterprise alti e bassi per la tua app, vai alla pagina reCAPTCHA Enterprise nella console Google Cloud e seleziona la chiave utilizzata dalla tua app.
Imposta la soglia di rischio dell'app in modo appropriato per la tua tolleranza:
- Se hai una tolleranza al rischio delle app elevata, sposta il cursore verso destra per diminuire la soglia di rischio delle app.
  - Un valore pari a 0.0 non è consigliato, in quanto questa impostazione disabilita la protezione dai comportamenti illeciti.
- Se hai una bassa tolleranza al rischio delle app, sposta il cursore verso sinistra per aumentare la soglia di rischio delle app.
  - Il valore 1.0 non è consigliato, in quanto questa impostazione potrebbe anche negare l'accesso agli utenti legittimi che non soddisfano questa soglia di attendibilità elevata.
  Avviso: per evitare di disturbare gli utenti legittimi, aumenta gradualmente la soglia di rischio dell'app quando viene applicato App Check. Monitora sempre le metriche delle richieste App Check per verificare che il traffico non sia stato interrotto.

Per ulteriori dettagli, consulta la documentazione di reCAPTCHA Enterprise per le app mobile e le app web.

2. Aggiungi il plug-in App Check alla tua app

Per utilizzare il provider reCAPTCHA Enterprise, devi aggiungere il plug-in App Check corrispondente.

Dalla directory principale del progetto Flutter, esegui questo comando per installare il plug-in:
```
flutter pub add firebase_app_check
```
Al termine, ricrea il progetto Flutter:
```
flutter run
```

3. Inizializza App Check

Nell'app, devi inizializzare App Check prima di utilizzare qualsiasi altro servizio Firebase.

import 'package:firebase_core/firebase_core.dart';
import 'package:firebase_app_check/firebase_app_check.dart';
import 'firebase_options.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp(options: DefaultFirebaseOptions.currentPlatform);
  await FirebaseAppCheck.instance.activate(
    providerWeb: ReCaptchaEnterpriseProvider(WEB_SITE_KEY),
    providerAndroid: const AndroidReCaptchaProvider(ANDROID_SITE_KEY),
    providerApple: const AppleReCaptchaProvider(IOS_SITE_KEY),
  );
  runApp(App());
}

4. Monitora le metriche e attiva l'applicazione

Dopo aver configurato App Check nella tua app, inizia a distribuire l'app aggiornata ai tuoi utenti.

L'app client aggiornata inizierà a inviare token App Check insieme a ogni richiesta che invia a Firebase. Tuttavia, App Check non bloccherà le richieste con token non validi finché non verrà applicato App Check.

Monitora le metriche

Prima di attivare l'applicazione, assicurati che questa operazione non interrompa l'attività degli utenti legittimi esistenti. Tuttavia, se noti un utilizzo sospetto delle risorse della tua app, potresti voler attivare l'applicazione prima.

Per prendere questa decisione, puoi esaminare le metriche App Check per i servizi che utilizzi:

Monitora le metriche delle richieste App Check per Firebase AI Logic, SQL Connect, Realtime Database, Cloud Firestore, Cloud Storage, Authentication, Google Identity per iOS, API Maps JavaScript e API Places (nuova).
Monitora le metriche delle richieste App Check per Cloud Functions.

Attiva l'applicazione di App Check

Quando hai compreso l'impatto di App Check sui tuoi utenti e vuoi procedere, puoi attivare l'applicazione di App Check:

Abilita l'applicazione di App Check per Firebase AI Logic, SQL Connect, Realtime Database, Cloud Firestore, Cloud Storage, Authentication, Google Identity per iOS, API Maps JavaScript e API Places (nuova).
Attiva l'applicazione di App Check per Cloud Functions.

Utilizza App Check in ambienti di debug

App Check classifica alcuni ambienti come non validi, ad esempio le richieste provenienti da un emulatore / simulatore o da un localhost durante lo sviluppo o da un ambiente di integrazione continua (CI).

Per eseguire l'app in questi tipi di ambienti dopo l'applicazione di App Check, devi creare una build di debug dell'app che utilizzi il App Check provider di debug anziché un provider di attestazione di produzione.

Per maggiori dettagli, consulta Utilizza App Check con il provider di debug nelle app Flutter.

Prezzi

App Check crea una valutazione per tuo conto per convalidare il token di risposta dell'utente ogni volta che la tua app aggiorna il token App Check. Al tuo progetto Firebase verrà addebitato un importo per ogni valutazione creata al di sopra della quota senza costi. Per i dettagli, consulta i prezzi di reCAPTCHA.

Per impostazione predefinita, la tua app aggiornerà questo token due volte ogni ora. Per controllare la frequenza con cui la tua app aggiorna i token App Check (e quindi la frequenza con cui vengono create nuove valutazioni), puoi configurare il TTL del token.