Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Premiers pas avec App Check et reCAPTCHA Enterprise sur les plates-formes Apple

Sélectionnez la plate-forme :

iOS+ Android Web Flutter

Cette page explique comment configurer App Check dans une application pour plates-formes Apple, à l'aide du fournisseur reCAPTCHA Enterprise. App Check permet de s'assurer que seule votre application peut accéder aux ressources backend de votre projet. Pour en savoir plus, consultez notre présentation de App Check.

App Check nécessite l'utilisation de clés basées sur le score reCAPTCHA, ce qui le rend invisible pour les utilisateurs. Cela signifie que le reCAPTCHA Enterprise fournisseur n'exigera à aucun moment des utilisateurs qu'ils résolvent un défi.

Si votre cas d'utilisation nécessite des fonctionnalités reCAPTCHA Enterprise non implémentées par App Check, ou si vous souhaitez utiliser App Check avec votre propre fournisseur personnalisé, consultez Implémenter un fournisseur App Check personnalisé.

1. Configurer votre projet Firebase

Si ce n'est pas encore fait, ajoutez Firebase à votre projet Apple.
Dans la console Google Cloud, accédez à la page Fraud Defense (Protection contre la fraude), puis procédez comme suit pour le fournisseur reCAPTCHA Enterprise :
1. Assurez-vous que vous vous trouvez dans le bon projet (voir le sélecteur de projet en haut de l'écran).
2. Si vous y êtes invité, activez l'API reCAPTCHA Enterprise.
3. Créez une clé de type iOS et spécifiez l'ID du bundle de votre application (par exemple, com.example.my_app).
  - Assurez-vous de saisir le même ID du bundle que celui que vous avez fourni lorsque vous avez créé votre application Firebase Apple dans votre projet Firebase. La valeur de l'ID du bundle est sensible à la casse.
  - Pour App Check, chaque ID du bundle ne peut correspondre qu'à une seule clé reCAPTCHA.
  Pour obtenir des instructions détaillées, consultez Créer des clés reCAPTCHA basées sur le score.
4. Notez cette clé. Vous devrez l'ajouter au flux d'enregistrement dans la Firebase console.
Dans la console Firebase, accédez à Security > App Check.
Dans l'onglet Apps (Applications), enregistrez vos applications pour plates-formes Apple afin d'utiliser App Check avec le fournisseur reCAPTCHA Enterprise. Vous devrez fournir la clé que vous avez obtenue dans la console Google Cloud.

Important : Veillez à enregistrer toutes les applications de votre projet auprès d'un fournisseur d'attestation (comme reCAPTCHA Enterprise). Une fois que vous avez activé l'application pour un service, seules les applications enregistrées pourront y accéder.
Facultatif : Définissez la valeur TTL (Time to Live) du jeton.

Dans les paramètres d'enregistrement de l'application, définissez une valeur TTL (Time to Live) personnalisée pour App Check jetons émis par le fournisseur. Vous pouvez définir la valeur TTL sur n'importe quelle valeur comprise entre 30 minutes et 7 jours. Lorsque vous modifiez cette valeur, tenez compte des compromis suivants :
- Sécurité : des valeurs TTL plus courtes offrent une sécurité renforcée, car elles réduisent la fenêtre dans laquelle un jeton divulgué ou intercepté peut être utilisé de manière abusive par un pirate informatique.
- Performances : des valeurs TTL plus courtes signifient que votre application effectuera l'attestation plus fréquemment. Étant donné que le processus d'attestation de l'application ajoute de la latence aux requêtes réseau chaque fois qu'il est effectué, une valeur TTL courte peut avoir un impact sur les performances de votre application.
- Quota et coût : des valeurs TTL plus courtes et une nouvelle attestation fréquente épuisent votre quota plus rapidement et, pour les services payants, peuvent entraîner des coûts plus élevés. Consultez Quotas et limites.
La valeur TTL par défaut de 1 heure est raisonnable pour la plupart des applications. Notez que la bibliothèque App Check actualise les jetons environ à la moitié de la durée TTL.
Facultatif : Configurez les paramètres avancés.
Cliquez sur Enregistrer.

(Facultatif) Configurer les paramètres avancés

Lorsqu'un utilisateur ouvre votre application, reCAPTCHA Enterprise évalue le niveau de risque que pose l'interaction de l'utilisateur sous la clé et renvoie un score compris entre 0,0 et 1,0, par incréments de 0,1.

Un score de 0,0 indique que l'interaction présente un risque élevé et peut être frauduleuse.
Un score de 1,0 indique que l'interaction présente un faible risque et est très probablement légitime.

App Check vous permet de configurer un seuil de risque de l'application afin d'ajuster votre tolérance à ce risque.

Dans la plupart des cas d'utilisation, la valeur de seuil par défaut de 0,5 est recommandée. Si votre cas d'utilisation nécessite un ajustement, vous pouvez configurer cette valeur pour chacune de vos applications dans la console Firebase (accédez à Security > App Check). Veillez à développer et à examiner certaines considérations importantes concernant la configuration du seuil de risque de l'application ci-dessous.

Consulter les considérations importantes concernant le seuil de risque de l'application

App Check utilise le seuil de risque de l'application que vous avez configuré comme score reCAPTCHA Enterprise minimal requis pour qu'une interaction de l'utilisateur soit considérée comme légitime. Tous les reCAPTCHA Enterprise scores strictement inférieurs au seuil que vous avez configuré seront rejetés. Lorsque vous ajustez le seuil de risque de votre application, tenez compte des points suivants :

Si votre projet Firebase est associé au forfait Spark sans frais, seuls les quatre niveaux de score suivants sont disponibles sur les 11 niveaux de score reCAPTCHA Enterprise possibles : 0,1, 0,3, 0,7 et 0,9.

Pendant ce temps, App Check n'autorisera que les valeurs de seuil de risque de l'application suivantes : 0,1, 0,3, 0,5, 0,7 et 0,9. Une valeur de seuil de risque de l'application de 0,5 est toujours recommandée pour la plupart des cas d'utilisation.
- Pour activer les 11 reCAPTCHA Enterprise niveaux de score, associez un Cloud Billing compte à votre projet (ce qui signifie que vous passez votre projet Firebase au forfait Blaze avec paiement à l'usage). Une fois votre projet mis à niveau, App Check vous permettra de configurer n'importe quelle valeur de seuil de risque de l'application comprise entre 0,0 et 1,0, par incréments de 0,1.
  
  Remarque : Une fois qu'un compte Cloud Billing est associé à votre projet, un examen de sécurité automatique est déclenché pour votre projet. Pour en savoir plus, consultez la reCAPTCHA Enterprise documentation.
Pour surveiller la distribution des scores reCAPTCHA Enterprise élevés et faibles pour votre application, accédez à la page reCAPTCHA Enterprise de la console Google Cloud, puis sélectionnez la clé utilisée par votre application.
Définissez le seuil de risque de votre application de manière appropriée pour votre tolérance :
- Si vous avez une tolérance élevée au risque de l'application, déplacez le curseur vers la droite pour diminuer le seuil de risque de l'application.
  - Une valeur de 0,0 n'est pas recommandée, car ce paramètre désactive la protection contre les utilisations abusives.
- Si vous avez une faible tolérance au risque de l'application, déplacez le curseur vers la gauche pour augmenter le seuil de risque de l'application.
  - Une valeur de 1,0 est n'est pas recommandée, car ce paramètre peut également empêcher l'accès à des utilisateurs légitimes qui ne répondent pas à ce seuil de confiance élevé.
  Avertissement : Pour éviter de perturber vos utilisateurs légitimes, augmentez progressivement le seuil de risque de l'application lorsque App Check est appliqué. Surveillez toujours les métriques de requête App Checkpour vérifier que le trafic n'a pas été interrompu.

Pour en savoir plus, consultez la reCAPTCHA Enterprise documentation.

2. Ajouter le App Check SDK à votre application

Utilisez Swift Package Manager (SPM) pour installer et gérer les dépendances Firebase. Si vous utilisez déjà Firebase, assurez-vous que votre package Firebase est la version 12.17.0 ou une version ultérieure.

Dans Xcode, ouvrez le projet de votre application.
Ajoutez la bibliothèque Firebase :
1. Accédez à File > Add Packages (Fichier > Ajouter des packages).
2. Lorsque vous y êtes invité, ajoutez le dépôt du SDK des plates-formes Firebase pour Apple :
```
https://github.com/firebase/firebase-ios-sdk
```
3. Sélectionnez la dernière version du SDK (version 12.17.0 ou ultérieure).
4. Sélectionnez la bibliothèque FirebaseAppCheck.
5. Cliquez sur Add Package (Ajouter un package). Xcode résoudra et téléchargera les dépendances.
6. Lorsque vous y êtes invité, ajoutez la bibliothèque à la cible de votre application.
Ajoutez la bibliothèque reCAPTCHA Enterprise :
1. Revenez à File > Add Packages (Fichier > Ajouter des packages).
2. Lorsque vous y êtes invité, ajoutez le dépôt du SDK reCAPTCHA Enterprise :
```
https://github.com/GoogleCloudPlatform/recaptcha-enterprise-mobile-sdk
```
3. Sélectionnez la bibliothèque RecaptchaEnterprise.
4. Cliquez sur Add Package (Ajouter un package). Lorsque vous y êtes invité, ajoutez la bibliothèque à la cible de votre application.

3. Initialiser App Check

Dans votre application, vous devez initialiser App Check avant d'utiliser d'autres services Firebase.

Créez une instance de RecaptchaProviderFactory, en transmettant votre reCAPTCHA clé, puis configurez App Check pour l'utiliser :

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

FirebaseApp.configure()

4. Surveiller les métriques et activer l'application

Une fois que vous avez configuré App Check dans votre application, commencez à distribuer l'application mise à jour à vos utilisateurs.

L'application cliente mise à jour commencera à envoyer des App Check jetons avec chaque requête adressée à Firebase. Toutefois, App Check ne bloquera pas les requêtes avec des jetons non valides tant que App Check ne sera pas appliqué.

Surveiller les métriques

_**Avant d'activer l'application**_, assurez-vous que cela ne perturbera pas vos utilisateurs légitimes existants. Toutefois, si vous constatez une utilisation suspecte des ressources de votre application, vous pouvez activer l'application plus tôt.

Pour vous aider à prendre cette décision, vous pouvez examiner les métriques App Check pour les services que vous utilisez :

Surveillez les métriques de requête App Check pour Firebase AI Logic, SQL Connect, Realtime Database, Cloud Firestore, Cloud Storage, Authentication, Google Identity pour iOS, API Maps JavaScript et API Places (New).
Surveillez les métriques de requête App Check pour Cloud Functions.

Activer l'application App Check

Lorsque vous comprenez l'impact de App Check sur vos utilisateurs et que vous êtes prêt à continuer, vous pouvez activer l'application App Check :

Activez App Check l'application pour Firebase AI Logic, SQL Connect, Realtime Database, Cloud Firestore, Cloud Storage, Authentication, Google Identity pour iOS, Maps JavaScript API et Places API (New).
Activez App Check l'application pour Cloud Functions.

Utiliser App Check dans des environnements de débogage

App Check classe certains environnements comme non valides, tels que les requêtes provenant d' un émulateur / simulateur lors du développement ou d'un environnement d'intégration continue (CI).

Pour exécuter votre application dans ces types d'environnements une fois App Check appliqué, vous devez créer une version de débogage de votre application qui utilise le App Check fournisseur de débogage au lieu d'un fournisseur d'attestation de production.

Pour en savoir plus, consultez Utiliser App Check avec le fournisseur de débogage sur les plates-formes Apple.

Tarifs

App Check crée une évaluation en votre nom pour valider le jeton de réponse de l'utilisateur chaque fois que votre application actualise son jeton App Check. Votre projet Firebase sera facturé pour chaque évaluation créée au-delà du quota sans frais. Pour en savoir plus, consultez les tarifs reCAPTCHA.

Par défaut, votre application actualisera ce jeton deux fois par heure. Pour contrôler la fréquence à laquelle votre application actualise les jetons App Check (et donc la fréquence à laquelle de nouvelles évaluations sont créées), vous pouvez configurer la valeur TTL du jeton.