Bot Protection
Hält Bots von deinen Formularen, Anmeldungen und gehosteten Websites fern.
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.
- Kontrollkästchen und Unsichtbar: Setze das
divin das Formular, das du schützen willst. Bei einem Durchlauf füllt das Skript in diesem Formular ein verstecktes Feld namensxuda-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"oderdata-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.
Ein Durchlauf antwortet:
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.