Документация по подключению

1. Добавить домен

В личном кабинете откройте раздел «Домены» и нажмите «Добавить домен». Укажите домен и IP-адрес сервера, на котором работает сайт. Мы сразу проверим, не раскрыт ли адрес сервера в истории DNS, поддоменах и заголовках писем, и покажем результат.

2. Проверить владение доменом

Добавьте TXT-запись, которую покажет личный кабинет, в DNS домена. Это подтверждает, что домен принадлежит вам, и защищает от подключения чужих сайтов.

_ddos-protect.example.ru.  TXT  "ddp-verify=4f1c…"

3. Направить трафик через фильтр

Замените A-записи домена (и www) на адреса узлов фильтрации из личного кабинета. Срок обновления зависит от TTL записей: обычно от нескольких минут до часа. Чтобы переключение прошло быстрее, заранее уменьшите TTL до 300 секунд.

4. Сертификат HTTPS

После того как DNS указывает на узлы фильтрации, сертификат для домена выпускается автоматически. Если нужно использовать свой сертификат — например, EV или выданный российским удостоверяющим центром, — загрузите его в разделе «Сертификаты».

5. Режим наблюдения

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

6. Исключения

• Вебхуки платёжных систем и служб доставки — по пути и адресам отправителя.
• Обмен с 1С, CRM, складскими системами — по адресу сервера интеграции.
• Мониторинг доступности — по адресам сервиса мониторинга.
• Мобильное приложение — по секретному заголовку или подписи запросов.

7. Закрыть прямой доступ к серверу

Разрешите входящие подключения на порты 80 и 443 только с адресов узлов фильтрации. Подробная инструкция — в руководстве как скрыть IP сервера.

8. Реальный IP посетителя

Фильтр передаёт адрес посетителя в заголовке X-Forwarded-For. Настройте веб-сервер доверять этому заголовку только от адресов фильтра: nginx, Apache.

9. Включить защиту

Переключите режим домена с «Наблюдения» на «Защиту». Начните с мягкого режима; строгий включается автоматически во время атаки.

API

Статистика, журналы, сброс кэша и управление правилами доступны через REST API с ключом из раздела «Настройки». Пример запроса статистики:

curl -H "Authorization: Bearer $DDP_KEY" \
  "https://ddos-protect.ru/api/v1/domains/example.ru/stats?from=2026-10-01&to=2026-10-07"