Настройка кастомных страниц

На вкладке Кастомные страницы вы можете изменить служебные страницы, которые пользователи вашего сайта видят во время проверок или при блокировке. Это позволяет стилизовать стандартные служебные страницы DDoS-Guard, чтобы они воспринимались как часть защищаемого сайта.

Вкладка Кастомные страницы, видны страницы CAPTCHA, Геоблокировка, IP в черном списке, JS challenge

Доступна кастомизация страниц:

  • JS challenge — страница проверки, которая позволяет отличить браузер настоящего пользователя от браузера бота
  • CAPTCHA — страница с CAPTCHA для тех случаев, когда не удалось однозначно определить подлинность посетителя
  • Геоблокировка — для пользователей, заблокированных по правилу геоблокировки
  • IP в черном списке — для пользователей, чей IP-адрес находится в черном списке

Чтобы изменить страниц, нажмите Изменить у нужной страницы. Создайте и загрузите HTML-страницу, которая соответствует требованиям к файлам. Самый простой способ это сделать — скачать () стандартную страницу и использовать ее как образец для создания брендированной версии.

Вкладка Кастомные страницы, модальное окно Изменение страницы

Чтобы проверить соответствие стандартам W3C, воспользуйтесь W3C Markup Validation Service

После загрузки кастомной страницы она будет доступна в разделе Шаблоны, наряду со стандартной версией. Чтобы начать использовать ее для своего сайта, нажмите Сохранить.

Вкладка Кастомные страницы, модальное окно Изменение страницы. В список шаблонов добавлена пользовательская страница CAPTCHA

Одновременно может быть добавлен только один пользовательский шаблон. Чтобы изменить кастомную страницу, удалите ее из списка шаблонов и загрузите обновленную версию

 

Рассмотрим подробнее некоторые особенности создания кастомных страниц.

Request ID

На каждой служебной странице по умолчанию предусмотрен блок с Request ID и другими данными о запросе. Это позволяет по скриншоту служебной страницы понять, когда и какому пользователю она была показана.

Мы настоятельно рекомендуем использовать Request ID на всех ваших кастомных страницах. Чтобы сделать это, добавьте в любое место страницы ключ

 <!--REQUEST_ID_PLACEHOLDER-->

При показе кастомной страницы пользователю, вместо ключа появится текст с информацией о запросе:

Request ID: qPOmwoDhWGsOCVvt  |  IP: 192.0.2.38  |   Time: 2024-10-16 13:15:23 UTC

 

CAPTCHA

На кастомной странице CAPTCHA обязательно должен быть расположен ключ для самой CAPTCHA:

 <!--CAPTCHA_PLACEHOLDER-->

Пользователь увидит CAPTCHA в том месте, где вы разместите ключ.

 

Атрибуты data-ddg-origin и data-ddg-l10n

В теге <body> каждой служебной страницы задаются data-атрибуты, которые определяют, будет ли контент в тегах с определенными id или классом заменяться на динамические значения. Доступны data-атрибуты:

  • data-ddg-origin — если true, любой тег с class="ddg-origin" или id="ddg-origin"будет заменен на текст с названием домена, к которому пользователь делает запрос. 

    Пример:
    <h1 id="ddg-l10n-title">Checking your browser before accessing <span class="ddg-origin"></span></h1>
    Checking your browser before accessing example.com
  • data-ddg-l10n — если true, любой тег с id="ddg-l10n-..." будет заменен на стандартный текст DDoS-Guard. Чтобы узнать, для каких id есть тексты, изучите стандартный шаблон страницы. Обычно это id="ddg-l10n-title"(заголовок страницы), id="ddg-l10n-description" (описание под заголовком) и id="ddg-l10n-link-text" (текст со ссылкой на сайт DDoS-Guard). 

    Пример:
    <p id="ddg-l10n-description"> any text here </p>
    Please wait a few seconds. Once this check is complete, the website will open automatically

    Стандартные тексты уникальны для каждого типа кастомной страницы и написаны на трех языках: русском, английском и испанском. Пользователю будет показан текст на том языке, который выбран у него в браузере.

Когда вы скачиваете шаблон кастомной страницы, все data-атрибуты в нем по умолчанию выключены, то есть имеют значение false