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

Vous pouvez installer une clé de test basée sur des règles sur votre site Web pour déclencher des tests CAPTCHA visuels uniquement lorsque les requêtes entrantes correspondent aux règles de sécurité configurées. L'intégration de clés basées sur des règles permet de maintenir une expérience de navigation fluide pour les visiteurs légitimes, tout en présentant une vérification ciblée au trafic suspect.

Avant de commencer

  1. Préparer votre environnement pour Google Cloud Fraud Defense

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

    reCAPTCHA nécessite 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 Google Cloud existant. Si vous avez besoin d'aide concernant la facturation, contactez l'assistance Cloud Billing.

  3. Créer une clé de vérification basée sur des règles

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

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

      1. Accédez à la page Google Cloud Fraud Defense.

        Accéder à Google Cloud Fraud Defense

      2. Sélectionnez l'onglet Keys (clés).
      3. Dans la liste des clés reCAPTCHA, recherchez 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 la gcloud CLI, utilisez la commande gcloud recaptcha keys list.

Configurer la clé de test basée sur des règles

Pour votre clé de test basée sur des règles, 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 console Google Cloud , accédez à la page reCAPTCHA.

    Accéder à reCAPTCHA

  2. Vérifiez que le nom de votre projet apparaît dans le sélecteur de ressources en haut de la page.

    Si le nom de votre projet ne s'affiche pas, cliquez sur le sélecteur de ressources, puis sélectionnez votre projet.

  3. Sélectionnez l'onglet Keys (clés).

    L'onglet Clés comporte deux vues : Tableau et Fiches. Si votre projet comporte de nombreuses clés reCAPTCHA, seule la vue Table est disponible.

  4. Dans la section Clés reCAPTCHA, identifiez la clé de test basée sur des règles que vous souhaitez configurer, puis cliquez dessus.

  5. Sur la page Détails de la clé, cliquez sur l'onglet Aperçu.

  6. Dans la section Configuration, cliquez sur Configurer pour Paramètres de la question d'authentification.

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

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

  9. 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 de test.

    3. Cliquez sur OK.

  10. Cliquez sur Enregistrer.

Ajouter reCAPTCHA à un bouton HTML

  1. Pour charger reCAPTCHA sur votre page Web, ajoutez l'API JavaScript avec votre clé de test basée sur des règles 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>
      

    reCAPTCHA utilise par défaut 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 <script src="https://www.google.com/recaptcha/enterprise.js?hl=fr"></script>. Pour en savoir plus sur les langues acceptées, consultez Codes de langue pour reCAPTCHA.

  2. Pour ajouter reCAPTCHA à 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 section 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'attribut data-badge=LOCATION 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 jeton de réponse est inclus dans le paramètre POST g-recaptcha-response.

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

Étapes suivantes