Страница OTP templates перечисляет сообщения, в которых auth отправляет одноразовый код или временный пароль. Сначала выберите тенант в боковой панели: шаблоны принадлежат ему. У каждого шаблона по одному тексту на каждый активный язык.
Перед началом
| Что нужно | Разрешение |
|---|---|
| Открыть страницу | security:read |
| Создавать, менять и удалять шаблоны | security:manage |
Без security:manage страница доступна только для чтения: кнопки + Create Template, кнопки Edit и действий удаления нет. Языки берутся из карточки Locales в System settings; текст нужен только для активных языков.
Список
В таблице одна строка на шаблон, колонки Template (ID), Type, Channel и Languages. Поиск сопоставляется с ID шаблона. Фильтры сужают таблицу по типу (OTP, Password), по каналу (SMS, Email) или до шаблонов, у которых нет текста для активного языка (Missing translations). В меню строки есть Open, Copy template ID и Delete template. Выбор строки открывает боковую панель шаблона.
| Колонка | Значение |
|---|---|
| Type | OTP (одноразовый код) или Password (временный пароль, который уходит, когда администратор сбрасывает пароль пользователя). |
| Channel | SMS или Email. |
| Languages | У каких активных языков есть текст. |
Шаблон определяют вместе ID, тип и канал, поэтому у одного ID могут быть SMS- и email-версия или версии OTP и password. Панель перечисляет их в Other variants. Клиент выбирает шаблон OTP по ID в блоке OTP Settings (OTP Template и OTP channel, см. Клиент). Шаблон password ищется только по каналу: auth берет единственный шаблон password выбранного администратором канала, какой бы у него ни был ID.
Панель шаблона
В панели:
- Message — по записи на язык. SMS показано обычным текстом; тело письма показано так, как его увидит получатель, в изолированном фрейме. Edit карточки открывает редактор сообщения.
- Fixed — ID, тип и канал: они входят в ключ шаблона и не меняются. Чтобы изменить одно из них, создайте новый шаблон и удалите старый.
- Other variants, если такой же ID есть для другого типа или канала.
- Delete template с подтверждением.
Предупреждение вверху панели, Missing translations for …, появляется, когда у активного языка нет текста. Edit Message добавляет его.
Create a template
+ Create Template открывает боковую панель в режиме создания.
| Поле | Правила |
|---|---|
| Template ID | Обязательное. Строчные буквы, цифры, подчеркивания и дефисы, первая — буква. По нему клиенты ссылаются на шаблон. |
| Type | OTP или Password. |
| Channel | SMS или Email. SMS — обычный текст. Email-шаблон должен содержать корректный HTML и пишется в редакторе кода, для каждого языка есть переключатель Preview. |
| Message | По одному тексту на каждый активный язык. |
Плейсхолдеры проверяются при сохранении, в консоли и еще раз в Central:
| Тип | Обязательные плейсхолдеры | Другие плейсхолдеры |
|---|---|---|
otp | {{code}} | {{appName}} заменяется именем клиента на языке пользователя. |
password | {{password}} и {{expiresHours}} | нет |
Текст auth выбирает так: сначала UI-локали пользователя, затем локаль по умолчанию, затем любая доступная локализация.
Delete a template
Delete template удаляет шаблон для его типа и канала после подтверждения. Central не проверяет, пользуется ли им еще какой-нибудь клиент. Если у клиента указан ID, для которого нет шаблона его канала, отправлять нечего, поэтому сначала смените OTP Template у клиента, а потом удаляйте старый шаблон.
Что дальше
- Security — длина кода и интервал повторной отправки
- System settings — включение языков, на которых пишутся тексты
- Клиент — выбор шаблона клиента