Настройка соответствия OpenID Connect

Owned by Visiology Robot (Unlicensed)
Last updated: мар. 29, 2023 by Эдуард Столяр
2 min read

Оглавление

Настройка атрибутов

Для настройки соответствия атрибутов:

  1. Перейдите на вкладку “Сопоставление атрибутов“.
  2. Включите сопоставление атрибутов, нажав кнопку "Включить сопоставление атрибутов".
  3. Задайте параметры сопоставления:
    1. Фамилия – атрибут, в котором хранится фамилия пользователя;
    2. Имя – атрибут, в котором хранится имя пользователя;
    3. Отчество – атрибут, в котором хранится отчество пользователя;
    4. Email – атрибут, в котором хранится email пользователя.
    5. Дополнительные атрибуты – используются для разграничения прав доступа к данным. Подробно описание см. в Разграничение прав доступа к данным
  4. Для сохранения настроек нажмите “Сохранить“.

Если сопоставление атрибутов не включено, то при создании пользователей, Фамилия будет получена из атрибута для "UserName claim" на вкладке Настройка внешней авторизации.

Настройка ролей

Для настройки соответствия ролей пользователей во внешнем провайдере и ролям в Visiology:

  1. Перейдите на вкладку  “Сопоставление ролей“.

  2. Выберите "Включить сопоставление ролей".
  3. Задайте параметр "JMESPath", по которому будут получены роли во внешнем Провайдере. Пользователям будут присваиваться значения ролей, полученные из этого параметра.

  4. Не удалять уже установленные роли пользователей:
    1. если опция включена, то в случае удаления роли пользователя во внешнем Провайдере, при авторизации в Visiology, удаленная роль не будет отозвана из назначенных ранее Пользователю ролей;
    2. если опция отключена, то удаленные у пользователя роли во внешнем Провайдере будут также удалены у пользователя в Платформе.
  5. Для сохранения настроек нажмите “Сохранить“.

Если Сопоставление ролей выключено, то при создании пользователя из внешнего Провайдера, новому пользователю будет присвоена роль "Все авторизованные пользователи".


Если включено “Включить сопоставление ролей“, то при авторизации пользователя, его роли в Visiology будут обновлены согласно с заданными настройкам сопоставления. 

Примеры сопоставления ролей

Имеется массив с ролями из токена:

{
   "resource_access":{
      "test":{
         "roles":[
            "foo",
            "fooo"
         ]
      }
   }
}


Пример 1

Для сопоставления ролей из токена с ролями на платформе необходимо ввести следующую команду в поле JMESPath:

resource_access.test.roles

Результат будет таким:

[ "foo", "fooo" ]

В данном случае роли на платформе и в провайдере должны иметь одинаковые наименования.

Пример 2

Если в провайдере присутствует определённая роль, вы можете произвести мапинг. Для этого на платформе введите следующую команду:

[contains(resource_access.test.roles, 'foo') && 'bar', contains(resource_access.test.roles, 'fooo') && 'barr']

Результат будет таким:

[ "bar", "barr" ] 

Пример 3

Если нужно к массиву ролей из провайдера добавить свою роль, например, чтобы назначить эту роль абсолютно всем пользователям, то необходимо ввести следующую команду:

[[resource_access.test.roles, 'bar']].map(&[], @)[0]

Результат будет таким:

[ "foo", "fooo", "bar" ]