April 23, 2023

Переключиться с reCAPTCHA на hCaptcha

Переключиться с reCAPTCHA на hCaptcha очень просто. Ниже вы можете найти пошаговое руководство, которое поможет с этим обновлением.

ПРИМЕЧАНИЕ

Вам не нужно обновлять свои callback или атрибуты тегов. hCaptcha API-совместима с reCAPTCHA.

Получите ваш ключ сайта hCaptcha и секретный ключ

  1. Зарегистрируйтесь или войдите в панель управления hCaptcha.
  2. Перейдите на вкладку «Сайты» на панели инструментов и создайте новый ключ сайта.
  3. Перейдите на вкладку «Настройки» на панели инструментов и скопируйте свой секретный ключ.

Обновите интеграцию на стороне клиента

1. Замените тег скрипта:

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

на

<script src="https://js.hcaptcha.com/1/api.js"
        async defer></script>

2. Замените имя параметра:

g-recaptchaнаh-captcha

Обновите интеграцию на стороне сервера

  1. Обновить секретный ключ: Используйте секретный ключ, который вы получили на первом шаге.
  2. Замените поле, используемое из формы:g-recaptcha-responseнаh-captcha-response
  3. Обновите URL проверки сайтаhttps://www.google.com/recaptcha/api/siteverify(или https://www.recaptcha.net/recaptcha/api/siteverify) становитсяhttps://api.hcaptcha.com/siteverify
  4. Инвертировать потребление баллов (только reCAPTCHA v3 или Enterprise в hCaptcha Enterprise)
    Оценки reCAPTCHA варьируются от 0,0 (бот) до 1,0 (человек). Оценки hCaptcha Enterprise — это оценки риска , поэтому они варьируются от 0,0 (нет риска) до 1,0 (подтвержденная угроза). Дополнительные сведения см. в документации hCaptcha Enterprise по баллам . (Требуется вход в учетную запись Enterprise.) Это означает, что вы должны инвертировать все проверки оценок в коде потребления оценок.
If (score < threshold) Then [mitigate]

становится

If (score >= threshold) Then [mitigate]