Vai al contenuto

Bot Protection

Tiene i bot lontani dai tuoi moduli, accessi e siti ospitati.

Apri Bot Protection
Verificato rispetto alla dashboard il 18 novembre 2026

Bot Protection ha due lati nel codice. Sulla tua pagina, un piccolo script disegna il controllo e mette un token nel tuo modulo quando un visitatore lo supera. Sul tuo server, una richiesta conferma quel token con la chiave segreta della configurazione. Nessuno dei due richiede una chiave API dell'account: a delimitarli sono la chiave del sito (pubblica) e la chiave segreta (privata) di una configurazione.

Le configurazioni stesse, i loro piani e i loro numeri si gestiscono nella dashboard.

Sulla tua pagina

Copia il codice di incorporamento dalla configurazione; contiene già la chiave del sito della configurazione. Questa è la sua forma per ogni modo in cui il controllo si mostra.

<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>
  • Casella di spunta e Invisibile: metti il div dentro il modulo che vuoi proteggere. A un superamento lo script compila un campo nascosto chiamato xuda-captcha-response in quel modulo, così il token viene inviato insieme.
  • Invisibile non mostra nulla. Un modulo inviato senza un token recente viene trattenuto, il controllo gira e il modulo viene inviato di nuovo.
  • Pagina intera è solo lo script, nell'head della pagina. La pagina è coperta finché il visitatore non supera il controllo, e a quella scheda non viene chiesto di nuovo finché il suo superamento non scade.
  • Una configurazione il cui aspetto è Chiaro o Scuro aggiunge data-theme="light" o data-theme="dark".

Il controllo gira solo sui domini consentiti della configurazione.

Callback

Indica una funzione globale sul div (o sullo script, per Pagina intera) per sapere che cosa è successo:

window.xudaCaptcha.execute(element) restituisce una promise di un token recente, per un modulo che invii dal tuo codice.

Sul tuo server

Invia il token e la chiave segreta della configurazione a captcha_siteverify. Accetta il modulo solo quando la risposta dice success. Tieni la chiave segreta nella configurazione del tuo server, mai in una pagina.

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']

Un superamento risponde:

json
{
  "code": 1,
  "data": {
    "success": true,
    "score": 0.9,
    "level_reached": 0,
    "hostname": "example.com",
    "challenge_ts": 1762950000000,
    "error-codes": []
  }
}
Un token vale una volta sola, per due minuti

Un token viene accettato una sola volta e dura due minuti. Confermalo quando il modulo arriva, non dopo, e non confermare mai lo stesso token due volte.

Quando non viene superato

success è false e error-codes dice perché:

La risposta ha la stessa forma di quelle che danno reCAPTCHA e Turnstile, quindi il codice del server scritto per quelli di solito richiede solo di cambiare indirizzo e segreto.

Limiti del piano

Un controllo viene contato quando il primo passaggio di un visitatore arriva a una decisione. Il limite mensile del piano legge i controlli sui tuoi siti e moduli; ciò che è ospitato con Xuda non viene contato. Oltre un limite il passaggio AI viene saltato fino al mese successivo e ogni controllo continua a girare, quindi nessun modulo si rompe. Vedi Piani e fatturazione.

Come ti sembra questa guida?

Ultimo aggiornamento il 16 novembre 2026