Authorization details — Versola Docs
/docs
До 1.00.7.5versola.ioGitHub

Authorization details

Справочник по странице Authorization details консоли администратора — регистрация типов authorization_details по RFC 9396, которые могут запрашивать клиенты тенанта

Страница Authorization details регистрирует типы authorization_details по RFC 9396, которые могут запрашивать клиенты тенанта. Сначала выберите тенант в боковой панели: типы принадлежат ему. Объект зарегистрированного типа отклоняется, если не проходит схему этого типа.

Перед началом

Что нужноРазрешение
Открыть страницуsecurity:read
Создавать, менять и удалять типыsecurity:manage

Без security:manage страница доступна только для чтения: кнопки + Create Type, кнопок Edit и действий удаления нет.

Список

Authorization details, список
Страница Authorization details: поле поиска и таблица зарегистрированных типов с описанием и ID типа, сводкой схемы и языками, на которых есть описание.

Строка показывает описание типа с его ID, сводку схемы и, если в развертывании есть активные языки, у каких из них есть описание. Поиск сопоставляется с типом или описанием. В меню строки есть Open, Copy type и Delete type. Выбор строки открывает боковую панель типа.

Панель типа

Тип в боковой панели
Боковая панель типа payment_initiation: карточка General с описанием, карточка JSON Schema со схемой в виде редактора кода и карточка Fixed с типом.

В панели три карточки и действие удаления:

  • General — Description, с Edit.
  • JSON Schema — схема, по которой проверяются объекты этого типа, с Edit.
  • Fixed — Type, задается при создании. Клиенты передают его в члене type; чтобы изменить, удалите тип и создайте новый.
  • Delete type после подтверждения: клиенты больше не могут запрашивать тип в authorization_details.

Create a type

+ Create Type открывает панель в режиме создания.

Create type
Панель Create type: поле Type, локализуемое поле Description и редактор JSON Schema с готовой схемой 2020-12.
ПолеПравила
TypeЗначение, которое клиенты передают в члене type. Первая буква строчная, дальше строчные буквы, цифры и подчеркивания (payment_initiation).
DescriptionОбязательное, по одному тексту на каждый активный язык; английский обязателен, остальные необязательны. Его показывает экран согласия.
JSON SchemaОбязательное. JSON Schema 2020-12, пишется в редакторе кода. Объекты этого типа отклоняются, если не проходят схему; unevaluatedProperties: false отклоняет неизвестные члены. Central отклоняет схему, которая сама некорректна как JSON Schema, а консоль показывает его сообщение под редактором.

Форма заполнена примером схемы: она требует type и допускает locations и actions как массивы строк. Central добавляет каждый тип в authorization_details_types_supported метаданных сервера и убирает его при удалении.

Что дальше

  • Security — остальные настройки тенанта
  • Keys & metadata — метаданные сервера, в которых перечислены типы
  • RFC 9396