Документация Webitel
Документация Webitel
Breadcrumbs

Общее (SSO)

1. Описание

Предназначена для ввода параметров подключения к провайдеру аутентификации.

Состоит из полей (Рис. 1):

  1. Имя;

  2. Application (client) ID;

  3. Блок проверки/получения токена;

  4. Client secret;

  5. Discovery URL;

  6. Скоупы.

Общее (SSO).png
Рис. 1. Страница детали "Общее"

1.1. Поле “Имя”

Обязательное поле. В этом поле указывается название профиля подключения. Название отображается на странице входа, на кнопке SSO.

Обратите внимание! Название должно быть коротким.

1.2. Поле “Application (client) ID”

Обязательное поле. Здесь указывается идентификатор приложения, созданного в провайдере аутентификации.

1.3. Блок проверки/получения токена

Блок предназначен для проверки корректности введённых параметров подключения к провайдеру с помощью кнопки "Inspect".

Кнопка становится активной после заполнения всех обязательных полей детали "Общее".

После нажатия кнопки:

  • в новой вкладке браузера открывается страница входа выбранного провайдера;

  • нужно ввести свои учётные данные (могут быть личными) — это нужно только для проверки подключения;

  • после успешного входа вкладка закрывается, и пользователя возвращает обратно в Webitel;

  • на странице профиля SSO отображается полученный токен.

Inspect кнопка.png
Рис. 2. Активная кнопка "Inspect"

1.4. Поле “Client secret”

Обязательное поле. Здесь указываются креденшилы подключения. Значение может иметь ограниченный срок действия в зависимости от провайдера.

После сохранения профиля значение поля скрывается.

Иконка просмотра пароля Іконка відображення паролю.png показывает значение поля и меняется на иконку скрытия Іконка приховування паролю.png . Повторное нажатие скрывает значение и возвращает иконку в предыдущее состояние.

1.5. Поле “Discovery URL”

Обязательное поле. Здесь указывается ссылка, из которой система получает настройки для подключения к провайдеру (для Microsoft — это "OpenID Connect metadata document").

1.6. Поле “Скоупы”

Необязательное поле. Мультивыбор дополнительных прав доступа к данным пользователя, которые провайдер будет передавать в токене (например, скоуп email добавляет в токен электронный адрес пользователя).

Скоуп openid является обязательным и добавляется автоматически, даже если не указан пользователем.

2. Возможности

2.1. Изменить или задать параметры

Цель

Изменить или задать параметры

Предусловия:

  1. Доступ к приложению Admin;

  2. Доступ к разделу "SSO" в приложении Admin;

  3. Разрешение на просмотр и редактирование в разделе "SSO";

  4. Наличие как минимум одного профиля, или создание нового.

Сценарий:

 

  1. Нажмите поле, которое нужно изменить.

  2. Ввести нужные изменения.

  3. Нажать кнопку "Сохранить".

Результат

Данные сохранены.