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 sulle piattaforme Apple

Seleziona la piattaforma:

iOS+ Android Web Flutter

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

App Check richiede l'utilizzo di chiavi basate sul punteggio reCAPTCHA, che lo rendono invisibile agli utenti. Ciò significa che il reCAPTCHA Enterprise provider non richiederà agli utenti di risolvere una richiesta di verifica in nessun momento.

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

1. Configurare il progetto Firebase

Se non l'hai già fatto, aggiungi Firebase al tuo progetto Apple.
Nella console Google Cloud, vai alla pagina Fraud Defense, ed esegui le seguenti operazioni per il provider reCAPTCHA Enterprise:
1. Assicurati di essere nel progetto corretto (vedi il selettore di progetto nella parte superiore dello schermo).
2. Se richiesto, attiva l'API reCAPTCHA Enterprise.
3. Crea una chiave di tipo iOS e specifica l'ID pacchetto dell'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.
  Per istruzioni dettagliate, vedi Creare chiavi reCAPTCHA basate sul punteggio.
4. Prendi nota di questa chiave. Dovrai aggiungerla al flusso di registrazione nella Firebase console.
Nella Firebase console, vai a Sicurezza > App Check.
Nella scheda App, registra le tue app per piattaforme Apple per utilizzare App Check con il reCAPTCHA Enterprise provider. Dovrai fornire la chiave che hai ottenuto nella console Google Cloud.

Importante: assicurati di registrare tutte le app del tuo progetto con un provider di attestazione (come reCAPTCHA Enterprise). Una volta attivata 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 App Check i token 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 la finestra in cui un token intercettato o trapelato può essere utilizzato in modo illecito da un utente malintenzionato.
- Rendimento: i TTL più brevi significano che la tua app eseguirà l'attestazione più frequentemente. Poiché il processo di attestazione dell'app aggiunge latenza alle richieste di rete ogni volta che viene eseguito, un TTL breve può influire sul rendimento dell'app.
- Quota e costi: i TTL più brevi e la riattestazione frequente esauriscono la quota più rapidamente e, per i servizi a pagamento, potrebbero costare di più. Vedi 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) Configurare le impostazioni avanzate

Quando un utente apre la tua app, reCAPTCHA Enterprise valuta il livello di rischio che l'interazione dell'utente comporta per 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 per 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 regolazione, puoi configurare questo valore per ciascuna delle tue app nella Firebase console (vai a Sicurezza > App Check). Assicurati di espandere e rivedere alcune considerazioni importanti sulla configurazione della soglia di rischio dell'app di seguito.

Visualizzare le considerazioni importanti sulla soglia di rischio dell'app

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

Se il tuo progetto Firebase è incluso nel piano tariffario Spark senza costi aggiuntivi, dei 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 i valori di soglia di rischio dell'app pari a 0,1, 0,3, 0,5, 0,7 e 0,9. Un valore di soglia di rischio dell'app pari a 0,5 è comunque consigliato per la maggior parte dei casi d'uso.
- Per attivare tutti gli 11 livelli di punteggio reCAPTCHA Enterprise, collega un account Cloud Billing al tuo progetto (il che significa che esegui l'upgrade del progetto Firebase al piano tariffario Blaze con pagamento a consumo ). Dopo aver 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 attivata una revisione automatica della sicurezza per il progetto. Per saperne di più, consulta la reCAPTCHA Enterprise documentazione.
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 dell'app alta , sposta il cursore verso destra per diminuire la soglia di rischio dell'app.
  - Un valore pari a 0,0 non è consigliato, in quanto questa impostazione disabilita la protezione dai comportamenti illeciti.
- Se hai una tolleranza al rischio dell'app bassa , sposta il cursore verso sinistra per aumentare la soglia di rischio dell'app.
  - Un valore pari a 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 interrompere l'attività degli utenti legittimi, aumenta gradualmente la soglia di rischio dell'app quando App Check è applicato. Monitora sempreApp Check le metriche delle richieste per verificare che il traffico non sia stato interrotto.

Per ulteriori dettagli, consulta la reCAPTCHA Enterprise documentazione.

2. Aggiungere l'SDK App Check all'app

Utilizza Swift Package Manager (SPM) per installare e gestire le dipendenze di Firebase. Se utilizzi già Firebase, assicurati che il pacchetto Firebase sia la versione 12.17.0 o successive.

In Xcode, apri il progetto dell'app.
Aggiungi la libreria Firebase:
1. Vai a File > Add Packages (File > Aggiungi pacchetti).
2. Quando richiesto, aggiungi il repository dell'SDK Firebase per piattaforme Apple:
```
https://github.com/firebase/firebase-ios-sdk
```
3. Seleziona la versione più recente dell'SDK (12.17.0 o successive).
4. Seleziona la libreria FirebaseAppCheck.
5. Fai clic su Add Package (Aggiungi pacchetto). Xcode risolverà e scaricherà le dipendenze.
6. Quando richiesto, aggiungi la libreria alla destinazione dell'app.
Aggiungi la libreria reCAPTCHA Enterprise:
1. Torna a File > Add Packages (File > Aggiungi pacchetti)
2. Quando richiesto, aggiungi il repository dell'SDK reCAPTCHA Enterprise:
```
https://github.com/GoogleCloudPlatform/recaptcha-enterprise-mobile-sdk
```
3. Seleziona la libreria RecaptchaEnterprise.
4. Fai clic su Add Package (Aggiungi pacchetto). Quando richiesto, aggiungi la libreria alla destinazione dell'app.

3. Inizializzare App Check

Nella tua app, devi inizializzare App Check prima di utilizzare altri servizi Firebase.

Crea un'istanza di RecaptchaProviderFactory, passando la chiave reCAPTCHA, quindi configura App Check per utilizzarla:

let providerFactory = RecaptchaProviderFactory(siteKey: "SITE_KEY")
AppCheck.setAppCheckProviderFactory(providerFactory)

FirebaseApp.configure()

4. Monitorare le metriche e attivare l'applicazione

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

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

Monitorare le metriche

_**Prima di attivare l'applicazione**_, assicurati che questa operazione non interrompa l'attività dei tuoi utenti legittimi esistenti. Tuttavia, se noti un utilizzo sospetto delle risorse dell'app, potresti voler attivare l'applicazione prima.

Per aiutarti a 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.

Attivare l'applicazione di App Check

Quando hai compreso l'impatto di App Check sugli utenti e sei pronto per procedere, puoi attivare l'applicazione di App Check:

Attiva App Check l'applicazione 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 per App CheckCloud Functions.

Utilizzare App Check negli 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 di App Check anziché un provider di attestazione di produzione.

Per ulteriori dettagli, vedi Utilizzare App Check con il provider di debug sulle piattaforme Apple.

Prezzi

App Check crea una valutazione per tuo conto per convalidare il token di risposta dell'utente ogni volta che l'app aggiorna il token App Check. Al tuo progetto Firebase verranno addebitati tutti i costi per le valutazioni create al di sopra della quota senza costi aggiuntivi. Per maggiori dettagli, vedi reCAPTCHA prezzi.

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