Перейти к основному содержанию
ui_config — именованный набор настроек окна входа, принадлежащий проекту. Он задаёт брендинг и поведение потока; приложение не описывает эти настройки у себя, а называет код нужного набора.

Кто что делает

  • владелец проекта заводит наборы и даёт им коды — динамически, в Console;
  • приложению назначаются набор по умолчанию и список разрешённых кодов; код вне этого списка передать нельзя.
Приложение выбирает набор параметром authorize-запроса:
Параметр опциональный. Не передан — применяется набор по умолчанию для этого приложения.

Что набор задаёт

  • какие каналы показывать и как — все сразу или один (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, а на странице, открывающей подтверждение, отклоняет его и показывает квитанцию отказа. См. Кнопку отмены.
Поле, которого в наборе нет, ничего не задаёт: значение берётся у приложения, проекта или ядра.
Частая ошибка — ожидать, что ui_config задаёт режим подтверждения входа и режим аудита. Он их не задаёт: это политики владельца развёртывания, и через набор настроек окна они не переопределяются.

Порядок разрешения

Итоговое значение любой настройки собирается по цепочке — от самой частной к самой общей:
Побеждает первый уровень, где значение задано и разрешено. Более частный уровень может только сузить то, что разрешил более общий: защитные настройки задают потолок, а не подсказку. Это ответ на вопрос «почему я вижу не то, что настроил»: скорее всего, значение задано на более частном уровне либо срезано потолком на более общем.
Итог определяет сервер при обработке /connect/authorize, а не то, что вернул bootstrap. Bootstrap показывает, что включено в проекте; итоговый вид окна определяется в момент запроса.

Чего нет

Список разрешённых кодов ui_config машинно получить неоткуда: в ответе bootstrap его нет, хотя /connect/authorize проверяет код по списку разрешённых. Уточняйте его у владельца проекта или смотрите в Console.