← Cloudflare Turnstile / turnstile / turnstile-analytics
Результат проверки
Когда посетитель встречает Turnstile, тот по различным сигналам оценивает, человек это или бот. Результаты такой оценки помогают понять, насколько эффективно Turnstile защищает ваше приложение.
Метрики
«Решённая» проверка Turnstile сама по себе не подтверждает, что перед вами человек. Необходимо вызвать Siteverify API, чтобы проверить токен и продолжить только в том случае, если в ответе возвращается success:true.
Например, значения результатов проверки в аналитике могут выглядеть так:

- Выданные проверки: общее количество проверок, показанных посетителям за выбранный период.
- Решённые проверки: количество проверок, успешно пройденных посетителями за этот период.
- Нерешённые проверки: проверки, которые за этот период были прерваны или завершились неудачно.
- Вероятно человек: общее количество решённых проверок или общее количество выданных проверок.
- Вероятно бот: общее количество нерешённых проверок или общее количество выданных проверок.
Анализ этих метрик показывает закономерности: например, высокую долю неудачных проверок в отдельных регионах, на определённых типах устройств или в конкретных источниках трафика. Такие всплески указывают на активность ботов или на ошибки в настройке.
Вызов Siteverify
Важно вызвать Siteverify API. Без вызова Siteverify API для проверки токенов ваш сайт или приложение не защищены. Если пропустить валидацию токена, вы не сможете подтвердить, что посетитель настоящий.
- Токен можно использовать только один раз. Даже действительный токен при повторной отправке вернёт
success:false, если они используются повторно, что предотвращает кражу токенов и атаки повторного воспроизведения. - Токен истекает через пять минут. Валидация должна пройти в этот срок, иначе она бессмысленна.
- Токен может оказаться недействительным. Боты иногда проходят проверку, но Cloudflare распознаёт характерные для ботов сигналы и помечает токен как недействительный.
Доля успешных прохождений
Доля успешно пройденных проверок в Turnstile показывает, сколько посетителей проходят проверку. Её можно разложить на общее число пройденных проверок и на то, были ли они интерактивными, неинтерактивными или относились к pre-clearance.
Если вы используете режим Managed, вы можете отслеживать, сколько посетителей получили запрос на взаимодействие с флажком в виджете (интерактивные решения) и сколько прошли проверку без каких-либо помех (неинтерактивные решения).
Например, значения доли успешных проверок в аналитике могут выглядеть так:

Метрики
- Решённые неинтерактивные проверки: проверки, для решения которых посетителю не пришлось нажимать флажок.
- Решённые интерактивные проверки: решённые проверки, для которых потребовалось действие посетителя.
- Решённые проверки с pre-clearance: решённые проверки, в которых был выдан
cf_clearancecookie вместе с токеном Turnstile.
Низкая доля решённых проверок может говорить о росте активности ботов, которые пытаются обойти Turnstile, или об аномальном трафике, который стоит изучить подробнее.