Перейти к содержанию

Как настроить интеграцию МТС Линк с Encvoy ID#

В этом руководстве вы узнаете, как настроить единый вход (SSO) в МТС Линк через систему Encvoy ID.

📌 МТС Линк — экосистема сервисов для бизнес-коммуникаций и совместной работы, объединяющая звонки, видеоконференции, чаты и управление задачами.

Настройка входа через Encvoy ID состоит из двух ключевых этапов, которые выполняются в двух разных системах.

Шаг 1. Создание приложения#

  1. Авторизуйтесь в системе Encvoy ID.

  2. Создайте приложение с настройками:

    • Адрес приложения - адрес инсталляции системы МТС Линк;
    • Возвратный URL #1 (Redirect_uri) - <адрес инсталляции МТС Линк>/api/oauth/return.

    🔍 Подробнее о создании приложений читайте в инструкции.

  3. Перейдите в настройки приложения и скопируйте значения полей:

    • Идентификатор (Client_id),
    • Секретный ключ (client_secret).

Для корректной работы требуется подтверждение домена в МТС Линк. Подтверждение необходимо, чтобы только сотрудники организации могли использовать домен для SSO. Подробное описание в статьях Подтверждение домена для SSO и Настройка SSO.

Включение и настройка SSO#

  1. Авторизуйтесь в МТС Линк.
  2. Перейдите в раздел Бизнес → Настройки SSO.
  3. Откроется форма настройки.

  4. Укажите настройки:

    • Протокол → OAuth,
    • SSO провайдер → ID.Encvoy ID,
    • Идентификатор приложения (Client id) — идентификатор приложения, созданного в Encvoy ID;
    • Секретный ключ приложения (Client secret) — секретный ключ приложения, созданного в Encvoy ID;
    • Базовый URL-адрес — укажите адрес сервиса Encvoy ID.

    Выбор протокола OAuth в МТС Линк

  5. Нажмите Далее:

Проверка параметров Redirect URI#

Убедитесь, что значение параметров Адрес приложения и Возвратный URL (Redirect_uri) соответствуют значениям, что указаны в настройках Encvoy ID.

Данные провайдера SSO

Если они отличаются — скопируйте актуальные значения из МТС Линк и вставьте их в настройки вашего приложения Encvoy ID.

Добавление корпоративного домена#

  1. В личном кабинете МТС Линк укажите домен электронной почты, чтобы пользователи с этим доменом направлялись на страницу провайдера идентификации Encvoy ID.

  2. Нажмите Добавить, чтобы пользователи с этим доменом перенаправлялись для входа через Encvoy ID.

    Домен электронной почты в МТС Линк

Проверка корректности настройки#

  1. В разделе Настройки SSO нажмите кнопку Проверить работу.
  2. Откроется окно входа через Encvoy ID. Успешная авторизация подтверждает корректность интеграции.