В 2023 году Cloudflare объявила об отказе от CAPTCHA с запуском Turnstile — нашей клиентской проверки, ориентированной на конфиденциальность. Turnstile бесплатен в использовании, работает на любом сайте (нет необходимости проксировать трафик через Cloudflare) и никогда не просит посетителя решать головоломки. Теперь мы запускаем Turnstile Spin — управляемую агентом сквозную реализацию Turnstile.
Созданный изначально с расчетом на разработчиков, Turnstile требует базовой двухэтапной реализации и понимания интерфейсной и серверной разработки. Сначала вы изменяете код интерфейса для рендеринга виджета Turnstile; это позволяет Cloudflare запускать клиентские проверки и выдавать токен. Во-вторых, вы отправляете токен методом POST в наш API Siteverify, который проверяет токен и возвращает метаданные о том, прошел ли посетитель проверку или нет. Затем вы можете действовать на основе этого решения, например блокировать кнопку входа, пока посетитель успешно не решит задачу Turnstile.
В настоящее время Turnstile обрабатывает около трех миллиардов проверок в обычный будний день, а на прошлой неделе более 23 000 учетных записей создали новый виджет в панели управления Cloudflare. Это быстрое внедрение побудило нас оценить, как мы можем помочь пользователям беспрепятственно добиться полной проверки Turnstile. Turnstile создавался для разработчиков, но спрос на простую защиту от ботов простирается далеко за пределы людей, которые пишут бэкенд-код каждый день. ИИ повышает ставки: он помогает большему количеству людей создавать приложения, предоставляя при этом злоумышленникам больше способов автоматизации злоупотреблений. Мы хотели, чтобы та же технология упростила правильную установку Turnstile.
Turnstile Spin — это наша реализация этой новой возможности. Вы можете использовать ее для создания виджета, внедрения его на свой сайт и встраивания Siteverify в соответствующие функции на вашем бэкенде, точно так же, как если бы вы делали это вручную. Spin также исправляет неправильно установленные виджеты и управляет миграцией от других провайдеров CAPTCHA. Вы можете запустить его из своей панели управления Cloudflare, из Wrangler, или вставив URL публичного навыка в своего агента.
Адаптация Turnstile для эпохи ИИ-агентов кодинга
Когда мы только создавали Turnstile, веб-разработка следовала стандартному инженерному паттерну: разработчики вручную писали клиентские интерфейсы и бэкенд-логику. Настройка Turnstile естественным образом отражала этот двухэтапный рабочий процесс.
Сегодня способ создания веб-приложений кардинально изменился. ИИ-агенты кодинга теперь позволяют любому пользователю — от опытных инженеров до новичков — разворачивать функциональные сайты за считанные секунды. Тем не менее, рабочие процессы безопасности, разработанные для ручной разработки, не всегда совпадают с созданием на основе промптов.
Чтобы сделать Turnstile таким же простым для ИИ-разработчиков, каким он был для традиционных веб-разработчиков, мы внедряем нативную поддержку рабочих процессов ИИ-агентов. Spin создан для того, чтобы делать это автоматически. Чтобы проверить собственную настройку, откройте страницу Turnstile в своей учетной записи. Если виджет обслуживал трафик без проверки на бэкенде, вы увидите действие «Исправить с помощью Spin».
Знакомство с Turnstile Spin
Turnstile Spin превращает двухэтапную настройку в управляемый рабочий процесс с вашим агентом кодинга. Вы выбираете, где хотите обеспечить защиту, а агент находит соответствующий фронтенд- и бэкенд-код, предлагает план и ждет вашего одобрения. Затем он завершает обе стороны интеграции вместе. Человек без опыта бэкенда может правильно завершить настройку, в то время как опытный разработчик может пропустить повторяющуюся работу и восполнить упущенные шаги.
Spin не отправляет код вашего приложения в Cloudflare и не просит Cloudflare изменять его удаленно. Агент, которого вы уже используете — будь то Claude Code, Cursor, Codex или что-то еще — вносит одобренные изменения внутри вашей кодовой базы. Единственным новым ресурсом в вашей учетной записи Cloudflare является виджет Turnstile. Валидация остается в вашем бэкенде, рядом с логикой приложения, которая определяет, что происходит после проверки.
Spin может адаптироваться к любому из трех контекстов, обнаруженных в вашей кодовой базе:
1. Новая установка
CAPTCHA отсутствует. Агент внедряет виджет на ваш фронтенд и с нуля подключает Siteverify к вашему бэкенду.
2. Восстановление виджета
Cloudflare отслеживает вызовы Siteverify для каждого виджета, и любой виджет без проверки на стороне сервера получает баннер «Исправить с помощью Spin» в вашей панели управления. Агент использует тот же секретный ключ и добавляет недостающий шаг в ваш бэкенд, в то время как виджет продолжает обрабатывать трафик. Этот процесс предотвращает появление тикетов в службу поддержки, которые люди раньше отправляли по поводу настроек Turnstile.
3. Миграция с CAPTCHA
Агент обнаруживает существующие маркеры, предлагает план замены и применяет его после вашего одобрения. Существующие пути миграции Turnstile в документации по-прежнему охватывают детали, специфичные для инструментов.
Вы можете запустить Spin из , Cloudflare Wrangler или своего агента напрямую через наш навык. Как правило, вы будете использовать комбинацию этих трех способов: запустив процесс из панели управления и вставив навык в своего агента, который использует Wrangler для упрощения шагов за вас.
Первые результаты
Люди начали использовать Spin сразу же, как только он появился в панели управления. С момента релиза в июле панель управления зафиксировала более 65 000 успешных созданий виджета Spin, а разработчики скопировали сгенерированный промпт более 30 000 раз. Столь быстрое внедрение показало, что интеграция Turnstile непосредственно в рабочие процессы ИИ удовлетворяет реальную и острую потребность разработчиков.
Эти результаты также отражают главный урок, который я усвоил, создавая Spin во время стажировки: интуитивная идея все равно требует времени, обратной связи и неоднократного упрощения. В начале моей стажировки Брайан Бекер посоветовал мне делиться работой до того, как она покажется завершенной, а Марина Элмор постоянно возвращала меня к вопросу клиента, когда я слишком усложнял ответ. Я последовал этому совету, показывая ранние сырые версии, тестируя их с командой и сокращая столько шагов, сколько возможно, на пути к более простой безопасности для нашего клиента.
Попробуйте Turnstile сегодня с помощью Spin
Turnstile бесплатен для всех, поэтому попробуйте Spin, чтобы развернуть или исправить виджеты Turnstile за считанные минуты. Если у вас нет учетной записи Cloudflare, вы можете создать ее без каких-либо дополнительных настроек. Ознакомьтесь с docs для получения дополнительной информации и не стесняйтесь отправлять нам отзывы.
