Integrar reCAPTCHA Enterprise en apps para iOS

En esta página, se explica cómo integrar reCAPTCHA Enterprise en tu app para iOS. Debido a la variación en los dispositivos móviles en términos de tamaño, rendimiento y IU de las apps, el desafío visual de reCAPTCHA (I' m no es un robot) no está disponible para apps para dispositivos móviles. Si deseas conocer un método de fricción alternativo, consulta Cómo configurar la autenticación de varios factores (MFA).

Antes de comenzar

  1. Elige el mejor método para configurar reCAPTCHA Enterprise en tu entorno y completa la configuración.

  2. Crea una clave de reCAPTCHA para la plataforma de apps de iOS.

  3. Se puede acceder al SDK de iOS después de una revisión de seguridad. Comunícate con nuestro equipo de ventas para incorporar tu sitio a esta función.

  4. Solicita a tu representante de ventas que te otorgue acceso al repositorio de reCAPTCHA Enterprise CocoaPods y a la página de descarga del SDK para iOS .

  5. Para preparar tu entorno de desarrollo, haz lo siguiente:

    • Descarga y, luego, instala la versión más reciente de Xcode y crea una nueva aplicación de vista única para iOS.
    • Descarga e instala CocoaPods.

    • Descarga el SDK usando CocoaPods o desde la página de descarga.

      CocoaPods

      1. Genera una cookie de Git.
      2. Crea un Podfile y agrega las siguientes líneas a tu Podfile:

        source "https://cpdc-eap.googlesource.com/RecaptchaEnterprise.git"
        source "https://github.com/CocoaPods/Specs.git"
        
        pod "RecaptchaEnterprise", "16.1.0"
        
      3. Para instalar las dependencias necesarias, ejecuta pod update.

      Descarga directa

      Descarga el objeto binario del SDK directamente desde la página de descarga del SDK para iOS .

Configura la app

Con CocoaPods, puedes escribir tus apps en Swift o Objective-C. Para configurar tu app, haz lo siguiente:

  1. Para asegurarte de que -ObjC aparezca en tus marcas de vinculador, navega hasta Target > Build Settings > All > Linking y verifica que Other Linker Flags muestre -ObjC.

  2. Si tu app está escrita en Swift, crea un encabezado puente puente Objective-C y, además, incluye la siguiente importación:

    #import <recaptcha/recaptcha.h>
    

Cómo integrar reCAPTCHA Enterprise a tu app para iOS

Para integrar reCAPTCHA Enterprise con tu app para iOS, sigue estos pasos en Xcode:

  1. Para crear una instancia del SDK con la clave de reCAPTCHA que creaste, actualiza ViewController con el siguiente código:

    Swift

    let recaptchaClient = RecaptchaClient(siteKey: "reCAPTCHA_KEY_iOS")
    

    Objective-C

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

  2. Crea un botón para llamar a reCAPTCHA Enterprise y activa el código que incorporaste en ViewController:

    1. En el guión gráfico, crea un botón.
    2. Crea una acción en ViewController vinculada al botón que creaste.
    3. Llama al método execute() para que muestre un token de reCAPTCHA mediante el siguiente fragmento de código:

      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. Prueba tu aplicación:

    1. Para limpiar el entorno de compilación de Xcode, haz clic en Limpiar carpeta de compilación en el menú Producto.
    2. Para ejecutar la aplicación, en el menú Producto, haz clic en Ejecutar.
    3. En tu aplicación cargada, haz clic en el botón reCAPTCHA que creaste antes.
    4. Observa tu ventana de salida de depuración para un token de reCAPTCHA (string alfanumérico), que se muestra si la integración es exitosa.

Referencia de API de iOS

Comuníquese con su representante de ventas para que le otorgue acceso a la página de descarga del SDK de iOS. En la página de descarga del SDK para iOS, se explican los detalles de la etiqueta de privacidad de reCAPTCHA.

¿Qué sigue?