reCAPTCHA v3
и CapMonster Cloud

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

1. Перейдите на страницу админ-панели reCAPTCHA.

2. Зарегистрируйте новый сайт и выберите тип капчи — reCAPTCHA v3

3. Получите два ключа:

• Site key — публичный ключ (используется на фронтенде);
• Secret key — приватный ключ (используется на сервере для проверки)

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

4. Примеры кода для клиентской части

Самый простой способ использовать reCAPTCHA v3 — подключить JavaScript API и добавить атрибуты к кнопке.

Подключение API:

<script src="https://www.google.com/recaptcha/api.js"></script>

Функция обратного вызова для формы:

<script>
  function onSubmit(token) {
    document.getElementById("form").submit();
  }
</script>

Кнопка с атрибутами reCAPTCHA:

<button class="g-recaptcha" 
        data-sitekey="reCAPTCHA_sitekey" 
        data-callback='onSubmit' 
        data-action='submit'>Submit</button>

Для полного контроля используйте grecaptcha.execute с параметром render:

Подключение API с ключом:

<script src="https://www.google.com/recaptcha/api.js?render=reCAPTCHA_site_key"></script>

Программный вызов:

<script>
  function onClick(e) {
    e.preventDefault();
    grecaptcha.ready(function() {
      grecaptcha.execute('reCAPTCHA_sitekey', {action: 'submit'}).then(function(token) {
          // Отправьте токен на сервер для проверки
      });
    });
  }
</script>

Токен следует сразу отправлять на сервер для верификации.

Важные замечания:

• Срок действия токена: токен, полученный от reCAPTCHA v3, действителен в течение 2 минут. Убедитесь, что вы отправляете его на сервер в течение этого времени.
• Проверка на сервере: после получения токена на сервере, отправьте POST-запрос на https://www.google.com/recaptcha/api/siteverify с параметрами:
  – secret: ваш секретный ключ
  – response: токен, полученный от клиента
  – remoteip (необязательно): IP-адрес пользователя
• Сервер Google вернёт JSON-ответ, содержащий информацию о результате проверки.

Более подробную информацию можете узнать в документации самой капчи.

5. Теперь на серверной стороне выполните проверку ответа

Пример на PHP

<?php
// Ваш секретный ключ reCAPTCHA v3
$secret = 'YOUR_SECRET_KEY';

// Получаем токен с формы
$token = $_POST['recaptcha-token'] ?? '';

// Отправляем запрос к Google для проверки токена
$response = file_get_contents(
    "https://www.google.com/recaptcha/api/siteverify?secret={$secret}&response={$token}"
);

$result = json_decode($response, true);

// Проверяем успешность и оценку доверия
if ($result['success'] && $result['score'] >= 0.5 && $result['action'] === 'submit') {
    echo "Проверка пройдена";
} else {
    http_response_code(403);
    echo "Проверка не пройдена";
}
?>

Примечания:

• Убедитесь, что на клиенте токен отправляется в скрытом поле формы с именем recaptcha-token:

<input type="hidden" name="recaptcha-token" id="recaptcha-token">


• Порог score можно менять в зависимости от уровня строгости (например, 0.3–0.7).
• Проверка action === 'submit' повышает безопасность, чтобы убедиться, что токен предназначен для конкретного действия на странице.