Questions fréquentes

Dois-je utiliser reCAPTCHA Enterprise ?

reCAPTCHA Enterprise propose jusqu'à 10 000 évaluations par mois sans frais et fournit également des fonctionnalités supplémentaires. D'autres fonctionnalités, telles que l'analyse en temps réel, constituent le meilleur point de départ pour la plupart des développeurs. Lancez-vous.

Puis-je utiliser reCAPTCHA avec des solutions tierces ?

Oui, vous pouvez utiliser à la fois reCAPTCHA (version non Enterprise) et reCAPTCHA Enterprise. En général, la solution tierce demande votre clé publique et votre clé secrète ou votre clé API. Veillez à ne fournir votre clé secrète et votre clé API qu'à des tiers de confiance.

Comment migrer vers reCAPTCHA Enterprise depuis la v2 ou la v3 ?

Le processus de migration prend 5 à 10 minutes et ne nécessite aucune modification du code.

Dois-je utiliser reCAPTCHA v2 ou v3 ?

reCAPTCHA v3 s'adresse aux propriétaires de sites qui souhaitent obtenir plus de données sur leur trafic. Pour en savoir plus, consultez le guide du développeur reCAPTCHA v3.

Nous assurons la sécurité et la facilité d'utilisation de la version 2.

Pour en savoir plus sur les différences entre reCAPTCHA v2 et v3, consultez la comparaison des versions.

reCAPTCHA utilise-t-il des cookies ?

reCAPTCHA définit un cookie nécessaire (_GRECAPTCHA) lorsqu'il est exécuté pour fournir son analyse des risques. Si vous préférez ne pas utiliser le domaine www.google.com, qui peut avoir d'autres cookies définis, vous pouvez utiliser www.recaptcha.net à la place.

Existe-t-il des limites de RPS ou des limites quotidiennes pour mon utilisation de reCAPTCHA ?

Si vous souhaitez effectuer plus de 1 000 appels par seconde ou 1 000 000 d'appels par mois, vous devez utiliser reCAPTCHA Enterprise ou remplir ce formulaire et attendre l'approbation d'une exception. Si une clé de site dépasse 1 000 RPS, certaines requêtes risquent de ne pas être traitées. Si une clé de site v3 dépasse son quota mensuel, "site_verify" peut échouer en renvoyant un score statique de 0,9 et un message d'erreur "Over free quota" (Quota sans frais dépassé) pour le reste du mois. Aucune indication n'est visible par l'utilisateur lorsque les sites v3 dépassent le quota. Si une clé de site v2 dépasse son quota mensuel, le message suivant ou un message similaire peut s'afficher dans le widget reCAPTCHA pour le reste du mois : "Ce site dépasse le quota reCAPTCHA". Avant l'application du quota, les propriétaires du site recevront trois notifications par e-mail et disposeront d'au moins 90 jours pour migrer vers reCAPTCHA Enterprise. Les clés de site sont considérées comme dépassant le quota si plus de 1 000 000 d'appels par mois sont utilisés pour un domaine. Cela inclut les cas où ce volume est réparti sur plusieurs clés du même domaine.

Je souhaite masquer le badge reCAPTCHA. Qu'est-ce qui est autorisé ?

Vous pouvez masquer le badge à condition d'inclure de manière visible la marque reCAPTCHA dans le parcours utilisateur. Veuillez inclure le texte suivant :

This site is protected by reCAPTCHA.

Exemple :

Remarque : Si vous choisissez de masquer le badge, veuillez utiliser 

.grecaptcha-badge { visibility: hidden; }

Je souhaite exécuter des tests automatisés avec reCAPTCHA. Que dois-je faire ?

Pour reCAPTCHA v3, créez une clé distincte pour les environnements de test. Il est possible que les scores ne soient pas précis, car reCAPTCHA v3 s'appuie sur l'observation du trafic réel.

Pour reCAPTCHA v2, utilisez les clés de test suivantes. Vous n'obtiendrez jamais de CAPTCHA et toutes les demandes de validation seront acceptées.

  • Clé du site : 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI
  • Clé secrète : 6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe

Le widget reCAPTCHA affiche un message d'avertissement pour s'assurer qu'il n'est pas utilisé pour le trafic de production.

Comment puis-je éviter d'entrer dans le code reCAPTCHA lors du débogage de mon site ?

Pour éviter d'entrer dans le code reCAPTCHA lors du débogage d'un autre code JavaScript sur votre site, ajoutez le script reCAPTCHA /recaptcha__.+\.js$ à la liste des éléments à ignorer de votre navigateur. Pour obtenir des instructions concernant Chrome, consultez Ignorer une liste personnalisée de scripts. Des fonctionnalités similaires sont disponibles dans d'autres navigateurs.

Comment puis-je obtenir plus d'informations sur le trafic de mon site Web ?

reCAPTCHA fournit des statistiques quotidiennes dans la console d'administration.

Puis-je utiliser reCAPTCHA dans le monde entier ?

Oui, veuillez utiliser "www.recaptcha.net" dans votre code lorsque "www.google.com" n'est pas accessible.

  • Tout d'abord, remplacez <script src="https://www.google.com/recaptcha/api.js"></script> par <script src="https://www.recaptcha.net/recaptcha/api.js"></script>.
  • Ensuite, appliquez la même modification à tous les autres emplacements de votre site qui utilisent "www.google.com/recaptcha/".

Puis-je personnaliser le widget ou le badge reCAPTCHA ?

Oui. reCAPTCHA propose deux thèmes, clair et sombre, comme illustré ci-dessous. Pour choisir un thème, il vous suffit de définir l'attribut data-theme dans le paramètre grecaptcha.render.

Thème clair :

Thème sombre :

Comment personnaliser reCAPTCHA v3 ?

L'API JavaScript disponible pour reCAPTCHA invisible fonctionne également pour la v3. Il vous suffit d'utiliser l'API JavaScript pour afficher explicitement reCAPTCHA avec une clé de site v3 afin d'accéder à des options telles que le repositionnement du badge ou le changement de thème.

Lorsque vous affichez reCAPTCHA v3 avec cette méthode, n'oubliez pas de définir le paramètre size sur 'invisible' et d'utiliser l'ID client renvoyé par grecaptcha.render lorsque vous appelez grecaptcha.execute au lieu de la clé de site.

Récemment, mon widget reCAPTCHA a commencé à afficher "Clé de site non valide". Que se passe-t-il ?

Si cette erreur s'affiche, cela signifie que votre clé de site reCAPTCHA n'est plus valide. Pour l'activer, veuillez enregistrer une nouvelle clé et suivre les instructions de cette page.

Je reçois une erreur SecurityError non interceptée : "blocked a frame with origin 'https://www.google.com' from accessing a frame with origin '<votre domaine>'". Que dois-je faire ?

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.reset() pour réinitialiser le widget reCAPTCHA.

J'utilise Content-Security-Policy (CSP) sur mon site Web. Comment puis-je le configurer pour qu'il fonctionne avec reCAPTCHA ?

Nous vous recommandons d'utiliser l'approche basée sur un nonce documentée avec CSP3. Veillez à inclure votre nonce dans la balise de script api.js de reCAPTCHA. Nous nous occuperons du reste.

Remarque : reCAPTCHA fonctionne également avec 'strict-dynamic' sur les navigateurs compatibles.

Vous pouvez également ajouter les valeurs suivantes aux directives :

  • script-src https://www.google.com/recaptcha/, https://www.gstatic.com/recaptcha/
  • frame-src https://www.google.com/recaptcha/, https://recaptcha.google.com/recaptcha/
  • connect-src https://www.google.com/recaptcha/

Le message d'erreur "Localhost is not in the list of supported domains" (Localhost ne figure pas dans la liste des domaines compatibles) s'affiche. Que dois-je faire ?

Les domaines localhost ne sont pas acceptés par défaut. Si vous souhaitez continuer à les accepter pour le développement, vous pouvez les ajouter à la liste des domaines acceptés pour votre clé de site. Accédez à la console reCAPTCHA Enterprise ou à la console reCAPTCHA, selon le cas, 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.

Uniquement sur iOS 10, la page défile-t-elle vers le bas lorsque l'utilisateur termine le test ?

Il s'agit d'un bug de mise au point du côté d'Apple, que nous leur avons signalé. Il n'affecte que les utilisateurs d'iOS 10 et seulement sur certains sites. Si vous êtes concerné, vous pouvez contourner le problème en déplaçant le widget reCAPTCHA plus haut ou plus bas sur la page, ou en utilisant reCAPTCHA v3.

Mon ordinateur ou mon réseau envoie-t-il des requêtes automatiques ?

Si vous avez été redirigé vers cette page depuis le widget reCAPTCHA, vous avez dû voir un message indiquant "Nous sommes désolés, mais il est possible que votre ordinateur ou votre réseau envoie des requêtes automatiques. Pour protéger nos utilisateurs, nous ne pouvons pas traiter votre demande pour le moment."

Cela peut malheureusement arriver à des utilisateurs de bonne foi pour plusieurs raisons :

  • Vous utilisez peut-être un réseau partagé qui est utilisé de manière abusive.
  • Votre fournisseur d'accès à Internet vous a peut-être récemment attribué une adresse IP suspecte.
  • Le site auquel vous essayez d'accéder subit peut-être une attaque de grande ampleur

Pour résoudre ces problèmes, veuillez consulter la page d'aide sur le trafic inhabituel ou réessayer plus tard.

Quels noms d'action sont valides ?

Les actions ne peuvent contenir que des caractères alphanumériques, des barres obliques et des traits de soulignement. Les actions ne doivent pas être spécifiques à l'utilisateur.