logo
bars

FunCaptcha
и CapMonster Cloud

Решение капчи, установка на сайт и тестирование.
Вам достался «по наследству» сайт с подключённой капчей или другой защитой, но доступа к исходному коду нет? В такой ситуации возникают вопросы: какую именно систему защиты использует сайт, правильно ли она установлена и как проверить её работу?

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

Если вы обнаружили, что на вашем сайте используется FunCaptcha (Arkose Labs CAPTCHA), следующим шагом станет более подробное изучение её свойств и самой работы. Также в этой статье вы можете изучить инструкцию по подключению системы FunCaptcha (Arkose Labs CAPTCHA), чтобы полностью разобраться, как она функционирует на вашем сайте. Это позволит не только понимать текущую защиту, но и грамотно планировать её поддержку.

Что такое FunCaptcha
Что такое FunCaptcha
FunCaptcha — это интерактивная система защиты от ботов, разработанная компанией Arkose Labs. Она проверяет, является ли пользователь реальным человеком, с помощью игровых и визуальных заданий, которые легко выполняются людьми, но сложны для автоматизации. FunCaptcha применяется для защиты регистрации, входа в аккаунт, онлайн-платежей, маркетинговых кампаний и предотвращения фрода, спама и массовых автоматизированных действий.
Background
Виды FunCaptcha
Поворот 3D‑объекта
Поворот 3D‑объекта
Пользователь вращает 3D‑модель или фигуру, чтобы разместить её в правильной позиции.
Выбор объектов по условию
Выбор объектов по условию
Нужно выбрать изображения или элементы, которые соответствуют заданному правилу (например, «выберите все яблоки»).
Интерактивные задания (drag‑and‑drop / следование по пути)
Интерактивные задания (drag‑and‑drop / следование по пути)
Пользователь выполняет действия с элементами, например, перетаскивает их по определённому пути.
Аудио‑вопросы
Аудио‑вопросы
Пользователь слушает аудио и выбирает правильный ответ (используется реже, как альтернатива визуальным заданиям).

Как решить FunCaptcha через CapMonster Cloud

При тестировании форм с FunCaptcha часто возникает необходимость проверить работу капчи и убедиться, что она корректно интегрирована.
Вы можете вручную протестировать подставленную на ваш сайт капчу.
  • Откройте страницу с формой и убедитесь, что капча отображается.
  • Попробуйте отправить форму без её прохождения — сервер должен выдать ошибку.
  • После успешного решения капчи — форма должна отправиться без ошибок.
Для автоматического распознавания капчи можно использовать специализированные сервисы, например, CapMonster Cloud — инструмент, который принимает параметры капчи, обрабатывает их на своих серверах и возвращает готовый токен. Этот токен можно подставить в форму, чтобы пройти проверку без участия пользователя.

Работа с CapMonster Cloud через API обычно включает следующие шаги:

Создание задачи (Task)Создание задачи (Task)
arrow
Отправка запроса к APIОтправка запроса к API
arrow
Получение результатаПолучение результата
arrow
Подстановка токена на страницуПодстановка токена на страницу
arrow
Как подключить FunCaptcha к своему сайту
Чтобы уверенно ориентироваться в работе капчи на вашем сайте, понимать логику её проверки, заново подключить или перенастроить, рекомендуем вам изучить этот раздел. В нём описан процесс подключения защиты — это поможет быстро разобраться во всех нюансах.
  1. Зарегистрируйтесь в Arkose Labs и получите доступ к Arkose Command Center (можно написать в чат, указав свои данные в форме — например, здесь или здесь).
  2. После получения доступа получите два ключа (Public / Private) в разделе Settings → Keys.

    HowTo Connect image 1

  3. При необходимости обратитесь к Customer Success Manager (CSM) для:

    • получения кастомных API-доменов;
    • Verify API схем запросов и ответов.

Рекомендации Arkose

  • Используйте Development Key для тестирования.
  • Используйте отдельный Production Key для каждого workflow (login, register, purchase и т.д.).
  • Используйте разные ключи для разных сайтов.

Общий процесс работы

  • Клиент собирает данные и при необходимости показывает челлендж.
  • Клиент получает одноразовый токен.
  • Сервер проверяет токен через Arkose Verify API.

Шаг 1. Клиентская интеграция

На стороне браузера (Arkose Bot Manager):

  • анализирует поведение пользователя;
  • при необходимости показывает Enforcement Challenge;
  • возвращает одноразовый session token.

Client API:

  • Для тестов можно использовать:
    client-api.arkoselabs.com
  • Для продакшена желательно указывать кастомный домен:
    <company>-api.arkoselabs.com

Основные требования

Результат работы клиента — token, который нужно отправить на сервер.

Шаг 2. Серверная проверка

На сервере выполняется проверка токена через Arkose Verify API.

Verify API endpoint

Обязательные параметры запроса

Пример тела POST-запроса

Ответ API содержит информацию о сессии и результат проверки.

Ключевые моменты

Как это работает:

Background
Возможные ошибки и отладка
Bug Icon
Некорректные параметры запроса
Убедитесь, что вы правильно указали Public Key для клиента и Private Key для сервера, а также передаёте корректный session_token в Verify API.
Bug Icon
Пустой или неверный session_token
Сервер получит пустой результат или ошибку проверки. Проверьте, что клиент корректно отправляет token после прохождения капчи.
Bug Icon
Таймаут решения
Если пользователь не завершил проверку вовремя, сервер Arkose может вернуть ошибку или отклонить верификацию. Увеличьте допустимое время ожидания на серверной стороне.
Проверка устойчивости защиты
Рекомендации по безопасности и оптимизации
<b>Храните Private Key только на сервере</b>, не включайте его в JS-код на клиенте.
Логируйте полные ответы Arkose Verify API, включая статус проверки, код ошибки и переданные параметры — это помогает быстрее диагностировать проблемы.
Используйте <b>HTTPS</b> для всех запросов (клиент → сервер → Verify API), чтобы исключить подмену данных.
Разместите на сайте ссылки на <b>Политику конфиденциальности</b> и <b>Условия использования Arkose Labs</b>, как требуется лицензией.
Заключение

Если вам достался сайт с уже установленной капчей или другой системой защиты и при этом нет доступа к коду — ничего страшного! Определить, какая именно технология используется, достаточно легко. А для проверки корректности работы можно использовать сервис распознавания CapMonster Cloud в изолированной тестовой среде, чтобы убедиться, что механизм обработки токенов и логика проверки функционируют корректно.

В случае с FunCaptcha — достаточно распознать систему, изучить её поведение и убедиться, что защита функционирует корректно. В статье мы показали, как определить FunCaptcha и где найти инструкции по её подключению или перенастройке, чтобы уверенно поддерживать защиту и контролировать её работу.

Conclusion
Полезные ссылки
DocIconДокументация FunCaptcha (Arkose Labs CAPTCHA)DocIconФорма для запроса на подключение FunCaptchaDocIconДокументация CapMonster Cloud (работа с FunCaptcha)