Bot Protection
Houdt bots weg van je formulieren, inlogschermen en gehoste sites.
Bot Protection heeft in code twee kanten. Op je pagina tekent een klein script de controle en zet het een token in je formulier wanneer een bezoeker erdoor komt. Op je server bevestigt één aanvraag dat token met de geheime sleutel van de setup. Geen van beide heeft een API-sleutel van een account nodig: de eigen sitesleutel (openbaar) en geheime sleutel (privé) van een setup bepalen hun bereik.
De setups zelf, hun abonnementen en hun cijfers beheer je in het dashboard.
Op je pagina
Kopieer de insluitcode uit de setup; hij bevat al de sitesleutel van de setup. Dit is de vorm voor elke manier waarop de controle verschijnt.
- Selectievakje en Onzichtbaar: zet de
divin het formulier dat je wilt beschermen. Bij een geslaagde controle vult het script een verborgen veld met de naamxuda-captcha-responsein dat formulier, zodat het token mee wordt verstuurd. - Onzichtbaar toont niets. Een formulier dat zonder vers token wordt verstuurd, wordt vastgehouden, de controle draait en het formulier wordt opnieuw verstuurd.
- Hele pagina is alleen het script, in de head van de pagina. De pagina is afgedekt totdat de bezoeker erdoor is, en dat tabblad krijgt de vraag niet opnieuw totdat zijn geslaagde controle verloopt.
- Een setup met als uiterlijk Licht of Donker voegt
data-theme="light"ofdata-theme="dark"toe.
De controle draait alleen op de toegestane domeinen van de setup.
Callbacks
Geef een globale functie een naam op de div (of op het script, bij Hele pagina) om te horen wat er gebeurde:
window.xudaCaptcha.execute(element) geeft een promise van een vers token terug, voor een formulier dat je vanuit je eigen code verstuurt.
Op je server
Post het token en de geheime sleutel van de setup naar captcha_siteverify. Accepteer het formulier alleen wanneer het antwoord success zegt. Bewaar de geheime sleutel in de eigen configuratie van je server, nooit in een pagina.
Een geslaagde controle geeft als antwoord:
Een token wordt maar één keer geaccepteerd en leeft twee minuten. Bevestig het wanneer het formulier binnenkomt, niet later, en bevestig nooit twee keer hetzelfde token.
Wanneer het niet slaagt
success is false en error-codes zegt waarom:
Het antwoord heeft dezelfde vorm als dat van reCAPTCHA en Turnstile, dus servercode die daarvoor is geschreven, hoeft meestal alleen van adres en geheim te veranderen.
Abonnementslimieten
Een controle wordt geteld wanneer de eerste stap van een bezoeker tot een beslissing komt. De maandlimiet van het abonnement leest de controles op je eigen sites en formulieren; alles wat met Xuda wordt gehost, telt niet mee. Boven een limiet wordt de AI-stap tot volgende maand overgeslagen en blijft elke controle draaien, dus er gaat geen formulier kapot. Zie Abonnementen en facturering.