Aller au contenu

Bot Protection

Tient les robots à l'écart de vos formulaires, connexions et sites hébergés.

Ouvrir Bot Protection
Vérifié par rapport au tableau de bord le 18 novembre 2026

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.

<script src="https://xuda.ai/dist/runtime/js/captcha-loader.js" async data-sitekey="YOUR_SITE_KEY"></script>
<div class="xuda-captcha" data-sitekey="YOUR_SITE_KEY"></div>
<script src="https://xuda.ai/dist/runtime/js/captcha-loader.js" async data-sitekey="YOUR_SITE_KEY"></script>
<div class="xuda-captcha" data-sitekey="YOUR_SITE_KEY" data-mode="invisible"></div>
<script src="https://xuda.ai/dist/runtime/js/captcha-loader.js" data-sitekey="YOUR_SITE_KEY" data-mode="fullpage"></script>
  • Case à cocher et Invisible : placez le div dans le formulaire que vous voulez protéger. En cas de réussite, le script remplit un champ caché nommé xuda-captcha-response dans 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" ou data-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.

curl -s https://xuda.ai/cpi/captcha_siteverify \
  -H 'content-type: application/json' \
  -d '{"secret":"YOUR_SECRET_KEY","response":"TOKEN_FROM_THE_FORM"}'
const res = await fetch('https://xuda.ai/cpi/captcha_siteverify', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ secret: 'YOUR_SECRET_KEY', response: token }),
});
const { data } = await res.json();
if (!data.success) throw new Error('The check did not pass');
import requests

res = requests.post(
    'https://xuda.ai/cpi/captcha_siteverify',
    json={'secret': 'YOUR_SECRET_KEY', 'response': token},
)
passed = res.json()['data']['success']

Une réussite répond :

json
{
  "code": 1,
  "data": {
    "success": true,
    "score": 0.9,
    "level_reached": 0,
    "hostname": "example.com",
    "challenge_ts": 1762950000000,
    "error-codes": []
  }
}
Un jeton est valable une fois, pendant deux minutes

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.

Que pensez-vous de ce guide ?

Dernière mise à jour le 16 novembre 2026