DocumentationCommerceGuide des systèmes d’administration

Google reCAPTCHA

Last update: Thu May 29 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Débutant
  • Intermédiaire
  • Administration

Google reCAPTCHA garantit qu'un être humain, plutôt qu'un ordinateur (ou « robot »), interagit avec votre site web. Contrairement à Adobe Commerce et Magento Open Source standard CAPTCHA, Google reCAPTCHA offre une sécurité renforcée avec une sélection d’options d’affichage et de méthodes différentes. D’autres informations sur le trafic sur le site web sont disponibles dans le tableau de bord de votre compte Google reCAPTCHA.

Google reCAPTCHA est configuré séparément pour l’administration et le storefront.

  • Pour l’administrateur, le reCAPTCHA de Google peut être utilisé sur la page Sign In et lorsqu’un utilisateur demande une réinitialisation de mot de passe. Si le Commerce standard CAPTCHA est également activé, le reCAPTCHA de Google peut être utilisé en même temps sans aucun problème.

  • Pour le storefront, Google reCAPTCHA peut être utilisé pour se connecter à un compte client, envoyer un message à partir de la page Nous contacter et dans de nombreux autres emplacements de storefront.

    Google reCAPTCHA - connexion client {width="700" modal="regular"}

Google reCAPTCHA peut être implémenté de plusieurs manières :

  • reCAPTCHA v3 Invisible — Utilise un algorithme pour évaluer les interactions utilisateur et détermine la probabilité que l'utilisateur soit humain en fonction d'un score.

  • reCAPTCHA v2 Invisible — Effectue la vérification en arrière-plan sans interaction de l'utilisateur. Les utilisateurs et les clientes et utilisateurs sont automatiquement vérifiés, mais il peut être nécessaire de sélectionner des images spécifiques pour relever un défi.

  • reCAPTCHA v2 (« Je ne suis pas un robot ») — Valide les requêtes avec la case à cocher « Je ne suis pas un robot ».

IMPORTANT
Avant de pouvoir configurer Google reCAPTCHA, assurez-vous que votre fichier PHP.ini comprend le paramètre suivant : allow_url_fopen = 1. Cela peut nécessiter l’aide d’un développeur. Voir Paramètres PHP requis dans le Guide d'installation.

Étape 1 : générer des clés reCAPTCHA Google

Google reCAPTCHA requiert une paire de clés API pour l’activer. Vous pouvez obtenir ces clés gratuitement via le site reCAPTCHA. Avant de générer les clés, vous devez connaître le type de reCAPTCHA que vous souhaitez utiliser.

  1. Ouvrez la page Google reCAPTCHA et connectez-vous à votre compte .

  2. Par Label, saisissez un nom pour identifier les clés à des fins de référence interne.

    Vous avez besoin d’un ensemble de clés pour chaque type reCAPTCHA utilisé dans votre installation Adobe Commerce ou Magento Open Source. Par exemple : Commerce Invisible

  3. Par reCAPTCHA type, choisissez la méthode que vous souhaitez utiliser.

    • reCAPTCHA v3 invisible
    • reCAPTCHA v2 invisible
    • reCAPTCHA v2 (« Je ne suis pas un robot »)

  4. Par Domain, saisissez le domaine de votre boutique. Par exemple : mystore.com

    Si vous disposez de plusieurs magasins avec des domaines différents, saisissez chaque domaine sur une ligne distincte.

    • Ajoutez le domaine de votre boutique et tous les sous-domaines.
    • Vous pouvez ajouter des localhost, d’autres domaines d’ordinateur virtuel local et des domaines d’évaluation selon les besoins pour les tests.

  5. Cochez la case à Accept the reCAPTCHA Terms of Service.

  6. (Facultatif) Cochez la case Send alerts to owners pour envoyer une notification si Google détecte des problèmes ou un trafic suspect.

  7. Cliquez sur Submit pour terminer l’enregistrement et recevoir les clés.

    note important
    IMPORTANT
    Toutes les clés ne s’appliquent pas à tous les types de reCAPTCHA et leur mauvaise application peut entraîner un comportement inattendu. Par exemple, les clés reCAPTCHA de Google générées pour reCAPTCHA v2 « Je ne suis pas un robot » ne fonctionnent pas avec reCAPTCHA v2 invisible et peuvent bloquer la fonctionnalité où reCAPTCHA est activé.

Étape 2 : configurer Google reCAPTCHA pour l’administrateur

[PaaS uniquement]{class="badge informative" title="S’applique uniquement aux projets Adobe Commerce on Cloud (infrastructure PaaS gérée par Adobe) et aux projets On-premise."}

  1. Connectez-vous à votre compte administrateur.

  2. Dans la barre latérale d’administration, accédez à Stores > Settings>Configuration.

  3. Dans le coin supérieur droit, définissez Store View sur Default Config.

  4. Dans le panneau de gauche, développez Security et cliquez sur Google reCAPTCHA Admin Panel.

    note note
    NOTE
    Décochez la case Use system value pour chaque champ à configurer.

  5. Pour utiliser reCAPTCHA v2 (“I am not a robot”), développez la section reCAPTCHA v2 (“I am not a robot”) ​et procédez comme suit :

    • Par Google API Website Key, saisissez la clé de site web qui a été créée pour ce type reCAPTCHA lorsque vous avez enregistré votre compte Google reCAPTCHA.

    • Par Google API Secret Key, saisissez la clé secrète associée à votre compte Google reCAPTCHA.

    • Par Size, choisissez la taille de la zone reCAPTCHA de Google que vous souhaitez afficher. Options : Normal (default) / Compact

    • Par Theme, choisissez le thème que vous souhaitez utiliser pour appliquer un style à la zone reCAPTCHA de Google. Options : Light Theme (default) / Dark Theme

    • Par Language Code, saisissez le code à deux caractères pour spécifier la langue utilisée pour le texte et la messagerie reCAPTCHA de Google.

    reCAPTCHA v2 - « Je ne suis pas un robot » {width="600" modal="regular"}

  6. Pour utiliser reCAPTCHA v2 Invisible, développez la section reCAPTCHA v2 Invisible ​et procédez comme suit :

    • Par Google API Website Key, saisissez la clé de site web qui a été créée pour ce type reCAPTCHA lorsque vous avez enregistré votre compte Google reCAPTCHA.

    • Par Google API Secret Key, saisissez la clé secrète associée à votre compte Google reCAPTCHA.

    • Par Invisible Badge Position, choisissez la position du badge à utiliser sur chaque page. Options : Inline / Bottom Right / Bottom Left

    • Par Theme, choisissez le thème à utiliser pour appliquer un style à la zone reCAPTCHA de Google. Options : Light Theme (default) / Dark Theme

    • Par Language Code, saisissez un code à deux caractères qui spécifie la langue utilisée pour le texte et la messagerie reCAPTCHA de Google.

    reCAPTCHA v2 invisible {width="600" modal="regular"}

  7. Pour utiliser reCAPTCHA v3 Invisible, développez la section reCAPTCHA v3 Invisible ​et procédez comme suit :

    • Par Google API Website Key, saisissez la clé de site web qui a été créée pour ce type reCAPTCHA lorsque vous avez enregistré votre compte Google reCAPTCHA.

    • Par Google API Secret Key, saisissez la clé secrète associée à votre compte Google reCAPTCHA.

    • Entrez le Minimum Score Threshold permettant d’identifier lorsqu’une interaction utilisateur est signalée comme risque potentiel ; où 1,0 est une interaction utilisateur type et 0,0 est probablement un robot. Valeur par défaut : 0.5

    • Par Invisible Badge Position, choisissez la position à utiliser sur chaque page. Options : Inline / Bottom Right / Bottom Left

    • Par Theme, choisissez le thème à utiliser pour appliquer un style à la zone reCAPTCHA de Google. Options : Light Theme (default) / Dark Theme

    • Par Language Code, saisissez un code à deux caractères qui spécifie la langue utilisée pour le texte et la messagerie reCAPTCHA de Google.

    reCAPTCHA v3 invisible {width="600" modal="regular"}

  8. Développez reCAPTCHA Validation Failure Messages et saisissez les messages qui s’affichent dans Admin si la validation échoue ou ne peut pas être effectuée.

    Messages d’échec reCAPTCHA {width="600" modal="regular"}

  9. Développez la section Admin Panel et configurez les éléments suivants selon vos besoins :

    • Définissez Enable for Login sur le type reCAPTCHA que vous souhaitez utiliser pour la page de connexion de l’administrateur.

    • Définissez Enable for Forgot Password sur le type reCAPTCHA que vous souhaitez utiliser pour les demandes de réinitialisation de mot de passe.

    options d’administration reCAPTCHA {width="600" modal="regular"}

Étape 3 : Configurer Google reCAPTCHA pour le storefront

  1. Dans le panneau de gauche sous Security, choisissez Google reCAPTCHA Storefront.

  2. Renseignez la section pour chaque type reCAPTCHA que vous souhaitez utiliser dans le storefront.

    Voir les informations dans Étape 2 : Configuration de Google reCAPTCHA pour l’administrateur pour plus d’informations sur les options de chaque type reCAPTCHA.

  3. Développez reCAPTCHA Validation Failure Messages et saisissez les messages qui s’affichent dans le storefront si la validation échoue ou ne peut pas être effectuée.

  4. Développez la section Storefront .

    note note
    NOTE
    Décochez la case Use system value pour chaque champ à configurer.

  5. Définissez chaque champ d’emplacement de storefront sur le type de reCAPTCHA que vous avez configuré pour utiliser.

    • Enable for Customer Login
    • Enable for Forgot Password
    • Enable for Create New Customer Account
    • Enable for Edit Customer Account
    • Enable for Create New Company Account Adobe Commerce B2B (disponible avec Adobe Commerce B2B uniquement)
    • Enable for Contact Us
    • Enable for Product Review
    • Enable for Newsletter Subscription
    • Enable for Gift Card Adobe Commerce (Adobe Commerce uniquement)
    • Enable for Invitation Create Account
    • Enable for Send To Friend
    • Enable for Checkout/Placing Order
    • Enable for Wishlist Sharing
    • Enable for Coupon Codes
    • Enable for PayPal PayflowPro payment form

    Configuration des options du storefront {width="600" modal="regular"}

Étape 4 : enregistrer la configuration

  1. Une fois les paramètres de configuration définis, cliquez sur Save Config.

  2. Dans le message en haut de l’espace de travail, cliquez sur Cache Management et actualisez chaque cache non valide.

recommendation-more-help
d3c62084-5181-43fb-bba6-1feb2fcc3ec1