Как зарегистрировать разрешение — Versola Docs
/docs
До 1.00.7.5versola.ioGitHub
RUEN

Как зарегистрировать разрешение

Создайте разрешение в консоли администратора Versola и свяжите его с эндпоинтами ресурсов, которые оно покрывает

Разрешение (permission) — именованный набор эндпоинтов ресурсов. Здесь вы создадите его в консоли администратора и привяжете эндпоинты. Поля и правила описаны в разделе Permission.

Предварительные требования

  • Тенант, выбранный в консоли.
  • Ресурс с эндпоинтами, которые нужно покрыть. Выбрать можно только эндпоинты, которые уже есть в ресурсе.

1. Откройте Permissions

Откройте Permissions в нужном тенанте. На карточке — описание и ID разрешения. Раскройте карточку, чтобы увидеть ресурс и покрываемые эндпоинты. Если ресурсов много, сузьте список полем Resource: введите часть хоста и выберите его.

Разрешения выбранного тенанта, есть поиск по ID
Страница Permissions со списком из двух разрешений.
Раскрытое разрешение: ресурс и эндпоинт, который оно покрывает
Разрешение раскрыто: видны ресурс и endpoint, к которому оно дает доступ.

2. Начните новое разрешение

Нажмите + Create Permission.

Create Permission: ID, описание и выбор ресурса
Пустая форма Create Permission.

3. Заполните разрешение

  1. Permission ID: строчные латинские буквы, цифры, подчеркивания и дефисы в сегментах, разделенных :; каждый сегмент начинается с буквы, например payments:export или payments:export:own. Точки не принимаются. Позже ID изменить нельзя.
  2. English description: подпись для консоли. Если оставить поле пустым, консоль использует ID.
  3. В поле Add resource выберите ресурс и нажмите Add resource. Ниже откроется его карточка.
  4. В карточке выберите эндпоинт в поле Add endpoint и нажмите Add endpoint. Эндпоинт появится в списке с методом и путем. Повторите для каждого эндпоинта, а если разрешение охватывает несколько ресурсов, добавьте и их.
payments:export с привязанным GET /payments одного ресурса
Форма Create Permission заполнена, привязан endpoint ресурса.

4. Создайте разрешение

Нажмите Create Permission. Разрешение можно добавить в роль. Для service app, который вызывает ваши API через client_credentials, добавьте его в раздел Permissions клиента.

Разрешение только сопоставляет эндпоинты. edge при каждом вызове все равно вычисляет Allow (CEL), step-up и max auth age эндпоинта. См. Политики эндпоинтов.

Изменение и удаление разрешения

Нажмите карандаш на карточке, чтобы добавить или убрать ресурсы и эндпоинты либо изменить описание. ID не меняется. Если эндпоинт убрали из ресурса, разрешение показывает его в блоке Detached endpoints. Удалите его там. Крестик удаляет разрешение после подтверждения. Роли и клиенты сохраняют ID в своих списках, но он больше не покрывает ни одного эндпоинта и ничего не дает.

Что дальше