Réconcilier la terminologie de la console d'administration et de la console Google Cloud

Ce document explique comment identifier la version de votre clé reCAPTCHA (v2 ou v3), mapper l'ancienne terminologie de la console d'administration reCAPTCHA à la consoleGoogle Cloud , et récupérer les clés de site et les clés secrètes requises par les plates-formes de système de gestion de contenu (CMS) et les plug-ins tiers, tels que les intégrations WordPress ou Shopify.

Mapper l'ancienne terminologie à la console Google Cloud

Si vous gérez vos clés uniquement dans la console d'administration reCAPTCHA, vous utilisez reCAPTCHA Classic. Si vous gérez vos clés sur la page Google Cloud Fraud Defense de la console Google Cloud , vous utilisez Fraud Defense. Les deux consoles sont compatibles avec les clés de site Web v2 et v3.

De nombreux plug-ins et plates-formes CMS font référence aux clés reCAPTCHA à l'aide d'anciens numéros de version, tels que v2 Checkbox, v2 Invisible et v3. La consoleGoogle Cloud utilise des descripteurs basés sur la plate-forme au lieu de numéros de version.

Le tableau suivant met en correspondance l'ancienne terminologie du CMS et de la console d'administration avec la terminologie de la consoleGoogle Cloud  :

Terminologie du CMS ou de la console d'administration Google Cloud console (Platform details) Modifier la clé (champ Type) Mécanisme de validation et compatibilité avec le CMS
Sur la base d'un score (v3) Website • score Website • Score Validation fluide basée sur un score. À utiliser pour les plug-ins CMS qui nécessitent reCAPTCHA v3.
Défi (v2) Website • checkbox Website • Checkbox challenge L'utilisateur doit cocher la case "Je ne suis pas un robot". À utiliser pour les plug-ins CMS qui nécessitent la case à cocher reCAPTCHA v2.
Invisible (v2) Website • invisible Website • Invisible integration Analyse les risques en arrière-plan et peut afficher un test. À utiliser pour les plug-ins CMS qui nécessitent reCAPTCHA v2 invisible.
N/A Website • policy-based challenge Website • Policy-based challenge Déclenche des tests en fonction d'un seuil de score configuré. Nécessite une intégration CreateAssessment personnalisée.
N/A iOS iOS app Clé mobile iOS sans challenge.
N/A Android Android app Clé mobile Android sans défi.

Afficher la version de votre clé dans la console Google Cloud

Pour afficher la version de votre clé dans la console Google Cloud , procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Fraud Defense.

    Accéder à Fraud Defense

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

  3. Si vos clés sont affichées en vue Fiches, passez à la vue Tableau.

  4. Consultez la colonne Détails de la plate-forme pour votre clé. Par exemple, Website • score correspond à v3 et Website • checkbox correspond à v2 Checkbox.

  5. Facultatif. Dans la vue Fiches, cliquez sur Détails de la clé sur une fiche de clé, puis sélectionnez Modifier la clé. Le champ Type indique la configuration de la clé, par exemple Website • Score pour v3 ou Website • Checkbox challenge pour v2 Checkbox.

Trouver la clé de site et la clé secrète

Les plug-ins tiers et les plates-formes CMS nécessitent souvent une clé de site et une clé secrète pour l'intégration de reCAPTCHA :

  • Clé de site : dans la console Google Cloud , l'ID de clé correspond à la clé de site.
  • Clé secrète : la console Google Cloud n'affiche pas la clé secrète par défaut, car l'authentification Google Cloud utilise généralement des clés API ou des rôles Identity and Access Management. Toutefois, vous pouvez récupérer l'ancienne clé secrète pour les plug-ins qui en ont besoin. Certaines bibliothèques ou documentations tierces peuvent faire référence à l'ancienne clé secrète en tant que clé privée.

Récupérer la clé secrète dans la console Google Cloud

Pour récupérer la clé de site et la clé secrète, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Fraud Defense.

    Accéder à Fraud Defense

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

  3. Dans la section Clés reCAPTCHA, accédez à la clé dont vous avez besoin de la clé secrète :

    • Si vous êtes dans la vue Fiches, cliquez sur Détails de la clé sur la fiche de la clé. L'ID de clé s'affiche en haut de la page.
    • Si vous êtes dans la vue Tableau, l'ID de clé est visible dans le tableau. Cliquez sur la clé pour accéder à sa page d'informations.

  4. Copiez l'ID de clé affiché en haut de la page. Cette valeur correspond à votre clé de site.

  5. Accédez à l'onglet Intégration.

  6. Selon l'état de la clé, effectuez l'une des opérations suivantes :

    • Si la clé est configurée pour une utilisation ancienne, cliquez sur Utiliser l'ancienne clé.
    • Si la clé n'est pas intégrée à un ancien service, cliquez sur Intégrer à un service tiers ou un plug-in.

  7. Une boîte de dialogue s'affiche avec votre clé secrète. Copiez cette valeur de manière sécurisée. Traitez ce secret comme une donnée sensible.

    Vous pouvez également cliquer sur Modifier la clé sur la page Détails de la clé, puis sur Afficher à côté du champ Clé secrète.

Intégrer à WordPress, Shopify ou d'autres plates-formes de CMS

Si vous utilisez un outil de création de sites Web, une plate-forme d'e-commerce ou un plug-in CMS, la plate-forme ou le plug-in charge le script reCAPTCHA et valide automatiquement les jetons utilisateur. Vous n'avez pas besoin d'installer les bibliothèques clientes reCAPTCHA ni d'écrire de code backend personnalisé.

Pour configurer reCAPTCHA dans un CMS ou un plug-in tiers, procédez comme suit :

  1. Vérifiez la version de reCAPTCHA requise par votre CMS ou votre plug-in : ouvrez les paramètres d'intégration de reCAPTCHA dans votre CMS ou votre plug-in, puis vérifiez le type de clé qu'il accepte (généralement reCAPTCHA v3 ou Case à cocher reCAPTCHA v2).

  2. Sélectionnez ou créez une clé de correspondance :

    • Si vous disposez déjà d'une clé, consultez sa version pour vérifier qu'elle correspond à celle sélectionnée dans votre plug-in (Website • score pour v3 ou Website • checkbox pour v2 Checkbox).
    • Si vous avez besoin d'une nouvelle clé, créez une clé pour votre site Web qui correspond à la version requise, puis ajoutez le domaine de votre site Web (par exemple, example.com) à la liste des domaines de la clé.

  3. Copiez votre clé de site et votre ancienne clé secrète : suivez la procédure décrite dans Récupérer la clé secrète dans la consoleGoogle Cloud pour obtenir votre ID de clé (clé de site) et votre clé secrète.

  4. Saisissez les clés dans les paramètres de votre CMS ou de votre plug-in :

    • Collez l'ID de clé dans le champ Clé de site.
    • Collez la clé secrète dans le champ Clé secrète (ou Clé privée), puis enregistrez vos paramètres.

Intégrer des sites Web personnalisés à l'aide d'évaluations

La méthode CreateAssessment fournit une analyse détaillée des risques et des codes de motif, et permet d'accéder aux fonctionnalités avancées de Fraud Defense. Vous pouvez appeler la méthode CreateAssessment à l'aide des bibliothèques clientes reCAPTCHA ou de l'API REST.

Pour en savoir plus, consultez Créer une évaluation pour votre site Web.

Ancienne méthode SiteVerify

Bien que nous recommandions la méthode CreateAssessment pour les intégrations nouvelles et personnalisées, certains systèmes existants ou plug-ins tiers s'appuient toujours sur l'ancienne méthode SiteVerify. Cette méthode nécessite une clé secrète associée à votre clé reCAPTCHA.

Si vous devez l'intégrer à un système qui nécessite l'ancienne API SiteVerify, consultez Vérifier les jetons de réponse des utilisateurs avec l'ancienne API SiteVerify.

Étapes suivantes