hCaptcha
Configurer hCaptcha et transmettre son jeton au formulaire.
Préparer le fournisseur
Ajoutez les domaines de votre site à la configuration hCaptcha et utilisez sa clé de site dans le widget.
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 hcaptcha 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 h-captcha-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.