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.

Intégrer Google Cloud Fraud Defense aux applications iOS

Vous pouvez intégrer Google Cloud Fraud Defense aux applications iOS pour évaluer les signaux des appareils clients et protéger les interactions des utilisateurs mobiles contre les utilisations abusives automatisées.

En raison de la variation des appareils mobiles en termes de taille d'écran, de performances et d'UI des applications, le test reCAPTCHA visuel avec case à cocher (Je ne suis pas un robot) n'est pas disponible pour les applications mobiles iOS. Vous pouvez plutôt implémenter votre propre stratégie d'application par niveaux, comme un flux MFA pour fournir un autre chemin d'utilisation pour le trafic suspect.

Le SDK utilise la réflexion et le code dynamique pour permettre la mise à jour et l'amélioration du système de détection dans les applications ou les SDK déjà déployés. Pour éviter toute interférence avec l'application, les classes disponibles dans le système sont limitées à une liste soigneusement contrôlée.

Avant de commencer

Définissez la version minimale du SDK de votre application sur iOS 15 ou créez une application mobile.

Remarque : reCAPTCHA est compatible avec les iPhone et les iPad.
Préparer votre environnement pour Google Cloud Fraud Defense
Créez une clé reCAPTCHA pour la plate-forme d'application iOS.

Vous pouvez également copier l'ID d'une clé reCAPTCHA existante pour iOS en effectuant l'une des étapes suivantes :
- Pour copier l'ID d'une clé existante à partir de la consoleGoogle Cloud , procédez comme suit :
  1. Accédez à la page Google Cloud Fraud Defense.
    
    Accéder à Google Cloud Fraud Defense
  2. Sélectionnez l'onglet Keys (clés).
  3. Dans la liste des clés reCAPTCHA, recherchez la clé que vous souhaitez copier, puis cliquez sur .
- Pour copier l'ID d'une clé existante à l'aide de l'API REST, utilisez la méthode projects.keys.list.
- Pour copier l'ID d'une clé existante à l'aide de la gcloud CLI, utilisez la commande gcloud recaptcha keys list.
disposer d'un compte GitHub ;
Consultez les informations d'Apple sur la confidentialité.

Préparer votre environnement iOS

Pour préparer votre environnement de développement, procédez comme suit :

Téléchargez et installez la dernière version de Xcode, puis créez une application iOS vide à vue unique.
Téléchargez le SDK à l'aide de l'une des méthodes suivantes :
CocoaPods
1. Téléchargez et installez CocoaPods.
2. Créez un fichier Podfile et ajoutez les lignes suivantes à votre Podfile :
  
  source "https://github.com/CocoaPods/Specs.git" target 'AppTarget' do # Podfiles must include use_frameworks! or # use_frameworks! :linkage => :static use_frameworks! pod "RecaptchaEnterprise", "18.10.0-beta01" ... end
3. Installez les dépendances requises en exécutant la commande pod update.
  
  Remarque : L'exécution de pod clone n'installe pas les dépendances requises.
Swift Package Manager
1. Dans Xcode, sélectionnez File > Add Packages (Fichier > Ajouter des packages), puis saisissez l'URL suivante dans le champ Search (Rechercher) ou Enter Package URL (Saisir l'URL du package) :
  
  https://github.com/GoogleCloudPlatform/recaptcha-enterprise-mobile-sdk
2. Dans la boîte de dialogue Xcode, saisissez les informations suivantes :
  
  Nom d'utilisateur GitHub.
  
  Un jeton d'accès personnel que vous avez créé en suivant les instructions de GitHub. Le jeton d'accès personnel doit disposer des champs d'application listés dans la boîte de dialogue Xcode Sign In (Connexion Xcode).
  
  Xcode installe le SDK et ses dépendances requises.
Flutter
Pour obtenir des instructions détaillées sur l'utilisation de reCAPTCHA via Flutter, consultez la documentation Flutter.

React Native
Pour obtenir des instructions détaillées sur l'utilisation de reCAPTCHA via React Native, consultez la documentation de React Native.
Téléchargement direct
1. Si vous souhaitez télécharger le SDK et ses dépendances en tant que xcframeworks, téléchargez le client.
  
  Remarque : Ajoutez tous les binaires en tant que xcframeworks statiques.

Intégrer Fraud Defense à votre application iOS

Pour intégrer Fraud Defense à votre application iOS, procédez comme suit dans Xcode :

Pour instancier le SDK avec la clé reCAPTCHA (KEY_ID) que vous avez créée, mettez à jour l'application avec le code suivant :

Swift avec Storyboard

Mettez à jour ViewController.swift.

import RecaptchaEnterprise

class ViewController: UIViewController {
  var recaptchaClient: RecaptchaClient?

  override func viewDidLoad() {
    super.viewDidLoad()
    Task {
      do {
        self.recaptchaClient = try await Recaptcha.fetchClient(withSiteKey: "KEY_ID")
      } catch let error as RecaptchaError {
         print("RecaptchaClient creation error: \(String(describing: error.errorMessage)).")
      }
    }
  }
}

Si la version minimale de l'OS de votre application est inférieure à 13, utilisez plutôt une fermeture de fin :

import RecaptchaEnterprise

class ViewController: UIViewController {
  var recaptchaClient: RecaptchaClient?

  override func viewDidLoad() {
    super.viewDidLoad()
    Recaptcha.fetchClient(withSiteKey: "KEY_ID") { client, error in
      guard let client = client else {
          print("RecaptchaClient creation error: \(error).")
        return
      }
      self.recaptchaClient = client
    }
  }
}

Swift avec SwiftUI

Créer une classe ViewModel

import RecaptchaEnterprise

@MainActor class ViewModel: ObservableObject {
  private var recaptchaClient: RecaptchaClient?

  init() {
     Task {
      do {
        self.recaptchaClient = try await Recaptcha.fetchClient(withSiteKey: "KEY_ID")
      } catch let error as RecaptchaError {
         print("RecaptchaClient creation error: \(String(describing: error.errorMessage)).")
      }
    }
  }
}

Si la version minimale de l'OS de votre application est inférieure à 13, utilisez plutôt une fermeture de fin :

import RecaptchaEnterprise

class ViewController: UIViewController {
  var recaptchaClient: RecaptchaClient?

  override func viewDidLoad() {
    super.viewDidLoad()
    Recaptcha.fetchClient(withSiteKey: "KEY_ID") { client, error in
      guard let client = client else {
          print("RecaptchaClient creation error: \(error).")
        return
      }
      self.recaptchaClient = client
    }
  }
}

Instanciez ViewModel dans ContentView.swift.

import SwiftUI
import RecaptchaEnterprise

struct ContentView: View {
  @StateObject private var viewModel = ViewModel()

  var body: some View {
  }
}

struct ContentView_Previews: PreviewProvider {
  static var previews: some View {
    ContentView()
  }
}

Objective-C

Si votre application est écrite en Objective-C, créez un fichier Swift factice et incluez l'importation suivante pour vous assurer que Xcode peut trouver les bibliothèques Swift et les associer.
```
import Foundation
```
Pour vous assurer que le code Swift est correctement associé, accédez à Target > Build Settings > Always Embed Swift Standard Libraries (Cible > Paramètres de compilation > Toujours intégrer les bibliothèques Swift standards) et vérifiez que l'option est définie sur Yes.

Mettez à jour ViewController.h.

#import <RecaptchaEnterprise/RecaptchaEnterprise.h>

@interface ViewController : UIViewController
@property (strong, atomic) RecaptchaClient *recaptchaClient;
@end

Mettez à jour ViewController.m.

@implementation ViewController
[Recaptcha fetchClientWithSiteKey:@"KEY_ID"
      completion:^void(RecaptchaClient* recaptchaClient, NSError* error) {
        if (!recaptchaClient) {
          NSLog(@"%@", (RecaptchaError *)error.errorMessage);
          return;
        }
        self->_recaptchaClient = recaptchaClient;
      }
];
@end

L'initialisation du SDK peut prendre plusieurs secondes. Pour limiter cette latence, initialisez le client le plus tôt possible, par exemple lors de l'appel onCreate() d'une classe Application personnalisée. Vous ne devez pas bloquer les éléments d'interface utilisateur sur le SDK reCAPTCHA.

Créez un bouton pour appeler reCAPTCHA et déclencher execute().

Swift avec Storyboard

Créez un bouton dans le storyboard.
Créez une action dans ViewController associée au bouton que vous avez créé.

Appelez la méthode execute() en transmettant une action Login pour renvoyer un jeton reCAPTCHA à l'aide de l'extrait de code suivant :

guard let recaptchaClient = recaptchaClient else {
  print("RecaptchaClient creation failed.")
  return
}
Task {
  do {
    let token = try await recaptchaClient.execute(withAction: RecaptchaAction.login)
    print(token)
  } catch let error as RecaptchaError {
    print(error.errorMessage)
  }
}

Si la version minimale de l'OS de votre application est inférieure à 13, utilisez plutôt une fermeture de fin :

guard let recaptchaClient = recaptchaClient else {
  print("RecaptchaClient creation failed.")
  return
}
recaptchaClient.execute(withAction: RecaptchaAction.login) { token, error in
  if let token = token {
    print(token)
  } else {
    print(error)
  }
}

Swift avec SwiftUI

Mettez à jour ViewModel.swift avec le code d'exécution :

import RecaptchaEnterprise

@MainActor class ViewModel: ObservableObject {

  func execute() {
    guard let recaptchaClient = self.recaptchaClient else {
      print("Client not initialized correctly.")
      return
    }

    Task {
      do {
        let token = try await recaptchaClient.execute(withAction: RecaptchaAction.login)
        print(token)
      } catch let error as RecaptchaError {
        print(error.errorMessage)
      }
    }
  }
}

Si la version minimale de l'OS de votre application est inférieure à 13, utilisez plutôt une fermeture de fin :

guard let recaptchaClient = recaptchaClient else {
  print("RecaptchaClient creation failed.")
  return
}
recaptchaClient.execute(withAction: RecaptchaAction.login) { token, error in
  if let token = token {
    print(token)
  } else {
    print(error)
  }
}

Mettez à jour ContentView.swift.

import SwiftUI
import RecaptchaEnterprise

struct ContentView: View {
  @StateObject private var viewModel = ViewModel()

  var body: some View {

    Button {
      viewModel.execute()
    } label: {
      Text("Execute")
    }.padding()

    Spacer()
  }
}

struct ContentView_Previews: PreviewProvider {
  static var previews: some View {
    ContentView()
  }
}

Objective-C

Dans le storyboard, créez un bouton.
Créez une action dans ViewController associée au bouton que vous avez créé.

Appelez la méthode execute() en transmettant une action Login pour renvoyer un jeton reCAPTCHA :

if (!self->_recaptchaClient) {
  return;
}

[recaptchaClient execute:RecaptchaAction.login
    completion:^void(NSString* _Nullable  token, NSError* _Nullable error) {
  if (!token) {
    NSLog (@"%@", (RecaptchaError *)error.errorMessage);
    return;
  }
  NSLog (@"%@", token);
}];

L'API execute du client peut prendre plusieurs secondes, par exemple si la connexion réseau est lente ou si elle attend la fin de l'initialisation en arrière-plan. Assurez-vous que les appels execute() ne bloquent pas un événement d'interface utilisateur, comme l'appui sur un bouton.

Testez votre application :
1. reCAPTCHA utilise l'API App Attest d'Apple dans son moteur de détection. Si vous ne prévoyez pas d'utiliser une clé de test avec un score fixe pour le développement local, procédez comme suit :
  1. Dans Xcode, ajoutez la fonctionnalité App Attest à votre application.
  2. Dans le fichier .entitlements de votre projet, définissez l'environnement App Attest sur production.
2. Pour nettoyer votre environnement de compilation Xcode, dans le menu Product (Produit), cliquez sur Clean Build Folder (Nettoyer le dossier de compilation).
3. Pour exécuter l'application, dans le menu Product (Produit), cliquez sur Run (Exécuter).
4. Dans l'application chargée, cliquez sur le bouton que vous avez créé précédemment.
5. Observez la fenêtre de sortie de débogage pour un jeton reCAPTCHA (chaîne alphanumérique), qui est renvoyé si l'intégration réussit.

Migrer de la méthode getClient vers la méthode fetchClient

La méthode fetchClient renvoie un RecaptchaClient qui relance l'initialisation en cas de défaillance du réseau. Si l'application n'a pas accès au réseau lors de la création du client, celui-ci continue de réessayer et s'initialise correctement lorsqu'un réseau est acquis.

Si vous appelez execute(timeout) et que le client n'est pas encore prêt, il tente de s'initialiser avant de renvoyer un jeton ou une RecaptchaError.

L'exemple suivant montre comment migrer de getClient vers fetchClient.

Swift avec Storyboard

// Migrate from getClient
func initializeWithGetClient() {
  Task {
    do {
      self.recaptchaClient = try await Recaptcha.getClient(withSiteKey: "KEY_ID")
    } catch let error as RecaptchaError {
        print("RecaptchaClient creation error: \(String(describing: error.errorMessage)).")
    }
  }
}

// Migrate to fetchClient
func initializeWithFetchClient() {
  Task {
    do {
      self.recaptchaClient = try await Recaptcha.fetchClient(withSiteKey: "KEY_ID")
    } catch let error as RecaptchaError {
        print("RecaptchaClient creation error: \(String(describing: error.errorMessage)).")
    }
  }
}

Si la version minimale de l'OS de votre application est inférieure à 13, utilisez plutôt une fermeture de fin :

// Migrate from getClient
override func initializeWithGetClient() {
  Recaptcha.getClient(withSiteKey: "KEY_ID") { client, error in
    guard let client = client else {
        print("RecaptchaClient creation error: \(error).")
      return
    }
    self.recaptchaClient = client
  }
}

// Migrate to fetchClient
override func initializeWithFetchClient() {
  Recaptcha.fetchClient(withSiteKey: "KEY_ID") { client, error in
    guard let client = client else {
        print("RecaptchaClient creation error: \(error).")
      return
    }
    self.recaptchaClient = client
  }
}

Swift avec SwiftUI

// Migrate from getClient
func initializeWithGetClient() {
    Task {
    do {
      self.recaptchaClient = try await Recaptcha.getClient(withSiteKey: "KEY_ID")
    } catch let error as RecaptchaError {
        print("RecaptchaClient creation error: \(String(describing: error.errorMessage)).")
    }
  }
}

// Migrate to fetchClient
func initializeWithFetchClient() {
    Task {
    do {
      self.recaptchaClient = try await Recaptcha.fetchClient(withSiteKey: "KEY_ID")
    } catch let error as RecaptchaError {
        print("RecaptchaClient creation error: \(String(describing: error.errorMessage)).")
    }
  }
}

Si la version minimale de l'OS de votre application est inférieure à 13, utilisez plutôt une fermeture de fin :

// Migrate from getClient
func initializeWithGetClient() {
  super.viewDidLoad()
  Recaptcha.getClient(withSiteKey: "KEY_ID") { client, error in
    guard let client = client else {
        print("RecaptchaClient creation error: \(error).")
      return
    }
    self.recaptchaClient = client
  }
}

// Migrate to fetchClient
func initializeWithFetchClient() {
  super.viewDidLoad()
  Recaptcha.fetchClient(withSiteKey: "KEY_ID") { client, error in
    guard let client = client else {
        print("RecaptchaClient creation error: \(error).")
      return
    }
    self.recaptchaClient = client
  }
}

Objective-C

// Migrate from getClient
@implementation ViewController
[Recaptcha getClientWithSiteKey:@"KEY_ID"
      completion:^void(RecaptchaClient* recaptchaClient, NSError* error) {
        if (!recaptchaClient) {
          NSLog(@"%@", (RecaptchaError *)error.errorMessage);
          return;
        }
        self->_recaptchaClient = recaptchaClient;
      }
];
@end

// Migrate to fetchClient
@implementation ViewController
[Recaptcha fetchClientWithSiteKey:@"KEY_ID"
      completion:^void(RecaptchaClient* recaptchaClient, NSError* error) {
        if (!recaptchaClient) {
          NSLog(@"%@", (RecaptchaError *)error.errorMessage);
          return;
        }
        self->_recaptchaClient = recaptchaClient;
      }
];
@end

Définir un délai avant expiration pour les appels d'API

Vous pouvez spécifier une valeur de délai avant expiration pour les API execute à l'aide de la propriété withTimeout.

Swift

Définissez le délai avant expiration lors de l'appel de execute.

  Task {
    do {
      let token = try await recaptchaClient.execute(
        withAction: RecaptchaAction.login,
        withTimeout: 10000)
      print(token)
    } catch let error as RecaptchaError {
      print(error.errorMessage)
    }
  }

Si la version minimale de l'OS de votre application est inférieure à 13, utilisez plutôt une fermeture de fin :

  recaptchaClient.execute(
    withAction: RecaptchaAction.login,
    withTimeout: 10000
  ) { token, error in
    if let token = token {
      print(token)
    } else {
      print(error)
    }
  }

Objective-C

Définissez le délai avant expiration lors de l'appel de execute.

  [recaptchaClient execute:RecaptchaAction.login
      withTimeout:10000.0
      completion:^void(NSString* _Nullable  token, NSError* _Nullable error) {
    if (!token) {
      NSLog (@"%@", (RecaptchaError *)error.errorMessage);
      return;
    }
    NSLog (@"%@", token);
  }];

Gérer les erreurs

Si votre application ne parvient pas à communiquer avec le service reCAPTCHA, cela peut être dû à une erreur de l'API. Vous devez ajouter une logique dans votre application pour gérer correctement ces erreurs.

Pour en savoir plus sur les corrections des erreurs d'API courantes, consultez RecaptchaErrorCode.

Documentation de référence de l'API

Pour obtenir une documentation de référence complète sur l'API reCAPTCHA pour iOS, consultez RecaptchaEnterprise.

Étapes suivantes

Pour évaluer le jeton de réponse reCAPTCHA, créez une évaluation.

Remarque : Les jetons de réponse reCAPTCHA sont évalués et annotés à partir de votre serveur backend, et non de l'appareil mobile.

Intégrer Google Cloud Fraud Defense aux applications iOS Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Avant de commencer

Préparer votre environnement iOS

CocoaPods

Swift Package Manager

Flutter

React Native

Téléchargement direct

Intégrer Fraud Defense à votre application iOS

Swift avec Storyboard

Swift avec SwiftUI

Objective-C

Swift avec Storyboard

Swift avec SwiftUI

Objective-C

Migrer de la méthode getClient vers la méthode fetchClient

Swift avec Storyboard

Swift avec SwiftUI

Objective-C

Définir un délai avant expiration pour les appels d'API

Swift

Objective-C

Gérer les erreurs

Documentation de référence de l'API

Étapes suivantes

Intégrer Google Cloud Fraud Defense aux applications iOS