Bot Protection
Tient les robots à l'écart de vos formulaires, connexions et sites hébergés.
Bot Protection a deux côtés en code. Sur votre page, un petit script affiche la vérification et place un jeton dans votre formulaire quand un visiteur réussit. Sur votre serveur, une requête confirme ce jeton avec la clé secrète de la configuration. Ni l'un ni l'autre ne demande de clé d'API de compte : ce sont la clé de site (publique) et la clé secrète (privée) d'une configuration qui les délimitent.
Les configurations elles-mêmes, leurs forfaits et leurs chiffres se gèrent dans le tableau de bord.
Sur votre page
Copiez le code d'intégration depuis la configuration ; il contient déjà la clé de site de la configuration. Voici sa forme pour chaque façon dont la vérification s'affiche.
- Case à cocher et Invisible : placez le
divdans le formulaire que vous voulez protéger. En cas de réussite, le script remplit un champ caché nomméxuda-captcha-responsedans ce formulaire, pour que le jeton soit envoyé avec lui. - Invisible n'affiche rien. Un formulaire envoyé sans jeton récent est retenu, la vérification s'exécute, et le formulaire est renvoyé.
- Page entière est le script seul, dans l'en-tête de la page. La page est voilée jusqu'à ce que le visiteur réussisse, et cet onglet n'est plus sollicité tant que sa réussite n'a pas expiré.
- Une configuration dont l'apparence est Clair ou Sombre ajoute
data-theme="light"oudata-theme="dark".
La vérification ne s'exécute que sur les domaines autorisés de la configuration.
Rappels (callbacks)
Nommez une fonction globale sur le div (ou sur le script, pour Page entière) pour être informé de ce qui s'est passé :
window.xudaCaptcha.execute(element) renvoie une promesse d'un jeton récent, pour un formulaire que vous envoyez depuis votre propre code.
Sur votre serveur
Envoyez le jeton et la clé secrète de la configuration à captcha_siteverify. N'acceptez le formulaire que lorsque la réponse indique success. Gardez la clé secrète dans la configuration propre de votre serveur, jamais dans une page.
Une réussite répond :
Un jeton n'est accepté qu'une seule fois et vit deux minutes. Confirmez-le à l'arrivée du formulaire, pas plus tard, et ne confirmez jamais deux fois le même jeton.
Quand la vérification échoue
success vaut false et error-codes dit pourquoi :
La réponse a la même forme que celles de reCAPTCHA et de Turnstile : le code serveur écrit pour ceux-ci n'a donc généralement besoin que de changer d'adresse et de secret.
Limites du forfait
Une vérification est comptée quand la première étape d'un visiteur aboutit à une décision. La limite mensuelle du forfait compte les vérifications sur vos propres sites et formulaires ; tout ce qui est hébergé avec Xuda n'est pas compté. Au-delà d'une limite, l'étape IA est ignorée jusqu'au mois suivant et chaque vérification continue de fonctionner, si bien qu'aucun formulaire ne casse. Voir Forfaits et facturation.