ui_config — именованный набор настроек окна входа, принадлежащий проекту. Он задаёт
брендинг и поведение потока; приложение не описывает эти настройки у себя, а называет код нужного
набора.
Кто что делает
- владелец проекта заводит наборы и даёт им коды — динамически, в Console;
- приложению назначаются набор по умолчанию и список разрешённых кодов; код вне этого списка передать нельзя.
Что набор задаёт
- какие каналы показывать и как — все сразу или один (
ChannelDisplayMode); - как несколько каналов делят окно — вкладками или рядом (
channel_layout); - на каких устройствах показываются кнопки каналов (
channel_button); - есть ли кнопка отмены: «Отменить вход» в окне входа или «Отменить подтверждение» на странице,
открывающей подтверждение (
cancel); - шаблон оформления окна;
- поведение после подтверждения: что происходит с окном и продолжается ли поток автоматически;
- текст подтверждения;
- формулировки отдельных элементов страницы — поле
texts; - цвета кнопок отдельных каналов — поле
channel_button_colors.
texts переформулирует встроенные тексты окна входа и других страниц, которые показывает Veriqa, для
приложений, выбравших этот набор. Ключ записи — английский текст элемента; значение — ключ-замена,
который проходит через locale-файлы, или готовые тексты по языкам мимо них:
texts не переформулируется. Страница возврата в приложение
после успешного входа texts набора не читает — её тексты задавайте для приложения. Какие тексты открыты и что происходит с
неподходящей записью — в Своей формулировке элемента страницы.
Через channel_layout, channel_button и cancel набор задаёт свою часть трёх настроек окна входа:
channel_layout—Tabs(по умолчанию) илиGrid: все каналы на экране сразу, каждый со своим QR-кодом. См. Раскладку каналов.channel_button.show_channel_button—Always(по умолчанию),MobileOnlyилиNever. Значение, которое вместе с видимостью QR-кода оставило бы устройство без QR-кода и без кнопки, не применяется: кнопки тогда показываются на любом устройстве. См. Видимость кнопок каналов.cancel.enabled—trueилиfalse. Кнопка включена, пока какой-нибудь уровень её не выключит; в окне входа нажатие возвращает пользователя в приложение сerror=access_denied, а на странице, открывающей подтверждение, отклоняет его и показывает квитанцию отказа. См. Кнопку отмены.
Порядок разрешения
Итоговое значение любой настройки собирается по цепочке — от самой частной к самой общей:Итог определяет сервер при обработке
/connect/authorize, а не то, что вернул
bootstrap. Bootstrap показывает, что включено в проекте; итоговый вид
окна определяется в момент запроса.