Темы



Агенты теперь могут настроить безопасность вашего сайта с помощью Turnstile Spin

Коротко сгенерировано ИИ по тексту статьи
  • Cloudflare запустила инструмент Turnstile Spin для сквозной интеграции защиты сайта силами ИИ-агентов программирования.
  • Система Turnstile обрабатывает около трех миллиардов проверок в день, а более 23 000 аккаунтов добавили новые виджеты за неделю.
  • С момента релиза в июле с помощью Spin создано свыше 65 000 виджетов, а сгенерированный промпт скопировали более 30 000 раз.

Почему это важно: Инструмент позволяет пользователям без опыта бэкенд-разработки правильно внедрить защиту от ботов, а опытным инженерам — исключить повторяющуюся рутину и ошибки интеграции.

В 2023 году компания Cloudflare объявила о том, что её сервис больше не использует капчи (CAPTCHA), благодаря запуску Turnstile — нашей ориентированной на конфиденциальность клиентской системы проверки. Turnstile бесплатен в использовании, работает на любом сайте (нет необходимости проксировать трафик через Cloudflare) и никогда не просит посетителя решать головоломки. Теперь мы запускаем Turnstile Spin — управляемую агентом сквозную реализацию Turnstile.

Созданный изначально с расчетом на разработчиков, Turnstile требует базового двухэтапного внедрения и понимания фронтенд- и бэкенд-разработки. Сначала вы изменяете код фронтенда для отображения виджета Turnstile; это позволяет Cloudflare выполнять клиентские проверки и выдавать токен. Во-вторых, вы отправляете токен методом POST на наш API Siteverify, который проверяет токен и возвращает метаданные о том, прошел посетитель проверку или нет. Затем вы можете действовать на основе этого решения, например заблокировать кнопку входа до тех пор, пока посетитель успешно не пройдет проверку Turnstile.

Двухэтапный процесс Turnstile: виджет на фронтенде, вызов Siteverify на бэкенде.

В настоящее время в типичный будний день Turnstile обрабатывает около трех миллиардов проверок, а за одну из недавних недель более 23 000 учетных записей создали новый виджет в панели управления Cloudflare. Такое быстрое распространение побудило нас оценить, как мы можем помочь пользователям беспрепятственно выполнять полную проверку Turnstile. Turnstile создавался для разработчиков, но спрос на простую защиту от ботов выходит далеко за рамки людей, которые каждый день пишут бэкенд-код. Искусственный интеллект повышает ставки: он помогает создавать приложения большему количеству людей, одновременно предоставляя злоумышленникам новые способы автоматизации атак. Мы хотели, чтобы та же технология упростила правильную установку Turnstile.

Turnstile Spin — это наша реализация этой новой возможности. Вы можете использовать ее для создания виджета, внедрения его на свой сайт и интеграции Siteverify в соответствующие функции вашего бэкенда точно так же, как вы делали бы это вручную. Spin также исправляет неправильно установленные виджеты и управляет миграцией с других провайдеров CAPTCHA. Вы можете запустить его из своей панели управления Cloudflare, с помощью Wrangler или вставив URL публичного навыка в своего агента.

Адаптация Turnstile для эпохи ИИ-агентов программирования

Когда мы только создавали Turnstile, веб-разработка следовала стандартному инженерному шаблону: разработчики вручную писали клиентские интерфейсы и бэкенд-логику. Настройка Turnstile естественным образом отражала этот двухэтапный рабочий процесс.

Сегодня подход к созданию веб-приложений кардинально изменился. ИИ-агенты для написания кода теперь позволяют кому угодно — от опытных инженеров до новичков — за считанные секунды развертывать функциональные сайты. Тем не менее, рабочие процессы безопасности, разработанные для ручной разработки, не всегда соответствуют созданию приложений на основе промптов.

Чтобы сделать Turnstile таким же простым для ИИ-разработчиков, каким он был для традиционных веб-разработчиков, мы внедряем нативную поддержку рабочих процессов ИИ-агентов. Spin разработан для автоматического выполнения этой задачи. Чтобы проверить собственную настройку, откройте страницу Turnstile в своей учетной записи. Если виджет обрабатывал трафик без проверки на бэкенде, вы увидите действие «Исправить с помощью Spin» (Fix with Spin).

Знакомство с Turnstile Spin

Turnstile Spin превращает двухэтапную настройку в управляемый рабочий процесс совместно с вашим агентом программирования. Вы выбираете, где хотите обеспечить защиту, а агент находит соответствующий фронтенд- и бэкенд-код, предлагает план и ждет вашего одобрения. Затем он выполняет обе стороны интеграции одновременно. Человек без опыта бэкенд-разработки сможет завершить настройку правильно, в то время как опытный разработчик сможет пропустить повторяющуюся работу и вовремя обнаружить недостающие шаги.

Spin не отправляет код вашего приложения в Cloudflare и не просит Cloudflare изменять его удаленно. Агент, которым вы уже пользуетесь (будь то Claude Code, Cursor, Codex или что-то еще), вносит утвержденные изменения в вашу кодовую базу. Единственным новым ресурсом в вашей учетной записи Cloudflare является виджет Turnstile. Валидация остается на вашем бэкенде, рядом с логикой приложения, которая определяет, что происходит после прохождения проверки.

Spin может адаптироваться к любому из трех контекстов, которые он обнаруживает в вашей кодовой базе:

1. Новая установка

Капча отсутствует. Агент встраивает виджет на ваш фронтенд и с нуля подключает Siteverify к вашему бэкенду.

Use your preferred coding agent to install Turnstile, as seen here in a sped-up GIF.

Используйте предпочитаемого агента программирования для установки Turnstile, как показано здесь на ускоренной GIF-анимации.

2. Восстановление виджета

Cloudflare отслеживает вызовы Siteverify для каждого виджета, и любой виджет без проверки на стороне сервера получает плашку «Исправить с помощью Spin» в вашей панели управления. Агент использует тот же секретный ключ и добавляет недостающий шаг в ваш бэкенд, пока виджет продолжает обрабатывать трафик. Этот процесс предотвращает появление тех самых тикетов в техподдержку, которые пользователи раньше отправляли по поводу настройки Turnstile.

Use Spin to fix the implementation of existing widgets.

Используйте Spin для исправления реализации существующих виджетов.

3. Миграция с CAPTCHA

Агент обнаруживает существующие маркеры, предлагает план замены и применяет его после вашего одобрения. Существующие пути миграции на Turnstile, описанные в документации, по-прежнему охватывают детали, специфичные для конкретных инструментов.

Use Spin to migrate to Turnstile.

Используйте Spin для миграции на Turnstile.

Вы можете запустить Spin из панели управления, через Cloudflare Wrangler или напрямую через вашего агента с помощью нашего навыка. Как правило, вы будете использовать комбинацию всех трех способов: запустив процесс в панели управления и вставив навык вашему агенту, который воспользуется Wrangler для выполнения необходимых шагов за вас.

image1.png

Первые результаты

Люди начали использовать Spin сразу же, как только он появился в панели управления. С момента релиза в июле панель управления зафиксировала более 65 000 успешных созданий виджетов с помощью Spin, а разработчики скопировали сгенерированный промпт более 30 000 раз. Столь быстрое распространение продемонстрировало, что интеграция Turnstile непосредственно в рабочие процессы ИИ удовлетворяет реальную и острую потребность разработчиков.

Эти результаты также отражают важнейший урок, который я усвоил, создавая Spin во время стажировки: интуитивная идея все равно требует времени, обратной связи и неоднократного упрощения. В начале моей стажировки Брайан Бекер (Bryan Becker) посоветовал мне делиться работой до того, как она покажется завершенной, а Марина Элмор (Marina Elmore) возвращала меня к задаче клиента каждый раз, когда я излишне усложнял решение. Я последовал этому совету, показывая ранние версии набросков, тестируя их с командой и сокращая как можно больше шагов на пути к более простой безопасности для нашего клиента.

Попробуйте Turnstile сегодня с помощью Spin

Turnstile бесплатен для всех, поэтому попробуйте Spin, чтобы развернуть или исправить виджеты Turnstile за считанные минуты. Если у вас нет учетной записи Cloudflare, вы можете создать ее без каких-либо дополнительных настроек. Ознакомьтесь с документацией для получения дополнительной информации и не стесняйтесь присылать нам свои отзывы.

© Cloudflare Blog