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

Ce document liste les problèmes d'intégration reCAPTCHA courants que les développeurs peuvent rencontrer lorsqu'ils utilisent reCAPTCHA dans leur environnement.

Clé de site ou type de clé non valide

Si l'erreur Invalid site key ou Invalid key type s'affiche, vérifiez les points suivants :

Échec de la migration des clés

La migration des clés de site peut échouer dans l'un des cas suivants :

SecurityError: blocked a frame with origin "https://www.google.com" from accessing a frame with origin "&ltyour domain&gt"

Cela se produit généralement si l'élément HTML du widget reCAPTCHA est supprimé de manière programmatique après que l'utilisateur final a cliqué sur la case à cocher. Nous vous recommandons d'utiliser la fonction JavaScript grecaptcha.enterprise.reset() pour réinitialiser le widget reCAPTCHA.

Localhost ne figure pas dans la liste des domaines compatibles

Les domaines localhost ne sont pas acceptés par défaut. Si vous souhaitez continuer à les utiliser pour le développement, vous pouvez les ajouter à la liste des domaines compatibles avec votre clé de site. Accédez à la consoleGoogle Cloud pour mettre à jour votre liste de domaines compatibles. Nous vous conseillons d'utiliser des clés distinctes pour le développement et la production, et de n'autoriser que localhost sur votre clé de site de développement.

reCAPTCHA a renvoyé BROWSER_ERROR lors de la création d'une évaluation

Les jetons BROWSER_ERROR se produisent lorsque le script reCAPTCHA ne peut pas effectuer d'opération execute. Dans la plupart des cas, cela est dû à une défaillance ou à un délai d'expiration du réseau côté client. Vous devez réessayer execute() à l'aide de JavaScript.