ДАРА Защита

ДАРА Защита / Как установить капчу на сайт

Инструкция

Как установить капчу на сайт

Чтобы установить капчу на сайт, нужно вставить код сервиса капчи на все страницы и проверять результат на сервере перед отправкой заявки. С ДАРА Защитой первый шаг - одна строка в head, формы находятся сами, а капчу видят только подозрительные посетители. Ниже - шаги для любого сайта и для Tilda, WordPress и 1С-Битрикс.

Из чего состоит установка капчи

Любая капча ставится в два слоя. На странице - скрипт сервиса, который проверяет посетителя перед отправкой формы. На сервере - проверка результата: без неё бот отправит заявку прямо на адрес обработчика, и капча на странице его не остановит. С ДАРА Защитой это выглядит так:

  1. Войдите в личный кабинет ДАРА Защиты через единый вход ДАРА: email и код из письма, без пароля. Если вы у нас впервые, аккаунт создастся при первом входе.
  2. Нажмите «Добавить сайт» и укажите домены: site.ru - сам сайт и www.site.ru, *.site.ru - ещё и все поддомены. Скрипт работает только на этих доменах.
  3. Скопируйте код со вкладки «Код и ключи» и вставьте его на все страницы - в <head> или перед </body>:
    <script src="https://captcha.daratech.ru/s/dz_ВАШ_КЛЮЧ.js" async></script>
  4. Подключите проверку заявок на сервере сайта (ниже) и посмотрите несколько дней в режиме «Только считать», что Защита отклонила бы.
  5. Включите боевой режим - капчу начнут видеть подозрительные посетители.

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

Как поставить капчу на Tilda

  1. Откройте «Настройки сайта» → «Вставка кода» → «HTML-код для вставки внутрь head».
  2. Вставьте код Защиты и сохраните.
  3. Переопубликуйте все страницы: без этого код на страницах не появится.

«Аналитика для людей» на Tilda работает так же, как на любом сайте. Заявки конструкторов, которые отправляются через их собственные серверы, сервер сайта проверить по API не может - проверка по API доступна, если заявки приходят на ваш сервер, например вебхуком.

Как установить капчу на WordPress

Файлы темы перезаписываются при её обновлении, поэтому добавьте код в дочернюю тему или через плагин вставки кода в head. В functions.php дочерней темы:

add_action('wp_head', function () {
    echo '<script src="https://captcha.daratech.ru/s/dz_ВАШ_КЛЮЧ.js" async></script>';
}, 1);

Формы Contact Form 7 передают поле dara_token вместе с остальными полями сами. Чтобы проверять заявку на сервере, достаточно фильтра wpcf7_spam - пример:

add_filter('wpcf7_spam', function ($spam) {
    if ($spam) { return $spam; }
    $r = wp_remote_post('https://captcha.daratech.ru/api/v1/check', [
        'timeout' => 5,
        'headers' => ['Content-Type' => 'application/json', 'Authorization' => 'Bearer ' . DARA_PROTECT_SECRET],
        'body'    => wp_json_encode([
            'token'      => $_POST['dara_token'] ?? '',
            'fields'     => $_POST,
            'ip'         => $_SERVER['REMOTE_ADDR'] ?? '',
            'user_agent' => $_SERVER['HTTP_USER_AGENT'] ?? '',
        ]),
    ]);
    $res = is_wp_error($r) ? [] : json_decode(wp_remote_retrieve_body($r), true);
    return ($res['action'] ?? 'deliver') === 'reject';   // нет ответа - заявка уходит как обычно
});

Секретный ключ dzs_… со вкладки «Код и ключи» храните в wp-config.php (константа DARA_PROTECT_SECRET) и никогда не вставляйте в код страницы. Если на сайте стоит плагин кеширования страниц, после вставки кода очистите его кеш.

Как добавить капчу на сайт 1С-Битрикс

  1. В административном разделе откройте «Настройки» → «Настройки продукта» → «Сайты» → «Шаблоны сайтов».
  2. Откройте шаблон сайта и на вкладке «Шаблон» вставьте код Защиты перед </head>. Это тот же файл header.php в каталоге шаблона - /local/templates/{шаблон}/ или /bitrix/templates/{шаблон}/.
  3. Если у сайта несколько шаблонов, например для мобильной версии или посадочных страниц, вставьте код в каждый.
  4. Сбросьте кеш: «Настройки» → «Настройки продукта» → «Автокеширование» → «Очистка файлов кеша».

Формы Битрикса передают поле dara_token вместе с остальными полями. Проверку заявки вызывает обработчик формы на сервере перед сохранением или отправкой письма - запрос тот же, что в примере на PHP в документации API.

Другие сайты и формы на JavaScript

Вставьте код в общий шаблон, из которого собирается head всех страниц. Если форма отправляется своим кодом (fetch, XMLHttpRequest), получите токен перед отправкой:

const token = await DaraProtect.token();   // при необходимости покажет капчу
if (token === null) return;                 // посетитель закрыл капчу - не отправляем
body.dara_token = token;

Чтобы скрипт не трогал какую-то форму, добавьте ей атрибут data-dara="off"; какие формы защищать - все, по CSS-селектору или все, кроме, - выбирается на вкладке «Защита форм». Формы поиска без полей для текста, email и телефона скрипт пропускает сам. Подробно - в разделе Защита форм.

Проверка заявки на сервере

Сервер сайта отправляет заявку на POST https://captcha.daratech.ru/api/v1/check с секретным ключом в заголовке Authorization: Bearer: токен из поля dara_token, все поля формы, IP и User-Agent посетителя. В ответе action: deliver - отправлять дальше, reject - не отправлять, заявка уже в журнале Защиты. Если Защита не ответила за несколько секунд, отправляйте заявку как обычно с пометкой «не проверено» - терять настоящие заявки из-за нашего сбоя нельзя.

Как проверить установку

  • Откройте сайт - на вкладке «Обзор» в кабинете появятся визиты.
  • В консоли браузера вызовите DaraProtect.challenge() - он покажет пазл без подозрения; DaraProtect.version покажет версию скрипта.
  • Если сайт отдаёт заголовок CSP, разрешите captcha.daratech.ru в script-src и connect-src и data: в img-src.

Новый сайт начинает в режиме «Только считать», поэтому сразу после установки посетители капчу не увидят - так и задумано (режимы и запуск без риска). Зачем ставить капчу, которая видна не всем, - на странице «Капча для сайта бесплатно»; если вы переходите с Google или Яндекса - «Альтернатива reCAPTCHA и Яндекс SmartCaptcha».

Частые вопросы

Не нашли ответ — спросите в разделе «Поддержка» личного кабинета.

Как проверить, что капча работает?

Откройте сайт: на вкладке «Обзор» в кабинете появятся визиты. Чтобы увидеть сам пазл, вызовите в консоли браузера DaraProtect.challenge() - он показывает капчу без подозрения. В режиме «Только считать» обычным посетителям капча не показывается.

Нужно ли менять код форм?

Обычно нет. Скрипт сам находит формы, в том числе появившиеся позже, и добавляет скрытые поля. Формам, которые отправляются своим кодом на JavaScript, нужен один вызов DaraProtect.token() перед отправкой.

Какая капча лучше для сайта - видимая или невидимая?

Капча, которую видят все, отнимает время у каждого посетителя. Умная капча показывается только тем, кто похож на бота: люди отправляют форму сразу. Ботов, которые отправляют заявки мимо страницы, капча не видит вообще - их ловит проверка заявки на сервере.

Что делать, если на сайте настроена CSP?

Разрешите captcha.daratech.ru в script-src и connect-src и data: в img-src - картинки капчи приходят как data-адреса. Для «Аналитики для людей» добавьте и адреса самих счётчиков.

Другие решения

Капча для сайта бесплатно

Бесплатная капча для сайта: пазл-слайдер видят только подозрительные посетители, люди отправляют формы без проверки. Одна строка кода, данные в России.

Подробнее →

Защита форм от спама

Как защитить формы сайта от спама: капча только для ботов, ловушка и проверка заявок по API — ссылки, стоп-слова, одноразовая почта и номера по реестру Минцифры.

Подробнее →

Защита сайта от ботов

Как защитить сайт от ботов: оценка каждого визита от 0 до 100, капча только для подозрительных, проверка заявок по API и Метрика без роботов. Бесплатно.

Подробнее →