Questions fréquentes

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Dois-je utiliser reCAPTCHA Enterprise ?

reCAPTCHA Enterprise offre 1 million d'évaluations par mois pour tester des fonctionnalités supplémentaires et sans frais. 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 ici sans frais.

Puis-je utiliser reCAPTCHA avec des solutions tierces ?

Oui, vous pouvez utiliser reCAPTCHA (version d'entreprise) et reCAPTCHA Enterprise. En règle générale, la solution tierce vous 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 de reCAPTCHA v2 ou v3 vers reCAPTCHA Enterprise ?

Le processus de migration prend entre 5 et 10 minutes et ne nécessite aucune modification de 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 acceptons la sécurité et la facilité d'utilisation pour la version 2.

Pour en savoir plus sur les différences entre les versions 2 et 3 de reCAPTCHA, consultez Comparaison des versions.

Puis-je exécuter reCAPTCHA v2 et v3 sur la même page ?

Pour ce faire, chargez la clé de site v3 comme documentée, puis affichez explicitement la version 2 à l'aide de grecaptcha.render.

<html>
  <head>
    <title>reCAPTCHA demo: Running both v2 and v3</title>
    <script src="https://www.google.com/recaptcha/api.js?render=v3_site_key"></script>
    <script>
      grecaptcha.ready(() => {
        grecaptcha.render('html_element', {
           'sitekey' : 'v2_site_key'
        });
      });
    </script>
    <script>
      function onSubmit() {
        grecaptcha.ready(() => {
            grecaptcha.execute('v3_site_key', {action: 'homepage'}).then((token) => {
               ...
            });
        });
      }
    </script>
  </head>
</html>

reCAPTCHA utilise-t-il des cookies ?

reCAPTCHA définit un cookie nécessaire (_GRECAPTCHA) lorsqu'il est exécuté afin de fournir son analyse des risques. Si vous préférez ne pas utiliser le domaine www.google.com qui peut être associé à d'autres cookies, utilisez www.recaptcha.net.

Existe-t-il des RPS ou des limites quotidiennes d'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 une autorisation exceptionnelle. 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 une note statique de 0,9 et un message d'erreur `"Over free quota."` pour le reste du mois. Aucune indication visible par l'utilisateur n'est possible lorsque la version 3 des sites dépasse le quota. Si une clé de site v2 dépasse son quota mensuel, le message suivant ou un message similaire peut s'afficher pour les utilisateurs du widget reCAPTCHA pour le reste du mois : "Ce site dépasse le quota reCAPTCHA". Avant l'application du quota, les propriétaires de sites seront avertis par e-mail trois fois et disposeront d'au moins 90 jours pour migrer vers reCAPTCHA Enterprise. Les clés de site dépassent le quota si plus de 1 000 000 d'appels par mois sont utilisés pour un domaine. y compris si ce volume est réparti entre plusieurs clés du même domaine.

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

Vous êtes autorisé à masquer le badge, à condition d'inclure clairement la marque reCAPTCHA dans le parcours utilisateur. Veuillez inclure le texte suivant :

This site is protected by reCAPTCHA and the Google
    <a href="https://policies.google.com/privacy">Privacy Policy</a> and
    <a href="https://policies.google.com/terms">Terms of Service</a> apply.

Exemple :

Remarque:Si vous décidez 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. Les scores peuvent ne pas être précis, car reCAPTCHA v3 s'appuie sur la visibilité du trafic réel.

Pour reCAPTCHA v2, utilisez les clés de test suivantes. Vous ne recevrez toujours aucun 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 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" async defer></script> par <script src="https://www.recaptcha.net/recaptcha/api.js" async defer></script>.
  • Ensuite, appliquez la même procédure aux autres sites qui utilisent "www.google.com/recaptcha/" sur votre site.

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, définissez simplement l'attribut "data-theme" dans le paramètre grecaptcha.render.

Thème clair :

Thème sombre:

Comment puis-je personnaliser reCAPTCHA v3 ?

L'API JavaScript disponible pour Invisible reCAPTCHA fonctionne également pour la version 3. Il vous suffit d'utiliser l'API JavaScript pour afficher explicitement reCAPTCHA à l'aide d'une clé de site v3. Vous accédez ainsi à des options telles que le repositionnement du badge ou la modification du 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.

Mon widget reCAPTCHA a récemment affiché le message "Invalid site key". Que se passe-t-il ?

Si ce message d'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 sur cette page.

Une erreur de sécurité non capturée s'affiche: l'accès à un cadre d'origine "https://www.google.com" a été bloqué et ne peut pas accéder à un cadre d'origine "&ltvotre domaine&gt". 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 coché la case. 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 non basée sur le nonce, documentée avec CSP3. Veillez à inclure votre nonce dans le tag de script reCAPTCHA api.js, et nous nous occupons du reste.

Remarque: reCAPTCHA fonctionne également avec strict-dynamic' dans 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/

Le message d'erreur "L'hôte local ne figure pas dans la liste des domaines compatibles" s'affiche Que dois-je faire ?

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

Sur iOS 10 uniquement, la page défile vers le bas lorsque l'utilisateur termine le défi ?

Il s'agit d'un bug focalisé du côté d'Apple que nous leur avons signalé. Il concerne uniquement les utilisateurs d'iOS 10 et uniquement sur certains sites. Si vous êtes concerné, une solution de contournement consiste à déplacer le widget reCAPTCHA vers le haut ou vers le bas de la page, ou à utiliser reCAPTCHA v3.

Mon ordinateur ou mon réseau peut envoyer des requêtes automatiques ?

Si vous avez été redirigé vers cette page à partir du widget reCAPTCHA, le message suivant s'affiche : "Nous sommes désolés, mais votre ordinateur ou votre réseau envoient peut-être des requêtes automatiques. Afin de protéger nos utilisateurs, nous ne pouvons pas traiter votre demande pour le moment."

Malheureusement, cela peut se produire pour plusieurs raisons:

  • Vous utilisez peut-être un réseau partagé utilisé abusivement
  • Il est possible que votre fournisseur d'accès à Internet vous ait récemment attribué une adresse IP suspecte
  • Le site auquel vous tentez d'accéder est peut-être actuellement la cible d'attaques importantes

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

Quels sont les noms d'action 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 à un utilisateur.