Oauth 2.0

Провайдеры внешней авторизации

bg-dots
bg-dots

Раздел Система → Oauth 2.0 предназначен для управления провайдерами внешней авторизации OAuth. Через провайдера пользователи входят по учётным данным внешнего IdP; сервер сопоставляет атрибуты ответа с абонентом ВКС. Заголовок страницы — “Провайдеры Oauth”. Раздел не следует путать с Система → Настройки авторизации (OAuth-клиенты сервера).

Список провайдеров

Отображает настроенных провайдеров. При отсутствии записей таблица пуста (только заголовки). После сохранения провайдера в таблице появляется строка.

  • “ID провайдера” – идентификатор провайдера; участвует в формировании URL обратного вызова.
  • “Название” – отображаемое имя провайдера.
  • “URL обратного вызова поставщика” – callback URL, который необходимо указать в настройках OAuth-клиента у внешнего провайдера.
  • “Тип адаптера провайдера” – тип адаптера (например, “Общий”).
  • “Расширения потока” – включённые расширения OAuth-потока.
  • “Создать нового провайдера” – открытие формы создания провайдера.

Создать нового провайдера

Открывается кнопкой “Создать нового провайдера”. Заголовок диалога — “Создать нового провайдера”.

  • “ID провайдера” – обязательный буквенно-цифровой идентификатор; используется для построения URL обратного вызова провайдера.
  • “URL обратного вызова поставщика” – формируется автоматически по ID провайдера; это значение нужно указать как callback в кабинете внешнего OAuth-провайдера.
  • “Название” – обязательное отображаемое имя.
  • “Идентификатор клиента” – обязательный client ID, выданный провайдером.
  • “Секрет клиента” – обязательный client secret, выданный провайдером.
  • “Создавать абонента, если его нет на сервере” – при первом успешном входе создаёт абонента на сервере, если учётная запись ещё не существует.
  • “Настройки адаптера Oauth” – блок параметров обмена с провайдером.
  • “Тип адаптера провайдера” – тип адаптера. Доступные значения: “Общий”.
  • “Области действия” – scopes, запрашиваемые у провайдера.
  • “Символ разделителя областей” – символ, разделяющий scopes в запросе; по умолчанию ,.
  • “Проверять SSL сертификаты” – проверка SSL-сертификатов при обращении к URL провайдера.
  • “URL авторизации” – обязательный authorization endpoint провайдера.
  • “URL токена доступа” – обязательный token endpoint провайдера.
  • “URL-адрес владельца ресурса” – обязательный endpoint получения данных владельца ресурса (user info).
  • “Названия атрибутов для получения данных ВКС” – сопоставление полей ответа провайдера с данными абонента.
  • “Атрибут номера абонента” – имя атрибута с номером абонента; по умолчанию v_number.
  • “Атрибут отображаемого имени” – имя атрибута с отображаемым именем; по умолчанию v_display_name.
  • “Атрибут email” – имя атрибута с адресом электронной почты; по умолчанию email.
  • “Расширения потока” – дополнительные опции потока.
  • “Делегировать вход в учетную запись” – делегирование входа в учётную запись через провайдера.
  • “Отменить” – закрытие без сохранения.
  • “Сохранить” – создание провайдера.

Создание провайдера

Шаг 1. Открыть Система → Oauth 2.0.
Шаг 2. Нажать “Создать нового провайдера”.
Шаг 3. Указать “ID провайдера”, “Название”, “Идентификатор клиента” и “Секрет клиента”.
Шаг 4. Скопировать “URL обратного вызова поставщика” и указать его в настройках OAuth-клиента у внешнего провайдера.
Шаг 5. Заполнить URL авторизации, токена и владельца ресурса; при необходимости скорректировать scopes, разделитель и атрибуты ВКС.
Шаг 6. Нажать “Сохранить”. Провайдер появляется в списке. Для отказа — “Отменить”.

Вебхуки Ключи API