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 su Android

Seleziona la piattaforma:

iOS+ Android Web Flutter

Questa pagina mostra come configurare App Check in un'app per Android 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 già fatto, aggiungi Firebase al tuo progetto Android.
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 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 per Android Firebase nel 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.
  Per istruzioni dettagliate, consulta Crea chiavi reCAPTCHA basate su punteggio.
4. Prendi nota di questa chiave. Dovrai aggiungerlo al flusso di registrazione nella console Firebase.
Nella console Firebase, vai a Sicurezza > App Check.
Nella scheda App, registra le tue app per Android 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.

2. Aggiungi l'SDK App Check alla tua app

Per utilizzare il provider reCAPTCHA Enterprise, devi aggiungere la dipendenza corrispondente.

Nel file Gradle del modulo (a livello di app) (di solito <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle), aggiungi la dipendenza per la libreria App Check reCAPTCHA per Android. Ti consigliamo di utilizzare Firebase Android BoM per controllare il controllo delle versioni della libreria.

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:35.1.0"))

    // Add the dependency for the App Check reCAPTCHA library
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-appcheck-recaptcha")
}

Con la Firebase Android BoM, la tua app utilizzerà sempre versioni compatibili delle librerie Firebase Android.

(Alternativa) Aggiungi le dipendenze della libreria Firebase senza utilizzare BoM

Se scegli di non utilizzare la Firebase BoM, devi specificare ogni versione della libreria Firebase nella riga di dipendenza.

Tieni presente che se utilizzi più librerie Firebase nella tua app, ti consigliamo vivamente di utilizzare BoM per gestire le versioni delle librerie, in modo da garantire che tutte le versioni siano compatibili.

dependencies {
    // Add the dependency for the App Check reCAPTCHA library
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-appcheck-recaptcha:20.0.0")
}

3. Inizializza App Check

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

Kotlin

Firebase.initialize(context = this)
Firebase.appCheck.installAppCheckProviderFactory(
    RecaptchaAppCheckProviderFactory.getInstance("SITE_KEY")
)

Java

FirebaseApp.initializeApp(/*context=*/ this);
FirebaseAppCheck firebaseAppCheck = FirebaseAppCheck.getInstance();
firebaseAppCheck.installAppCheckProviderFactory(
      RecaptchaAppCheckProviderFactory.getInstance("SITE_KEY"));

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 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 su Android.

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.