Integrazione di reCAPTCHA Enterprise con le app iOS

Questa pagina spiega come integrare reCAPTCHA Enterprise nella tua app per iOS. A causa della variazione dei dispositivi mobili in termini di dimensioni dello schermo, prestazioni e UI delle app, la verifica visiva di reCAPTCHA (Non sono un robot) non è disponibile per le app per dispositivi mobili. Per un metodo di attrito alternativo, consulta Configurazione dell'autenticazione a più fattori (MFA).

Prima di iniziare

  1. Scegli il metodo migliore per configurare reCAPTCHA Enterprise nel tuo ambiente e completa la configurazione.

  2. L'SDK per iOS è accessibile dopo un controllo di sicurezza. Contatta il nostro team di vendita per l'onboarding del tuo sito su questa funzionalità.

  3. Crea una chiave reCAPTCHA per la piattaforma dell'app per iOS.

  4. A seconda del metodo di integrazione, chiedi al tuo rappresentante di vendita di concederti l'accesso a uno dei seguenti elementi: il repository reCAPTCHA Enterprise CocoaPods, il repository di Swift Package Manager o il download dell'SDK iOS.

  5. Per preparare l'ambiente di sviluppo:

    • Scarica e installa la versione più recente di Xcode e crea una nuova applicazione vuota iOS per visualizzazione singola.
    • Scarica e installa CocoaPods.

      Le dimensioni del pod reCAPTCHA Enterprise sono abbastanza grandi. Tuttavia, dopo l'installazione di reCAPTCHA Enterprise, a causa del collegamento dinamico delle dimensioni dell'IPA dell'utente e dell'app installata, gli utenti hanno rispettivamente circa 598 kB e 1,786 MB.

    • Scarica l'SDK utilizzando CocoaPods, Swift Package Manager o dalla pagina di download.

      CocoaPods

      1. Genera un cookie Git.
      2. Crea un Podfile e aggiungi al podfile le righe seguenti:

        source "https://cpdc-eap.googlesource.com/RecaptchaEnterprise.git"
        source "https://github.com/CocoaPods/Specs.git"
        
        pod "RecaptchaEnterprise", "17.0.0"
        
      3. Installa le dipendenze obbligatorie eseguendo pod update.

      Gestore pacchetti Swift

      1. In XCode, seleziona File > Aggiungi pacchetti, e inserisci il seguente URL nel campo Cerca o Inserisci URL pacchetto: https://github.com/GoogleCloudPlatform/recaptcha-enterprise-mobile-sdk
      2. Nella finestra di dialogo XCode, inserisci il nome utente GitHub del tuo rappresentante di vendita per l'account e un token di accesso personale creato utilizzando le istruzioni di GitHub. Il token di accesso personale deve avere gli ambiti elencati nella finestra di dialogo Accesso XCode.

        Xcode installa l'SDK e le sue dipendenze obbligatorie.

      Download diretto

      Scarica il programma binario dell'SDK dalla pagina Download dell'SDK per iOS.

Configurazione dell'applicazione

Con CocoaPods puoi scrivere le tue app in Swift o Objective-C. Per configurare l'app:

  1. Per assicurarti che -ObjC sia presente nei flag dei linker, vai a Target > Build Settings > All >Link (Verifica > Impostazioni di creazione > Tutto > Collegamento) e verifica che Other Linker Flags mostri -ObjC.

  2. Se la tua app è scritta in Swift, crea un'intestazione bridging Objective-C e includi la seguente importazione:

    #import <recaptcha/recaptcha.h>
    

Integrazione di reCAPTCHA Enterprise con la tua app per iOS

Per integrare reCAPTCHA Enterprise con la tua app per iOS, segui questi passaggi in Xcode:

  1. Per creare un'istanza dell'SDK con la chiave reCAPTCHA che hai creato, aggiorna ViewController con il codice seguente:

    Swift

    let recaptchaClient = RecaptchaClient(siteKey: "reCAPTCHA_KEY_iOS")
    

    Objective-C

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

  2. Crea un pulsante per chiamare reCAPTCHA Enterprise e attivare il codice che hai incorporato in ViewController:

    1. Nello storyboard, crea un pulsante.
    2. Crea un'azione in ViewController collegata al pulsante che hai creato.
    3. Chiama il metodo execute() per restituire un token reCAPTCHA utilizzando il seguente snippet di codice:

      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. Verifica l'applicazione:

    1. Per pulire l'ambiente Xcode, nel menu Product, fai clic su Clean Build Folder ( Pulisci cartella).
    2. Per eseguire l'applicazione, fai clic su Esegui nel menu Prodotto.
    3. Nell'applicazione caricata, fai clic sul pulsante reCAPTCHA che hai creato in precedenza.
    4. Osserva la finestra di output di debug per un token reCAPTCHA (stringa alfanumerica), che viene restituito se l'integrazione è riuscita.

Riferimento API iOS

Contatta il tuo rappresentante di vendita per avere accesso alla pagina di download dell'SDK per iOS. La pagina di download dell'SDK per iOS spiega i dettagli dell'etichetta della privacy reCAPTCHA.

Passaggi successivi