Zum Inhalt springen

Bot Protection

Hält Bots von deinen Formularen, Anmeldungen und gehosteten Websites fern.

Bot Protection öffnen
Am 18. November 2026 mit dem Dashboard abgeglichen

Bot Protection hat im Code zwei Seiten. Auf deiner Seite zeichnet ein kleines Skript die Prüfung und setzt ein Token in dein Formular, wenn ein Besucher besteht. Auf deinem Server bestätigt eine Anfrage dieses Token mit dem geheimen Schlüssel der Einrichtung. Keines von beidem braucht einen API-Schlüssel des Kontos: Der eigene Site Key (öffentlich) und der geheime Schlüssel (privat) einer Einrichtung legen ihren Geltungsbereich fest.

Die Einrichtungen selbst, ihre Tarife und ihre Zahlen werden im Dashboard verwaltet.

Auf deiner Seite

Kopiere den Einbettungscode aus der Einrichtung; er enthält bereits den Site Key der Einrichtung. So sieht er für jede Art aus, wie die Prüfung erscheint.

<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>
  • Kontrollkästchen und Unsichtbar: Setze das div in das Formular, das du schützen willst. Bei einem Durchlauf füllt das Skript in diesem Formular ein verstecktes Feld namens xuda-captcha-response, sodass das Token mit abgeschickt wird.
  • Unsichtbar zeigt nichts. Ein Formular, das ohne frisches Token abgeschickt wird, wird angehalten, die Prüfung läuft, und das Formular wird erneut abgeschickt.
  • Ganze Seite ist das Skript allein, im Head der Seite. Die Seite wird abgedeckt, bis der Besucher besteht, und dieser Tab wird nicht erneut gefragt, bis sein Durchlauf abläuft.
  • Eine Einrichtung, deren Aussehen Hell oder Dunkel ist, fügt data-theme="light" oder data-theme="dark" hinzu.

Die Prüfung läuft nur auf den erlaubten Domains der Einrichtung.

Callbacks

Nenne eine globale Funktion am div (oder am Skript, bei Ganze Seite), um zu erfahren, was passiert ist:

window.xudaCaptcha.execute(element) gibt ein Promise auf ein frisches Token zurück, für ein Formular, das du aus deinem eigenen Code abschickst.

Auf deinem Server

Sende das Token und den geheimen Schlüssel der Einrichtung an captcha_siteverify. Nimm das Formular nur an, wenn die Antwort success sagt. Bewahre den geheimen Schlüssel in der eigenen Konfiguration deines Servers auf, nie in einer Seite.

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

Ein Durchlauf antwortet:

json
{
  "code": 1,
  "data": {
    "success": true,
    "score": 0.9,
    "level_reached": 0,
    "hostname": "example.com",
    "challenge_ts": 1762950000000,
    "error-codes": []
  }
}
Ein Token gilt einmal, für zwei Minuten

Ein Token wird ein einziges Mal akzeptiert und lebt zwei Minuten. Bestätige es, wenn das Formular eintrifft, nicht später, und bestätige dasselbe Token nie zweimal.

Wenn es nicht besteht

success ist false, und error-codes sagt, warum:

Die Antwort hat dieselbe Form wie die, die reCAPTCHA und Turnstile geben, sodass für diese geschriebener Servercode meist nur an Adresse und Geheimnis angepasst werden muss.

Tariflimits

Eine Prüfung wird gezählt, wenn der erste Schritt eines Besuchers zu einer Entscheidung kommt. Das Monatslimit des Tarifs liest die Prüfungen auf deinen eigenen Websites und Formularen; alles, was mit Xuda gehostet wird, wird nicht gezählt. Über einem Limit wird der KI-Schritt bis zum nächsten Monat übersprungen, und jede Prüfung läuft weiter, sodass kein Formular kaputtgeht. Siehe Tarife und Abrechnung.

Wie findest du diese Anleitung?

Zuletzt aktualisiert am 16. November 2026