← Challenges / cloudflare-challenges / challenge-types

Turnstile

Turnstile это решение Cloudflare, альтернативное CAPTCHA. Вы можете встроить Turnstile в виде виджета на веб-сайт или в приложение, где он выполняет клиентскую проверку прямо в фоновом режиме браузера посетителя.

Turnstile отличается от Challenge Pages тем, что проверка не приостанавливает запрос и не прерывает работу пользователя. Так как виджет встраивается в веб-страницу и запускается только на определённом её участке, посетитель уже находится на целевом URL и просматривает страницу в момент, когда сталкивается с виджетом Turnstile. Вместо того чтобы блокировать доступ ко всему сайту, виджет Turnstile ограничивает определённые действия посетителя, например заполнение форм входа или регистрации, пока виджет не будет пройден.

В большинстве случаев от посетителя больше ничего не требуется. Однако при необходимости Turnstile может показать простой флажок, который посетитель должен нажать, чтобы продолжить.

После того как проверка пройдена, Turnstile выдаёт посетителю токен clearance, который нужно проверить через Siteverify API перед выполнением важного действия, такого как вход, регистрация или отправка других форм.

Хотя для сайта или приложения можно выбрать один из трёх типов виджетов, логика проверки во всех случаях одинакова.

• Managed (recommended): Работает аналогично Managed Challenge Page. Она выбирает проверку на основе сигналов, собранных из браузера посетителя, и показывает взаимодействие только при обнаружении потенциально автоматизированного трафика.

• Non-Interactive: Виджет отображается, но посетителю не нужно с ним взаимодействовать, чтобы подтвердить личность.

• Invisible: Виджет полностью невидим для посетителя, но проверка всё равно выполняется в фоновом режиме.

Когда вы создаёте виджет для сайта или приложения в панели управления Cloudflare, вы получаете sitekey.

sitekey используется с рендеринг на стороне клиента добавив его в <div> заполнитель контейнера. Затем вы разместите <div> фрагмент кода в том месте страницы сайта или формы, куда нужно добавить виджет.

См. документация Turnstile для получения инструкций по внедрению виджета на веб-сайт или в приложение.