> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Кастомный домен для KYC-верификации: настройка DNS

> В Didit можно открыть верификацию с собственного поддомена вместо verify.didit.me: добавьте домен, создайте две DNS-записи и подтвердите владение.

Серверы верификации работают на вашем собственном поддомене, например `verify.yourbrand.com` вместо `verify.didit.me`. Пользователи остаются на вашем домене на протяжении всего процесса, и это убирает последнее видимое упоминание Didit в сценарии [White label](https://docs.didit.me/ru/console/white-label.md).

> [!NOTE]
>
> Собственный домен входит в White label и доступен на тарифах **Scale** и **Enterprise**. Также нужен **доступ на запись к Customization**: участники с доступом только на чтение видят этот раздел недоступным.

> [!NOTE]
>
> Когда ваша организация переходит с тарифа Scale или Enterprise, в том числе когда пробный период Scale завершается без платного тарифа, ее собственный домен удаляется, а новые ссылки на верификацию снова используют домен Didit. Собственный домен, подключенный до 1 ноября 2026 года, сохраняется на любом тарифе. Если вы его удалите, чтобы добавить собственный домен снова, потребуется тариф Scale или Enterprise.

> [!NOTE]
>
> Собственные домены доступны только для **live-приложений**. Приложение в [песочнице](https://docs.didit.me/ru/integration/sandbox-testing.md) не может добавить такой домен, а сессии в песочнице всегда работают на стандартном размещенном домене верификации. Чтобы настроить домен, переключитесь на live-приложение в Business Console.

***

## Требования

| Требование | Описание |
| - | - |
| **Live-приложение** | Домен принадлежит live-приложению. Приложения в песочнице не могут настроить собственный домен. |
| **Только поддомен** | Используйте `verify.yourbrand.com`. Корневые домены, такие как `yourbrand.com`, отклоняются, как и префикс `www.`. |
| **Не используется** | Поддомен не может указывать на ваш существующий веб-сайт или приложение. |
| **Доступ к DNS** | Вам нужно создать две записи у вашего DNS-провайдера. |

***

## Как это работает

Вы вводите свой поддомен в Business Console. Затем Didit создает две DNS-записи, которые вы добавляете у своего провайдера:

| Запись | Назначение |
| - | - |
| **CNAME для проверки** | Подтверждает, что домен принадлежит вам, и на его основе выпускается SSL-сертификат. |
| **CloudFront CNAME** | Направляет ваш поддомен на интерфейс верификации. |

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

***

## Настройка домена

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

Перейдите в **Customization > Domain**, введите свой поддомен (например, `verify.yourbrand.com`) и нажмите **Добавить домен**.

Консоль создаст DNS-записи. Это займет несколько секунд.

**2. Скопируйте две записи**

Консоль показывает карточку для каждой записи: **CNAME для проверки** и **CloudFront CNAME**. Каждая карточка содержит два значения:

| Поле карточки | Куда вставить у DNS-провайдера |
| - | - |
| **Имя хоста** | Имя записи (host) |
| **Данные/URL** | Значение записи (target) |

> [!WARNING]
>
> Не меняйте местами **Имя хоста** и **Данные/URL** при вставке в DNS-провайдер и копируйте каждое значение кнопкой копирования. Проверочные значения длинные, и их легко ошибочно набрать.

**3. Добавьте обе записи у DNS-провайдера**

Создайте обе записи типа `CNAME`. Добавление только записи CloudFront — самая частая причина, по которой проверка позже не проходит.

Установите TTL `300`, чтобы любые последующие исправления распространялись за минуты, а не за часы.

**4. Подтвердите владение**

Вернитесь в консоль и нажмите **Подтвердить домен**. При успехе панель меняется на **Домен подтвержден**, и кнопка исчезает.

Если проверка не удалась, консоль покажет блок **Проверка не удалась** с конкретной причиной. Прочитайте его, прежде чем что-либо менять: в нем указано, какая запись отсутствует или неверна.

> [!NOTE]
>
> DNS обычно распространяется за несколько минут, но это может занять до **24–48 часов**. Если консоль показывает **Обнаружены изменения DNS**, ваши записи верны, распространение еще не завершено, и никаких действий не требуется.

***

## Изменение или удаление домена

Чтобы перенести сценарий на другой поддомен, введите новый и нажмите **Обновить домен**. Didit выпустит новую пару записей, поэтому их нужно добавить у DNS-провайдера и подтвердить заново.

Чтобы вернуться к `verify.didit.me`, очистите поле и нажмите **Удалить домен**.

> [!NOTE]
>
> Пока настроен собственный домен, нельзя снова включить экран входа Didit. Сначала удалите домен.

***

## Устранение неполадок

> [accordion] Ошибка 500 или сообщение о другом дистрибутиве CloudFront
>
> Для вашего поддомена есть запись `A`, которая конфликтует с CNAME. Хост не может иметь обе записи одновременно. Удалите запись `A` и оставьте только CNAME.
>
> Если записи `A` нет, CNAME для CloudFront указывает на неверный адрес. Сверьте его посимвольно со значением **Данные/URL** в консоли.

> [accordion] Проверка никогда не завершается успешно
>
> Убедитесь, что **обе** записи есть у вашего DNS-провайдера. Чаще всего проблема в том, что добавлена только запись CloudFront: процесс, по-видимому, запускается, но сертификат так и не выпускается.
>
> Блок **Проверка не удалась** в консоли показывает, какая запись отсутствует или указана неверно.

> [accordion] Сертификат не выпускается (Cloudflare)
>
> Переведите обе записи в режим **Только DNS**, то есть в серое облако с отключённым прокси. Оранжевое облако, то есть включённый прокси, перехватывает запрос и мешает выпуску сертификата.
>
> Провайдеры без переключателя прокси, например cPanel, этой проблемы не затронуты.

> [accordion] Имя записи дублируется
>
> Некоторые провайдеры автоматически добавляют имя вашей зоны, и тогда `verify.yourbrand.com` превращается в `verify.yourbrand.com.yourbrand.com`.
>
> У таких провайдеров вводите **относительное** имя, а не полное, которое показывает консоль: `verify` вместо `verify.yourbrand.com` и `_abc123.verify` вместо `_abc123.verify.yourbrand.com`. Затем откройте сохранённую запись и проверьте, что полное имя, которое она хранит, точно совпадает с **Имя хоста** в консоли.

> [accordion] Исправление применяется несколько часов
>
> Ваши записи кэшируются на время их TTL. Уменьшите TTL до `300` и дождитесь истечения предыдущего значения, прежде чем проверять снова.

***

## Дальнейшие шаги

* **Приведите остальной интерфейс в соответствие с вашим брендом**: цвета, логотип и типографика настраиваются в разделе [Кастомизация](https://docs.didit.me/ru/console/white-label.md).
* **Включайте свой стиль для каждого сценария**: брендинг применяется только к сценариям, для которых включена опция **Включить пользовательский стиль**. См. [White label](https://docs.didit.me/ru/console/white-label.md#активация-пользовательского-стиля-в-сценарии).
* **Проверьте свои обязанности по раскрытию информации**: пользовательский домен скрывает брендинг Didit, но не его роль. См. [обязанности по соблюдению требований](https://docs.didit.me/ru/console/white-label.md#обязанности-по-соблюдению-требований-в-потоках-white-label).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.