Risoluzione dei problemi di integrazione di Identity Platform con l'API reCAPTCHA Enterprise

Questo documento fornisce indicazioni per la risoluzione dei problemi che potrebbero verificarsi durante l'utilizzo dell'integrazione di Identity Platform con l'API reCAPTCHA Enterprise, incluse le funzionalità di protezione dai bot di reCAPTCHA e di SMS defense di reCAPTCHA.

Risoluzione dei problemi di onboarding dell'integrazione

I tuoi utenti potrebbero riscontrare problemi dovuti a errori durante l'onboarding con l'integrazione di Identity Platform con l'API reCAPTCHA Enterprise. Alcuni motivi comuni potrebbero essere i seguenti:

  • Potresti aver saltato un passaggio nella configurazione dell'integrazione di Identity Platform con l'API reCAPTCHA Enterprise. Ad esempio, la mancata configurazione del account di servizio o l'abilitazione dell'API reCAPTCHA Enterprise nel progetto. Assicurati di aver completato tutti i requisiti di integrazione. Per le istruzioni di configurazione, consulta Integra Identity Platform con l'API reCAPTCHA Enterprise.
  • Se utilizzi la tua chiave con reCAPTCHA, la chiave reCAPTCHA corrispondente che hai caricato potrebbe non essere valida o potrebbe aver smesso di funzionare. Verifica che la chiave funzioni e sia accessibile da Identity Platform.
  • Gli utenti potrebbero utilizzare una versione obsoleta della tua app. Assicurati di fornire una versione aggiornata della tua app che utilizzi l'SDK client e chiedi agli utenti di aggiornare l'app. Per configurare l'SDK client per la tua app, consulta Configura l'SDK client.

Gli utenti non possono eseguire l'autenticazione tramite i flussi supportati dall'API reCAPTCHA Enterprise

Se riscontri problemi con i flussi supportati dall'API reCAPTCHA Enterprise, come la protezione dai bot di reCAPTCHA o reCAPTCHA SMS defense, consulta le sezioni seguenti per indicazioni specifiche per le funzionalità.

Risoluzione dei problemi di protezione dai bot reCAPTCHA

I seguenti argomenti descrivono i possibili problemi che potresti riscontrare durante l'utilizzo della protezione dai bot e come risolverli.

Gli utenti non possono autenticarsi quando utilizzano la protezione dai bot per i provider di email-password o di numeri di telefono

Se hai stabilito che l'integrazione di Identity Platform con l'API reCAPTCHA Enterprise è stata configurata correttamente, agli utenti potrebbe essere impedito di eseguire azioni di autenticazione tramite i provider di email-password o di numeri di telefono in base alla tua configurazione attuale. Ad esempio, gli utenti potrebbero non essere in grado di eseguire le seguenti azioni:

  • Accedi, registrati o reimposta una password tramite un indirizzo email.
  • Richiedi un codice via SMS per accedere tramite un numero di telefono.
  • Registrati o accedi con l'autenticazione a più fattori basata su SMS.

Per risolvere questi problemi di autenticazione, prova quanto segue:

  • Se le richieste degli utenti non vanno a buon fine con ERROR_CAPTCHA_CHECK_FAILED, valuta una configurazione più permissiva modificando le soglie impostate per managedRules. Tutte le richieste con un punteggio inferiore alla soglia impostata verranno considerate bot. Ad esempio, se imposti una soglia di 0.6, reCAPTCHA non accetterà richieste con un punteggio pari o inferiore a 0.5. Pertanto, più alto è il punteggio impostato, più rigide saranno le regole.
  • Chiedi all'utente di provare un altro dispositivo, browser o rete.
  • Per i flussi di autenticazione email-password, ripristina emailPasswordEnforcementState in modalità AUDIT e monitora le metriche prima di riattivare la modalità ENFORCE.
  • Per i flussi di autenticazione tramite telefono, regola le soglie dei punteggi managedRules o disattiva la protezione dai bot per il provider di servizi telefonici durante la risoluzione dei problemi. Se è abilitato anche reCAPTCHA SMS defense e vuoi mantenerlo attivo, imposta useSmsBotScore su false e lascia phoneEnforcementState impostato su ENFORCE. Per disattivare tutta la protezione reCAPTCHA per i numeri di telefono, imposta phoneEnforcementState su OFF, useSmsBotScore su false e useSmsTollFraudProtection su false.

Risoluzione dei problemi di reCAPTCHA SMS defense

I seguenti argomenti descrivono i possibili problemi che potresti riscontrare durante l'utilizzo di reCAPTCHA SMS defense e come risolverli.

Gli utenti non possono eseguire l'autenticazione quando utilizzano reCAPTCHA SMS defense per il provider telefonico

Se hai stabilito che l'integrazione di Identity Platform con l'API reCAPTCHA Enterprise è stata configurata correttamente, gli utenti potrebbero non essere in grado di eseguire azioni di autenticazione basate su SMS tramite il provider di telefonia in base alla configurazione attuale. Ad esempio, gli utenti potrebbero non essere in grado di richiedere un codice SMS per accedere con un numero di telefono o registrarsi o accedere con l'autenticazione a più fattori. Questo può accadere se il punteggio di reCAPTCHA SMS defense che hai impostato è troppo rigido.

Per risolvere il problema, valuta una configurazione più permissiva modificando la soglia impostata per tollFraudManagedRules. Qualsiasi punteggio superiore alla soglia impostata verrà considerato una frode tariffaria SMS. Ad esempio, se imposti una soglia di 0.3, reCAPTCHA non riuscirà a eseguire alcuna richiesta con un valore pari o superiore a 0.4. Pertanto, più basso è il punteggio impostato, più rigide saranno le regole.

Monitora le metriche reCAPTCHA generate dal tuo progetto per verificare che la tua app riceva un traffico di utenti accettabile dopo aver modificato la soglia del punteggio.

Passaggi successivi