Installer des clés de test basées sur des règles sur des sites Web

Cette page explique comment installer une clé de test basée sur une règle sur votre site Web. Avec une clé de test basée sur une règle, reCAPTCHA peut déclencher de manière déterministe des tests CAPTCHA en fonction d'un seuil de score et d'une difficulté de test.

Avant de commencer

  1. Préparez votre environnement pour reCAPTCHA.

  2. Vérifiez que la facturation est activée pour votre Google Cloud projet.

    reCAPTCHA exige que la facturation soit associée et activée sur le projet pour utiliser des clés de test basées sur des règles. Vous pouvez activer la facturation à l'aide d'une carte de crédit ou d'un ID de compte de facturation de projet Google Cloud existant. Si vous avez besoin d'aide pour la facturation, contactez l'assistance Cloud Billing.

  3. Créez une clé de test basée sur une règle.

    Vous pouvez également copier l'ID d'une clé de test basée sur une règle existante en effectuant l'une des étapes suivantes :

    • Pour copier l'ID d'une clé existante à partir de la Google Cloud console, procédez comme suit :

      1. Accédez à la page reCAPTCHA.

        Accéder à reCAPTCHA

      2. Dans la liste des clés reCAPTCHA, maintenez le pointeur sur la clé que vous souhaitez copier, puis cliquez sur .
    • Pour copier l'ID d'une clé existante à l'aide de l'API REST, utilisez la méthode projects.keys.list.
    • Pour copier l'ID d'une clé existante à l'aide de gcloud CLI, utilisez la commande gcloud recaptcha keys list.

Configurer la clé de test basée sur une règle

Pour votre clé de test basée sur une règle, vous devez spécifier la difficulté du test, qui détermine la complexité et la fréquence des tests CAPTCHA, et définir un seuil de score personnalisé pour des actions spécifiques qui remplace le seuil par défaut.

  1. Dans la Google Cloud console, accédez à la reCAPTCHA.

    Accéder à reCAPTCHA

    La page reCAPTCHA comporte deux vues : Tables et Fiches. Si votre projet comporte de nombreuses clés reCAPTCHA, seule la vue Tables est disponible.

  2. Vérifiez que le nom de votre projet s'affiche dans le sélecteur de projet en haut de la page.

    Si le nom de votre projet n'apparaît pas, cliquez sur le sélecteur de projet, puis sélectionnez votre projet.

  3. Dans la section Clés reCAPTCHA, identifiez la clé de test basée sur une règle que vous souhaitez configurer, puis cliquez sur la clé.

  4. Sur la page Détails de la clé, cliquez sur l'onglet Présentation.

  5. Dans la section Configuration, cliquez sur Configurer pour Paramètres du test.

  6. Sur la page Configurer les paramètres du test, sélectionnez la difficulté du test.

  7. Pour déclencher des tests CAPTCHA, utilisez le curseur pour spécifier la valeur de seuil par défaut.

    Le seuil par défaut de 0.0 ne déclenche aucun test. Un seuil de 1.0 déclenche un test pour chaque requête.

  8. Pour configurer un seuil de score personnalisé pour des actions individuelles, qui remplace la valeur de seuil par défaut, procédez comme suit :

    1. Saisissez un nom d'action.

    2. Pour spécifier un seuil de score personnalisé, utilisez le curseur Définir le seuil d'action.

    3. Cliquez sur OK.

  9. Cliquez sur Enregistrer.

Ajouter reCAPTCHA sur un bouton HTML

  1. Pour charger reCAPTCHA sur votre page Web, ajoutez l'API JavaScript à l'aide de votre clé de test basée sur une règle dans l'élément <head></head> de votre page Web.

        <head>
    <script src="https://www.google.com/recaptcha/enterprise.js?render=KEY_ID"></script>
    ....
    </head>

    Par défaut, reCAPTCHA utilise la langue du navigateur. Si vous souhaitez spécifier une autre langue, utilisez l'attribut hl=LANG dans votre script. Par exemple, pour utiliser le français, spécifiez ce qui suit : <script src="https://www.google.com/recaptcha/enterprise.js?hl=fr"></script>. Pour en savoir plus sur les langues acceptées, consultez la page Codes de langue pour reCAPTCHA.

  2. Pour ajouter reCAPTCHA sur un bouton HTML, procédez comme suit :

    1. Définissez une fonction de rappel pour gérer le jeton.

      <script>
   function onSubmit(token) {
     document.getElementById("demo-form").submit();
   } // Use `requestSubmit()` for extra features like browser input validation.
</script>

      Pour en savoir plus, consultez la méthode requestSubmit().

    2. Ajoutez des attributs à votre bouton HTML.

      <button class="g-recaptcha"
data-sitekey="KEY_ID"
data-callback="onSubmit"
data-action="submit">Submit</button>

      Si vous souhaitez spécifier un emplacement pour le badge, utilisez l'data-badge=LOCATION attribut sur l'élément qui comporte class=g-recaptcha. Par défaut, l'emplacement est défini sur bottomright. Les autres valeurs possibles sont inline et bottomleft.

    3. Lorsque ce bouton est utilisé pour envoyer un formulaire sur votre site, le paramètre POST g-recaptcha-response contient le jeton de réponse.

  3. Une fois le jeton généré, envoyez le jeton reCAPTCHA à votre backend et créez une évaluation dans les deux minutes.

Étape suivante