Плагин Google reCaptcha Enterprise Plugin v1.0.0

Плагин Google reCaptcha Enterprise защищает ваш сайт объявлений Osclass с помощью сервисов Google reCaptcha Enterprise — текущей лучшей платформы Google для защиты от ботов. Это естественное обновление для сайтов, которые уже используют классическую reCaptcha v3, Invisible reCaptcha или более старые плагины Google с флажками, но нуждаются в более надежном анализе рисков, более понятной отчетности и перспективной интеграции.

Защита основана на баллах и является невидимой. Реальные посетители заполняют ваши формы, не решая головоломки с изображениями. Каждая отправленная форма анализируется в фоновом режиме и проверяется на сервере через API Enterprise Assessment. Вы можете регулировать уровень защиты с помощью настраиваемого порогового значения баллов, а встроенный журнал проверки показывает, что прошло успешно, что не прошло и по какой причине.

Почему стоит использовать корпоративную версию reCaptcha вместо устаревшей?​

• Ведущая платформа — Google позиционирует reCaptcha Enterprise как текущий производственный стандарт, постоянно инвестируя в его совершенствование и улучшение API.
• Оценка рисков — каждая оценка выдает балл от 0,0 (вероятно, бот) до 1,0 (вероятно, человек), а не просто «прошел/не прошел» — все данные регистрируются в административной панели.
• Улучшенная прозрачность — в журнале проверки сохраняются оценка, название действия, имя хоста и подробная информация об ошибке для каждой попытки.
• Защита на основе действий — разделение действий Google для каждой формы (регистрация, контакт, вход и т. д.) для более точной аналитики в Google Cloud.
• Плавная миграция — тот же незаметный интерфейс, которого пользователи ожидают от reCaptcha v3, с проверкой на сервере корпоративного уровня.

Защита от спама для всех важных форм Osclass​

В Osclass функцию reCaptcha можно включить отдельно для каждой формы:

• Регистрационная форма
• Форма входа
• Новая форма для комментариев
• Форма обратной связи по товару
• Форма отправки другу
• Форма обратной связи на сайте (страница контактов)
• Форма для добавления товара (публикация объявления)

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

Функции пользовательского интерфейса​

• Невидимая проверка на основе баллов — обычным посетителям не нужно ставить галочки в соответствующем поле.
• Небольшой значок Google (внизу справа, внизу слева или прямо внутри формы).
• Совместимо с Sigma и другими темами, использующими jQuery. Проверка данных в контактных формах и формах авторизации.
• Возможность скрыть reCaptcha для авторизованных веб-пользователей (администраторы по-прежнему могут проверять данные, находясь в административной панели).
• Дополнительная загрузка глобального скрипта, если на странице отсутствует защищенная форма.

Подробная информация о системе оценки и политике.​

• Регулируемый пороговый балл (по умолчанию 0,5) — повышение значения делает проверку более строгой, понижение — уменьшает количество ложных срабатываний.
• Названия действий Google для каждой формы обеспечивают более понятную отчетность в Google Cloud и в журнале плагина.
• Проверка на стороне сервера осуществляется через API reCaptcha Enterprise (а не через устаревший сервис проверки секретных ключей siteverify).

Журнал проверки с диаграммой​

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

• Название формы, результат (успех/неудача) и коды ошибок.
• Оценка риска и действия Google, возвращенные предприятием.
• IP-адрес и имя хоста посетителя
• Дата и время каждой проверки
• Поиск, фильтры и пагинация в административной панели.
• Гистограмма с указанием успешных и неудачных проверок за последние 30 дней.

Старые записи удаляются автоматически с помощью ежедневного cron-запроса. Срок хранения можно настроить в месяцах.

Поддержка пользовательских форм​

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

<?php osc_run_hook('googlev3_recaptcha'); ?>

и проверьте отправку данных в вашем коде обработки с помощью:

gvr_verify_form('my_form_name', 'my_google_action');

Функции административной панели​

• Страница настроек с ключом сайта, идентификатором проекта, ключом API, пороговым значением оценки и положением значка.
• Отдельный переключатель для каждой формы Osclass, а также пользовательские строки для перехвата событий.
• Встроенная панель тестирования — запустите оценку корпоративного уровня в режиме реального времени из административной панели и проверьте оценку, действия и ответ API.
• Пошаговое руководство по настройке консоли Google Cloud (включение API, создание ключа оценки, ограничения для ключей API).
• Режим отладки — маркер подсвечивается, и администратор видит диагностическое сообщение на каждой форме на внешнем интерфейсе.
• Журнал проверки с поиском, постраничной навигацией и 30-дневным графиком.

Простая настройка​

1. Создайте или выберите проект Google Cloud и включите API reCaptcha Enterprise.
2. Создайте ключ на основе оценки (v3) для веб-сайта в Google Cloud > Безопасность > reCaptcha
3. Создайте ключ API Google Cloud, доступный только для API reCaptcha Enterprise.
4. Скопируйте ключ сайта, идентификатор проекта и ключ API в настройки плагина.
5. Отключите встроенную функцию Osclass reCaptcha, чтобы избежать конфликтов.
6. Установите пороговое значение баллов, выберите положение значка, включите формы и сохраните.
7. Запустите тестовую панель управления, затем отправьте реальную форму и проверьте журнал верификации.

Путь обновления с более старых плагинов reCaptcha​

Если вы уже используете плагин Invisible reCaptcha, классический reCaptcha v3 или checkbox на Osclass, этот плагин сохраняет тот же практический рабочий процесс: интеграция форм на основе хуков, невидимый пользовательский интерфейс и переключатели для каждой формы. Разница заключается в проверке на корпоративном сервере, оценке рисков в вашем журнале и соответствии текущей платформе Google. Устаревшие секретные ключи со старых страниц администрирования reCaptcha не используются — вместо этого вы настраиваете корпоративные учетные данные из Google Cloud.

Краткое содержание​

Плагин Google reCaptcha Enterprise — это идеальная защита от спама для объявлений на Osclass. Он внедряет высококачественную reCaptcha от Google на основе оценок в процессы регистрации, связи и размещения объявлений, предоставляет администраторам полную прозрачность благодаря журналам проверки с оценками и обновляет старые интеграции reCaptcha без изменения тем оформления на стандартных темах Osclass.