Où trouver ma sitekey et ma secret key ?

Le module Invisible CAPTCHA utilise une sitekey (clé du site) et une secret key (clé secrète) fournies par Cloudflare Turnstile. Ces deux clés permettent d'activer le contrôle sur les formulaires de votre boutique et de votre back-office.

Créer un widget Turnstile et récupérer les clés

1. Si nécessaire, créez un compte Cloudflare.
2. Ouvrez la section Turnstile du tableau de bord Cloudflare et sélectionnez votre compte si cela vous est demandé.
3. Cliquez sur Add widget (Ajouter un widget).
4. Donnez un nom au widget, indiquez les noms d'hôte autorisés et choisissez son mode de fonctionnement, comme expliqué ci-dessous.
5. Cliquez sur Create, puis copiez la sitekey et la secret key du widget créé.

Quels domaines autoriser ?

Indiquez les noms d'hôte sur lesquels les formulaires protégés sont affichés, par exemple example.com ou shop.example.com, sans https://, port ni chemin. Ajouter example.com autorise aussi ses sous-domaines ; ajouter uniquement shop.example.com n'autorise pas le domaine parent ni un autre sous-domaine comme admin.example.com.

Vérifiez donc que les adresses utilisées par la boutique et le back-office sont couvertes, ainsi que les autres domaines des boutiques utilisant ce widget, le cas échéant. Il n'est pas nécessaire de faire passer votre site par le proxy Cloudflare ni de changer vos DNS pour utiliser Turnstile.

Quel mode choisir ?

• Managed : mode recommandé par Cloudflare. Le service adapte le contrôle et peut demander de cocher une case.
• Non-Interactive : un widget indique la vérification, sans action demandée au visiteur.
• Invisible : la vérification s'effectue en arrière-plan, sans widget visible ni case à cocher.

Le mode choisi dans Cloudflare détermine si un widget est visible. Si vous utilisez le mode Invisible, Cloudflare demande de référencer son addendum de confidentialité Turnstile dans votre propre politique de confidentialité.

Renseigner les clés dans le module

1. Dans votre back-office PrestaShop, ouvrez la configuration du module Invisible CAPTCHA.
2. Dans l'onglet Configuration, section Configuration de Cloudflare, collez la sitekey et la secret key du même widget dans les champs correspondants.
3. Cliquez sur Enregistrer dans cette section.

La capture utilise des clés de test publiques, uniquement pour illustrer les champs. Renseignez les clés de votre propre widget pour protéger votre boutique.

La sitekey est une clé publique utilisée par le widget. La secret key sert aux vérifications côté serveur : conservez-la confidentielle et ne la publiez pas dans une page ou une capture d'écran.

Pour retrouver les clés d'un widget existant ou modifier ses domaines et son mode, sélectionnez ce widget dans la section Turnstile de Cloudflare, puis ouvrez ses Settings (paramètres). En cas de remplacement des clés, reportez la nouvelle paire dans le module et enregistrez.

Vous pouvez ensuite choisir les formulaires à protéger et vérifier la configuration. Pour les exemptions par adresse IP, consultez Comment lister les IP sur liste blanche ?.