Cloudflare Turnstile
Configurer Cloudflare Turnstile et transmettre son jeton au formulaire.
Préparer le fournisseur
Déclarez les domaines autorisés du widget Turnstile, y compris un environnement de test adapté à votre site.
Créez la clé de site et le secret dans votre compte fournisseur. La clé de site sert au widget public ; le secret est enregistré dans une connexion privée du formulaire, jamais dans votre page.
Relier le widget au formulaire
- Sélectionnez turnstile dans la protection CAPTCHA et reliez le secret de vérification.
- Ajoutez le widget officiel à votre page avec sa clé de site.
- Pour un POST HTML, transmettez le jeton dans cf-turnstile-response. En JSON, utilisez captcha.token.
- Publiez, puis testez un jeton valide, une expiration et une nouvelle tentative.
Si la vérification échoue
Contrôlez le fournisseur sélectionné, les domaines autorisés et la correspondance entre la clé publique et le secret privé. Un jeton expiré doit être renouvelé avant une nouvelle tentative. Affichez l’erreur au visiteur et conservez ses autres champs.
L’intégration doit être vérifiée avec votre compte fournisseur avant une utilisation en production ; la présence du widget ne prouve pas sa validation par le serveur.