Intégrer reCAPTCHA Enterprise aux applications iOS

Cette page explique comment intégrer reCAPTCHA Enterprise dans votre application iOS. En raison de la variation des appareils mobiles en termes de taille d'écran, de performances et d'interfaces utilisateur des applications, le défi reCAPTCHA s'affiche ("m n'est pas un robot") n'est pas disponible pour les applications mobiles. Pour découvrir une autre méthode de friction, consultez la page Configurer l'authentification multifacteur (MFA).

Avant de commencer

  1. Choisissez la meilleure méthode pour configurer reCAPTCHA Enterprise dans votre environnement et terminez la configuration.

  2. Créez une clé reCAPTCHA pour la plate-forme d'applications iOS.

  3. Le SDK iOS est accessible après un examen de sécurité. Contactez notre équipe commerciale pour activer cette fonctionnalité sur votre site.

  4. Demandez à votre conseiller commercial de vous accorder l'accès au dépôt reCAPTCHA Enterprise CocoaPods et à la page de téléchargement du SDK iOS .

  5. 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 unique à affichage unique.
    • Téléchargez et installez CocoaPods.

    • Téléchargez le SDK à l'aide de CocoaPods ou depuis la page de téléchargement.

      CocoaPods

      1. Générez un cookie git.
      2. Créez un fichier Podfile et ajoutez les lignes suivantes à celui-ci:

        source "https://cpdc-eap.googlesource.com/RecaptchaEnterprise.git"
        source "https://github.com/CocoaPods/Specs.git"
        
        pod "RecaptchaEnterprise", "16.1.0"
        
      3. Installez les dépendances requises en exécutant pod update.

      Téléchargement direct

      Téléchargez le binaire du SDK directement depuis la page de téléchargement du SDK iOS .

Configurer l'application

Avec CocoaPods, vous pouvez écrire vos applications dans Swift ou Objective-C. Pour configurer votre application, procédez comme suit:

  1. Pour vous assurer que -ObjC est répertorié dans vos indicateurs Linker, accédez à Cible > Paramètres de compilation > Toutes > Association, puis vérifiez que Other Linker Flags affiche -ObjC.

  2. Si votre application est écrite en Swift, créez un en-tête de liaison Objective-C et incluez l'importation suivante:

    #import <recaptcha/recaptcha.h>
    

Intégrer reCAPTCHA Enterprise à votre application iOS

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

  1. Pour instancier le SDK avec la clé reCAPTCHA que vous avez créée, mettez à jour ViewController avec le code suivant:

    Swift

    let recaptchaClient = RecaptchaClient(siteKey: "reCAPTCHA_KEY_iOS")
    

    Objective-C

    RecaptchaClient *recaptchaClient = [[RecaptchaClient alloc] initWithSiteKey:@"reCAPTCHA_KEY_iOS"];
    

  2. Créez un bouton pour appeler reCAPTCHA Enterprise et déclencher le code que vous avez intégré dans ViewController:

    1. Dans le story-board, créez un bouton.
    2. Créez une action dans ViewController associée au bouton que vous avez créé.
    3. Appelez la méthode execute() pour renvoyer un jeton reCAPTCHA à l'aide de l'extrait de code suivant:

      Swift

      recaptchaClient.execute(RecaptchaAction(action: .login)) { token, error in
       if let recaptchaToken = token {
              print(recaptchaToken.recaptchaToken)
           }
            if let error = error {
              print(error)
            }
       }
      

      Objective-C

       [recaptchaClient execute: [[RecaptchaAction alloc] initWithAction: RecaptchaActionTypeLogin] onFinishedExecute: ^ (RecaptchaToken * _Nullable token, RCARecaptchaError * _Nullable error) {
      
           if (error) {
               NSLog (@ "% @", error);
           } else {
               NSLog (@ "% @", token);
           }
      
       }];
      
      

  3. Testez votre application:

    1. Pour nettoyer votre environnement de compilation Xcode, cliquez sur le menu Produit dans le menu Produit,
    2. Pour exécuter l'application, dans le menu Produit, cliquez sur Exécuter.
    3. Dans l'application chargée, cliquez sur le bouton reCAPTCHA que vous avez créé précédemment.
    4. Observez la fenêtre de sortie de débogage pour obtenir un jeton reCAPTCHA (chaîne alphanumérique) affiché si l'intégration a réussi.

Référence d'API pour iOS

Contactez votre conseiller commercial pour lui demander d'accéder à la page de téléchargement du SDK iOS. La page de téléchargement du SDK iOS explique en détail l'étiquette de confidentialité reCAPTCHA.

Étape suivante