Bot Protection
Pitää botit poissa lomakkeiltasi, kirjautumisistasi ja isännöidyiltä sivustoiltasi.
Bot Protectionilla on koodissa kaksi puolta. Sivullasi pieni skripti piirtää tarkistuksen ja lisää lomakkeeseesi tunnisteen (token), kun kävijä pääsee läpi. Palvelimellasi yksi pyyntö vahvistaa tämän tunnisteen määrityksen salaisella avaimella. Kumpikaan ei tarvitse tilin API-avainta: niiden rajaus tulee määrityksen omasta sivustoavaimesta (julkinen) ja salaisesta avaimesta (yksityinen).
Itse määrityksiä, niiden paketteja ja niiden lukuja hallitaan hallintapaneelissa.
Sivullasi
Kopioi upotuskoodi määrityksestä. Siinä on jo määrityksen sivustoavain. Tässä sen muoto kullekin tarkistuksen näkymistavalle.
- Valintaruutu ja Näkymätön: aseta
divsuojattavan lomakkeen sisään. Läpäisyn jälkeen skripti täyttää kyseisessä lomakkeessa piilokentän nimeltäxuda-captcha-response, jolloin tunniste lähetetään lomakkeen mukana. - Näkymätön ei näytä mitään. Lomake, joka lähetetään ilman tuoretta tunnistetta, pysäytetään, tarkistus ajetaan ja lomake lähetetään uudelleen.
- Koko sivu on pelkkä skripti sivun head-osassa. Sivu on peitetty, kunnes kävijä pääsee läpi, eikä samaa välilehteä pyydetä uudelleen, ennen kuin sen läpäisy umpeutuu.
- Määritys, jonka ulkoasu on Light tai Dark, lisää
data-theme="light"taidata-theme="dark".
Tarkistus toimii vain määrityksen sallituilla verkkotunnuksilla.
Takaisinkutsut
Nimeä globaali funktio div-elementille (tai Koko sivu -tilassa skriptille), jotta saat tiedon tapahtuneesta:
window.xudaCaptcha.execute(element) palauttaa lupauksen (promise) tuoreesta tunnisteesta, lomakkeelle jonka lähetät omasta koodistasi.
Palvelimellasi
Lähetä tunniste ja määrityksen salainen avain metodille captcha_siteverify. Hyväksy lomake vasta, kun vastauksessa lukee success. Pidä salainen avain palvelimesi omassa konfiguraatiossa, älä koskaan sivulla.
Läpäisy vastaa:
Tunniste hyväksytään vain kerran, ja se elää kaksi minuuttia. Vahvista se, kun lomake saapuu, ei myöhemmin, äläkä vahvista samaa tunnistetta kahdesti.
Kun läpäisy ei onnistu
success on false, ja error-codes kertoo syyn:
Vastauksen muoto on sama kuin reCAPTCHAn ja Turnstilen antamilla, joten niitä varten kirjoitettuun palvelinkoodiin riittää yleensä osoitteen ja salaisen avaimen vaihto.
Paketin rajat
Tarkistus lasketaan, kun kävijän ensimmäinen vaihe johtaa päätökseen. Paketin kuukausiraja lukee omien sivustojesi ja lomakkeidesi tarkistukset. Mitään Xudalla isännöityä ei lasketa. Rajan jälkeen tekoälyvaihe ohitetaan seuraavaan kuuhun asti ja kaikki tarkistukset jatkavat toimintaansa, joten mikään lomake ei rikkoudu. Katso Paketit ja laskutus.