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 non valide

Si l'erreur Invalid site key s'affiche, cela signifie que votre clé de site reCAPTCHA n'est plus valide. Créez une clé et installez-la sur vos pages Web.

É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.

L'hôte local ne figure pas dans la liste des domaines acceptés

Les domaines localhost ne sont pas acceptés par défaut. Si vous souhaitez continuer à les prendre en charge pour le développement, vous pouvez les ajouter à la liste des domaines acceptés pour 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 la clé de votre 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 une opération execute. Dans la plupart des cas, cela est dû à un échec ou à un délai d'expiration du réseau côté client. Vous devez réessayer execute() à l'aide de JavaScript.