> ## 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.

# Брендированная страница входа, письма и собственный домен аутентификации

> Настройте страницы входа и письма Didit под свой бренд: тексты на пяти языках, ссылки на условия и политику и собственный домен для входа.

Didit Authentication использует ваш бренд на размещённых страницах входа и в письмах для входа. Это тот же бренд, что и в сценарии верификации.

Тексты страниц и юридические ссылки для Authentication задаются. Вход также можно перенести на ваш домен, например `auth.example.com`.

Настройки находятся в консоли: **Authentication > Branding and emails**. Там отображается предпросмотр размещённой страницы входа в реальном времени в светлой и тёмной теме.

![Страница Branding and emails в Didit Business Console для песочницы: бренд из Customization, тексты страниц и предпросмотр размещённой страницы](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-branding.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=9653e0d5b5556cec809139cfa6eaf055)

Authentication > Branding and emails, с предпросмотром размещённой страницы.

## Ваш бренд

Логотип, фирменный цвет, фон, радиус скругления и шрифт берутся из настроек **Customization** вашего приложения в консоли, и размещённые страницы и письма следуют этим настройкам.
Чтобы изменить их, выберите **Edit in Customization**: одно изменение сразу обновляет сценарий верификации и страницы входа.

* Страницы следуют светлой или тёмной теме устройства пользователя, а фирменный цвет адаптируется для тёмного фона.
* Страницы показывают название вашего приложения.
* На тарифе Free размещённые страницы показывают значок **Secured by Didit**.

![Размещённая страница входа Didit для приложения в песочнице в светлой и тёмной темах, с кнопкой passkey и полями для адреса электронной почты и пароля](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/hosted-sign-in-light-dark.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=835219dfc253b7bfcb830255aff8ff93)

Размещённая страница входа следует светлой или тёмной теме устройства пользователя.

## Тексты страницы и юридические ссылки

| Поле | Лимит | Где отображается |
| - | - | - |
| **Заголовок входа** | 120 символов | Заголовок страницы входа. |
| **Подзаголовок** | 160 символов | Строка под заголовком. |
| **Заголовок регистрации** | 120 символов | Заголовок страницы регистрации. |
| **URL условий использования** | 500 символов | Ссылка на страницах. Если задана, форма регистрации просит пользователя принять ваши условия. |
| **URL политики конфиденциальности** | 500 символов | Ссылка на страницах рядом с вашими условиями. |

Размещённые страницы переведены на английский, испанский, французский, немецкий и японский языки. Язык выбирается по языку браузера пользователя или по параметру `ui_locales` в URL страницы входа.
Задавайте свои тексты для каждого языка: для языка без вашего текста используется переведённый текст Didit по умолчанию.

Через API `PATCH branding/` в [API управления аутентификацией](https://docs.didit.me/ru/authentication/set-up-by-api.md) задаются те же поля:

```bash theme={null}
curl --fail-with-body --request PATCH "${MANAGEMENT_BASE}branding/" \
  -H "x-api-key: $DIDIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "texts": {
      "en": {"sign_in_title": "Welcome back", "subtitle": "Sign in to manage your account.", "sign_up_title": "Open your account"},
      "es": {"sign_in_title": "Hola de nuevo"}
    },
    "terms_url": "https://example.com/legal/terms",
    "privacy_url": "https://example.com/legal/privacy"
  }'
```

Текст, отправленный пустым, возвращается к значению по умолчанию.

## Письма для входа

Вкладка «Письма» в разделе **Branding and emails** показывает письма для входа вашего приложения, предпросмотр каждого письма и кнопку **Send a test**:

| Письмо | Когда отправляется |
| - | - |
| Код по электронной почте | Пользователь входит или регистрируется с помощью кода, отправленного на электронную почту. |
| Магическая ссылка | Пользователь запрашивает ссылку для входа. |
| Сброс пароля | Пользователь начинает [восстановление пароля](https://docs.didit.me/ru/authentication/sign-in-methods.md#забытый-пароль-и-сброс-пароля). |
| Вход с нового устройства | Пользователь входит с нового устройства. |
| Приглашение | Вы приглашаете пользователя зарегистрироваться при политике регистрации `invited`. |
| Приглашение в организацию | Вы приглашаете пользователя в одну из ваших [организаций](https://docs.didit.me/ru/authentication/organizations.md#приглашения). |
| Агент одобрен, Доступ агента завершён | У [ИИ-агента](https://docs.didit.me/ru/authentication/agent-access.md) пользователя появляется доступ или он его теряет. |

Для вашего приложения каждое письмо отмечено как **On** или **Off**.
Письма отправляются с вашего подтверждённого домена электронной почты, если вы настроили его в разделе Customization. В остальных случаях они отправляются с адреса `Didit <no-reply@didit.me>`.

## Собственный домен

По умолчанию пользователи входят в ваше приложение на `https://<slug>.auth.didit.me`.
Собственный домен переносит размещённые страницы, API среды выполнения и издателя токенов на поддомен вашего домена, например `auth.example.com`.
Собственные домены предназначены для рабочих приложений: приложение в песочнице всегда выполняет вход на домен Didit.

> [!WARNING]
>
> Ключи доступа привязаны к домену, на котором пользователи входят.
> Активация собственного домена означает, что существующие ключи доступа нужно зарегистрировать заново, поэтому добавьте свой домен до того, как пользователи начнут добавлять ключи доступа.

### Настройка

1. В разделе **Custom domain** введите **Your domain**, например `auth.example.com`, и выберите **Add domain**. Используйте поддомен: CNAME-запись не может находиться в корне вашего домена.
2. Создайте DNS-запись, которую показывает консоль: `CNAME` с вашего домена на хост вашего приложения в Didit.
3. Выберите **Check DNS now**. Новая запись может появиться в течение часа. Как только Didit её найдёт, он выпустит сертификат для вашего домена, который будет продлеваться автоматически.
4. Когда у домена появится статус **Verified**, выберите **Use this domain**, чтобы сделать его доменом для входа вашего приложения.

| Статус | Значение |
| - | - |
| Waiting for DNS | Didit пока не нашёл запись `CNAME`. |
| Issuing certificate | Запись есть, и сертификат выпускается. |
| Verified | Ваш домен отдаёт размещённые страницы. Он не является доменом для входа, пока вы его не активируете. |
| Active | Ваш домен является доменом для входа и издателем токенов. |
| Not found | Проверка не удалась. Исправьте запись и проверьте снова. |

Через API `PUT domain/` с `{"domain": "auth.example.com"}` добавляет домен, `POST domain/verify/` проверяет его, `POST domain/activate/` активирует его, а `DELETE domain/` удаляет его.

### Что меняется после активации

* **Издатель.** Новые токены указывают ваш домен в `iss`, а документ обнаружения и JWKS переходят на него. Обновите издателя, которого проверяет ваш бэкенд, или принимайте оба издателя, пока старые токены не истекут. См. [токены и JWKS](https://docs.didit.me/ru/authentication/tokens-and-jwks.md).
* **Публикуемый ключ.** Он кодирует издателя, поэтому меняется: скопируйте новый ключ из **Authentication > Developers** в своё приложение.
* **Сессии и токены** под старым доменом перестают действовать в течение 5 минут.
* **Ключи доступа** нужно зарегистрировать заново на новом домене.
* **URL перенаправления, настройки и пользователи, которые зарегистрировались**, остаются без изменений.

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


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