Résoudre les problèmes d'intégration d'Identity Platform à l'API reCAPTCHA Enterprise

Ce document fournit des conseils pour résoudre les problèmes potentiels qui peuvent survenir lors de l'utilisation de l'intégration d'Identity Platform à l'API reCAPTCHA Enterprise, y compris les fonctionnalités de protection contre les bots reCAPTCHA et de défense par SMS reCAPTCHA.

Résoudre les problèmes d'intégration

Vos utilisateurs peuvent rencontrer des problèmes en raison d'erreurs lors de l'intégration d'Identity Platform à l'API reCAPTCHA Enterprise. Voici quelques raisons courantes :

  • Vous avez peut-être manqué une étape lors de l'intégration d'Identity Platform à la configuration de l'API reCAPTCHA Enterprise. Par exemple, si vous oubliez de configurer le compte de service ou d'activer l'API reCAPTCHA Enterprise sur le projet. Assurez-vous d'avoir rempli toutes les conditions d'intégration. Pour obtenir des instructions de configuration, consultez Intégrer Identity Platform à l'API reCAPTCHA Enterprise.
  • Si vous utilisez votre propre clé avec reCAPTCHA, la clé reCAPTCHA correspondante que vous avez importée n'est peut-être pas valide ou a peut-être cessé de fonctionner. Vérifiez que la clé fonctionne et qu'elle est accessible par Identity Platform.
  • Il est possible que les utilisateurs utilisent une version obsolète de votre application. Assurez-vous de fournir une version mise à jour de votre application qui utilise le SDK client, et demandez à vos utilisateurs de mettre à jour leur application. Pour configurer le SDK client pour votre application, consultez Configurer le SDK client.

Les utilisateurs ne peuvent pas s'authentifier via les flux compatibles avec l'API reCAPTCHA Enterprise

Si vous rencontrez des problèmes avec les flux compatibles avec l'API reCAPTCHA Enterprise, tels que la protection contre les bots reCAPTCHA ou reCAPTCHA SMS defense, consultez les sections suivantes pour obtenir des conseils spécifiques à chaque fonctionnalité.

Dépannage de la protection contre les bots reCAPTCHA

Les rubriques suivantes décrivent les problèmes que vous pouvez rencontrer lors de l'utilisation de la protection contre les bots et comment les résoudre.

Les utilisateurs ne peuvent pas s'authentifier lorsqu'ils utilisent la protection contre les bots pour les fournisseurs d'adresse e-mail/mot de passe ou de numéro de téléphone

Si vous avez déterminé que l'intégration d'Identity Platform à l'API reCAPTCHA Enterprise a été correctement configurée, il est possible que les utilisateurs ne puissent pas effectuer d'actions d'authentification via les fournisseurs d'adresse e-mail/mot de passe ou de téléphone en fonction de votre configuration actuelle. Par exemple, les utilisateurs peuvent ne pas être en mesure d'effectuer les actions suivantes :

  • Connectez-vous, inscrivez-vous ou réinitialisez un mot de passe à l'aide d'une adresse e-mail.
  • Demandez un code par SMS pour vous connecter avec un numéro de téléphone.
  • S'inscrire ou se connecter avec l'authentification multifacteur par SMS.

Pour résoudre ces problèmes d'authentification, essayez les méthodes suivantes :

  • Si les requêtes des utilisateurs échouent avec ERROR_CAPTCHA_CHECK_FAILED, envisagez une configuration plus permissive en ajustant les seuils que vous avez définis pour managedRules. Toutes les requêtes dont le score est inférieur au seuil que vous avez défini seront considérées comme provenant d'un bot. Par exemple, si vous définissez un seuil de 0.6, reCAPTCHA refusera toute requête avec un score de 0.5 ou moins. Par conséquent, plus le score que vous définissez est élevé, plus les règles seront strictes.
  • Demandez à l'utilisateur d'essayer un autre appareil, navigateur ou réseau.
  • Pour les flux d'authentification par adresse e-mail et mot de passe, rétablissez le mode AUDIT pour emailPasswordEnforcementState et surveillez les métriques avant de réactiver le mode ENFORCE.
  • Pour les flux d'authentification par téléphone, ajustez vos seuils de score managedRules ou désactivez la protection contre les bots pour le fournisseur de téléphonie pendant le dépannage. Si reCAPTCHA SMS defense est également activé et que vous souhaitez le laisser actif, définissez useSmsBotScore sur false et laissez phoneEnforcementState défini sur ENFORCE. Pour désactiver toute protection reCAPTCHA par téléphone, définissez phoneEnforcementState sur OFF, useSmsBotScore sur false et useSmsTollFraudProtection sur false.

Dépannage de reCAPTCHA SMS defense

Les rubriques suivantes décrivent les problèmes que vous pouvez rencontrer lors de l'utilisation de reCAPTCHA SMS defense et comment les résoudre.

Les utilisateurs ne peuvent pas s'authentifier lorsqu'ils utilisent reCAPTCHA SMS defense pour le fournisseur de téléphonie

Si vous avez déterminé que l'intégration d'Identity Platform à l'API reCAPTCHA Enterprise a été correctement configurée, il est possible que les utilisateurs ne puissent pas effectuer d'actions d'authentification par SMS via le fournisseur de téléphonie en fonction de votre configuration actuelle. Par exemple, les utilisateurs peuvent ne pas être en mesure de demander un code par SMS pour se connecter avec un numéro de téléphone, ou de s'inscrire ou de se connecter avec l'authentification multifacteur. Cela peut se produire si le score reCAPTCHA SMS defense que vous avez défini est trop strict.

Pour résoudre ce problème, envisagez une configuration plus permissive en ajustant le seuil que vous avez défini pour tollFraudManagedRules. Tout score supérieur au seuil que vous avez défini sera considéré comme une fraude à la facturation par l'opérateur via SMS. Par exemple, si vous définissez un seuil de 0.3, reCAPTCHA rejettera toute requête avec un score de 0.4 ou plus. Par conséquent, plus le score est bas, plus les règles seront strictes.

Surveillez les métriques reCAPTCHA émises par votre projet pour vérifier que votre application reçoit un trafic utilisateur acceptable après avoir ajusté le seuil de score.

Étapes suivantes