Bot Protection
Trzyma boty z dala od Twoich formularzy, logowań i hostowanych stron.
Bot Protection ma w kodzie dwie strony. Na Twojej stronie mały skrypt rysuje kontrolę i umieszcza w formularzu token, gdy odwiedzający ją przejdzie. Na Twoim serwerze jedno żądanie potwierdza ten token za pomocą klucza tajnego konfiguracji. Żadne z nich nie potrzebuje klucza API konta: zakres wyznaczają klucz witryny (publiczny) i klucz tajny (prywatny) danej konfiguracji.
Same konfiguracje, ich plany i liczby zarządzasz w dashboardzie.
Na Twojej stronie
Skopiuj kod do osadzenia z konfiguracji; ma już w sobie klucz witryny. Tak wygląda dla każdego sposobu wyświetlania kontroli.
- Checkbox i Invisible: umieść
divwewnątrz formularza, który chcesz chronić. Po przejściu kontroli skrypt wypełnia w tym formularzu ukryte pole o nazwiexuda-captcha-response, więc token jest wysyłany razem z formularzem. - Invisible niczego nie pokazuje. Formularz wysłany bez świeżego tokena jest wstrzymywany, kontrola działa, a formularz wysyła się ponownie.
- Full page to sam skrypt, w nagłówku (head) strony. Strona jest zasłonięta, dopóki odwiedzający nie przejdzie kontroli, a ta karta nie jest pytana ponownie, dopóki jej przepustka nie wygaśnie.
- Konfiguracja z wyglądem Jasny lub Ciemny dodaje
data-theme="light"albodata-theme="dark".
Kontrola działa tylko na dozwolonych domenach konfiguracji.
Wywołania zwrotne
Nazwij globalną funkcję na div (albo na skrypcie, dla Full page), aby dowiedzieć się, co się stało:
window.xudaCaptcha.execute(element) zwraca obietnicę (promise) świeżego tokena, dla formularza wysyłanego z Twojego własnego kodu.
Na Twoim serwerze
Wyślij token i klucz tajny konfiguracji do captcha_siteverify. Przyjmij formularz tylko wtedy, gdy odpowiedź zawiera success. Klucz tajny trzymaj we własnej konfiguracji serwera, nigdy na stronie.
Udane przejście zwraca:
Token jest przyjmowany tylko jeden raz i żyje dwie minuty. Potwierdź go, gdy formularz dotrze, nie później, i nigdy nie potwierdzaj tego samego tokena dwa razy.
Gdy kontrola nie przechodzi
success ma wartość false, a error-codes mówi dlaczego:
Odpowiedź ma ten sam kształt co odpowiedzi reCAPTCHA i Turnstile, więc kod serwera napisany dla nich zwykle wymaga tylko zmiany adresu i klucza tajnego.
Limity planu
Kontrola jest liczona, gdy pierwszy krok odwiedzającego dochodzi do decyzji. Miesięczny limit planu odczytuje kontrole na Twoich własnych stronach i formularzach; wszystko hostowane w Xuda nie jest liczone. Po przekroczeniu limitu krok AI jest pomijany do następnego miesiąca, a każda kontrola nadal działa, więc żaden formularz się nie psuje. Zobacz Plany i rozliczenia.