Часто задаваемые вопросы

Нужно ли мне использовать reCAPTCHA Enterprise?

reCAPTCHA Enterprise предлагает до 10 000 бесплатных проверок в месяц и дополнительные функции. Другие функции, например аналитика в реальном времени, – это то, с чего стоит начать большинству разработчиков. Начните работу.

Можно ли использовать reCAPTCHA со сторонними решениями?

Да, вы можете использовать как reCAPTCHA (не корпоративную версию), так и reCAPTCHA Enterprise. Обычно стороннее решение запрашивает открытый ключ и секретный ключ или ключ API. Предоставляйте секретный ключ и ключ API только надежным третьим лицам.

Как перейти на reCAPTCHA Enterprise с версии 2 или 3?

Процесс переноса занимает 5–10 минут и не требует изменения кода.

Какую версию reCAPTCHA выбрать: v2 или v3?

reCAPTCHA v3 предназначена для владельцев сайтов, которые хотят получать больше данных о трафике. Дополнительную информацию можно найти в руководстве для разработчиков по reCAPTCHA v3.

Мы обеспечиваем безопасность и удобство использования версии 2.

Подробнее о различиях между reCAPTCHA v2 и v3…

Использует ли reCAPTCHA файлы cookie?

При выполнении reCAPTCHA устанавливает необходимый файл cookie (_GRECAPTCHA) для анализа рисков. Если вы не хотите использовать домен www.google.com, в котором могут быть заданы другие файлы cookie, вы можете использовать www.recaptcha.net.

Есть ли ограничения на количество запросов/сек или дневное ограничение при использовании reCAPTCHA?

Если вам нужно выполнять более 1000 вызовов в секунду или более 1 000 000 вызовов в месяц, используйте reCAPTCHA Enterprise или заполните эту форму и дождитесь одобрения исключения. Если ключ сайта превышает 1000 запросов в секунду, некоторые запросы могут не обрабатываться. Если ключ сайта v3 превысит месячную квоту, то `site_verify` может не сработать, возвращая статическую оценку 0,9 и сообщение об ошибке `"Over free quota."` до конца месяца. При превышении квоты для сайтов с reCAPTCHA v3 пользователи не увидят никаких уведомлений. Если ключ сайта v2 превысит месячную квоту, то в виджете reCAPTCHA до конца месяца может показываться сообщение "Для этого сайта превышена квота reCAPTCHA" или аналогичное.Прежде чем квота будет применена, владельцы сайтов получат три уведомления по электронной почте и у них будет не менее 90 дней на переход на reCAPTCHA Enterprise. Ключи сайта считаются превысившими квоту, если для любого домена используется более 1 000 000 вызовов в месяц. в том числе если этот объем распределен по нескольким ключам в одном домене.

Я хочу скрыть значок reCAPTCHA. Что разрешено

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

This site is protected by reCAPTCHA.

Пример:

Примечание. Если вы решите скрыть значок, используйте 

.grecaptcha-badge { visibility: hidden; }

Я хочу запустить автоматизированные тесты с reCAPTCHA. Что делать?

Для reCAPTCHA v3 создайте отдельный ключ для тестовых сред. Оценки могут быть неточными, поскольку reCAPTCHA v3 анализирует реальный трафик.

Для reCAPTCHA v2 используйте следующие тестовые ключи. Вы всегда будете получать No CAPTCHA, и все запросы на проверку будут проходить.

  • Ключ сайта: 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI
  • Секретный ключ: 6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe

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

Как избежать пошагового выполнения кода reCAPTCHA при отладке сайта?

Чтобы не переходить к коду reCAPTCHA при отладке другого кода JavaScript на сайте, добавьте скрипт reCAPTCHA /recaptcha__.+\.js$ в список игнорирования браузера. Инструкции для Chrome приведены в статье Игнорирование специального списка скриптов. Похожие функции есть и в других браузерах.

Как получить больше информации о трафике на сайте?

reCAPTCHA ежедневно отправляет статистику за день в консоль администратора.

Можно ли использовать reCAPTCHA по всему миру?

Да, если домен www.google.com недоступен, используйте в коде домен www.recaptcha.net.

  • Сначала замените <script src="https://www.google.com/recaptcha/api.js"></script> на <script src="https://www.recaptcha.net/recaptcha/api.js"></script>.
  • После этого сделайте то же самое везде, где на вашем сайте используется www.google.com/recaptcha/.

Можно ли настроить виджет или значок reCAPTCHA?

Да. reCAPTCHA предлагает две темы: светлую и темную, как показано ниже. Чтобы выбрать тему, просто задайте атрибут data-theme в параметре grecaptcha.render.

Светлая тема:

Тёмная тема

Как настроить reCAPTCHA v3?

JavaScript API, доступный для невидимой проверки reCAPTCHA, также работает с версией 3. Просто используйте JavaScript API, чтобы явно отобразить reCAPTCHA с ключом сайта версии 3 и получить доступ к таким параметрам, как изменение положения значка или темы.

При отрисовке reCAPTCHA v3 с помощью этого метода не забудьте задать для параметра size значение 'invisible' и использовать идентификатор клиента, возвращенный методом grecaptcha.render, при вызове метода grecaptcha.execute вместо ключа сайта.

Недавно в виджете reCAPTCHA стало появляться сообщение "Недействительный ключ сайта". Что случилось?

Если вы видите эту ошибку, значит ключ сайта reCAPTCHA больше не действителен. Чтобы активировать его, зарегистрируйте новый ключ и следуйте инструкциям на этой странице.

Я получаю необработанную ошибку SecurityError: фрейму с источником https://www.google.com заблокирован доступ к фрейму с источником <ваш домен>. Что делать?

Обычно это происходит, если элемент HTML виджета reCAPTCHA удаляется программно после того, как конечный пользователь нажимает на флажок. Для сброса виджета reCAPTCHA рекомендуем использовать функцию JavaScript grecaptcha.reset().

На моем сайте используется Content-Security-Policy (CSP). Как настроить его для работы с reCAPTCHA?

Рекомендуем использовать подход на основе однократно используемых чисел, описанный в CSP3. Добавьте одноразовый код в тег скрипта api.js reCAPTCHA.

Примечание. reCAPTCHA также работает с директивой strict-dynamic в браузерах, которые ее поддерживают.

Или добавьте в директивы следующие значения:

  • script-src https://www.google.com/recaptcha/, https://www.gstatic.com/recaptcha/
  • frame-src https://www.google.com/recaptcha/, https://recaptcha.google.com/recaptcha/
  • connect-src https://www.google.com/recaptcha/

Я получаю сообщение об ошибке "Localhost is not in the list of supported domains" (Localhost не входит в список поддерживаемых доменов). Что делать?

Домены localhost по умолчанию не поддерживаются. Если вы хотите продолжить использовать их для разработки, добавьте их в список поддерживаемых доменов для ключа сайта. Чтобы обновить список поддерживаемых доменов, перейдите в консоль reCAPTCHA Enterprise или консоль reCAPTCHA. Рекомендуем использовать разные ключи для разработки и производства и разрешить localhost только для ключа сайта разработки.

Почему на устройствах с iOS 10 страница прокручивается вниз, когда пользователь проходит проверку?

Это ошибка фокусировки со стороны Apple, о которой мы сообщили. Она затрагивает только пользователей iOS 10 и только на некоторых сайтах. Если вы столкнулись с этой проблемой, переместите виджет reCAPTCHA выше или ниже на странице или используйте reCAPTCHA v3.

Мой компьютер или сеть отправляет автоматические запросы?

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

Это может произойти по нескольким причинам:

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

Чтобы устранить эти проблемы, ознакомьтесь со статьей о необычном трафике или повторите попытку позже.

Какие названия действий допустимы?

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