reCAPTCHA
Configurer reCAPTCHA et transmettre son jeton au formulaire.
Préparer le fournisseur
Choisissez la même version dans le formulaire et chez Google. Avec v3, un jeton valide doit aussi satisfaire le contrôle de score appliqué côté serveur.
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 recaptcha_v2 ou recaptcha_v3 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 g-recaptcha-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.