Настройка интеграции Rocket.Chat с Trusted.ID#
В этом руководстве вы узнаете, как настроить интеграцию Rocket.Chat c Trusted.ID.
📌 Rocket.Chat — это платформа для обмена сообщениями с открытым исходным кодом, предназначенная для командной работы и коммуникации. Она предоставляет функционал, аналогичный таким сервисам, как Slack или Microsoft Teams, но с возможностью самостоятельного развертывания на собственном сервере.
Настройка входа c помощью Trusted.ID состоит из нескольких ключевых этапов, которые выполняются в двух разных системах:
- Шаг 1. Создание подключения в Rocket.Chat
- Шаг 2. Создание приложения в Trusted.ID
- Шаг 3. Настройка подключения в Rocket.Chat
- Шаг 4. Проверка подключения
Шаг 1. Создание подключения в Rocket.Chat#
- Авторизуйтесь в Rocket.Chat с правами администратора.
-
Вызовите меню и выберите пункт Рабочее пространство.
-
Откроется раздел Администрирование.
-
Перейдите в подраздел Настройки и нажмите Открыть в блоке OAuth.
-
Нажмите кнопку Добавить собственный OAuth.
-
В появившемся окне укажите уникальное название для подключаемого OAuth сервиса и нажмите Добавить.
-
Созданное подключение отобразится в общем списке подключений. Если этого не произошло, обновите страницу в браузере.
-
Раскройте настройки подключения и скопируйте Возвратный URL-адрес.
Шаг 2. Создание приложения в Trusted.ID#
- Авторизуйтесь в Trusted.ID.
-
Создайте новое приложение, в котором укажите:
- Адрес приложения - адрес инсталляции Rocket.Chat;
- Возвратный URL #1 (Redirect_uri) - вставьте скопированное значение из созданного подключения в Rocket.Chat.
🔍 Подробнее о создании приложений читайте в инструкции.
-
Откройте настройки приложения и скопируйте значения полей:
- Идентификатор (
Client_id), - Секретный ключ (
client_secret).
- Идентификатор (
Шаг 3. Настройка подключения в Rocket.Chat#
- Вернитесь в Rocket.Chat.
- Откройте настройки подключения, созданного на шаге 1.
-
Активируйте переключатель Включить для активации работы подключения, либо активируйте позже после настройки всех параметров.
-
Укажите параметры подключения:
- URL — URL-адрес сервиса Trusted.ID. Например: https://<адрес инсталляции Trusted.ID>
- Token Path — это часть URL-адреса Token Endpoint, которая указывает путь для получения токенов. Например: /api/oidc/token.
- Identity Path — конечная точка с информацией о пользователе. Например: /api/oidc/me.
- Authorize Path (Путь к авторизации) - путь от конечной точки авторизации. Например: /api/oidc/auth.
- Scope (Область) — необходимые разрешения для получения данных. Обязательный scope - openid и стандартный scope - profile . При указании нескольких разрешений разделите их пробелом. Например: profile email openid.
- Id (Идентификатор) - Идентификатор (
Client_id). Скопируйте значение, созданное на шаге 2. - Secret (Ключ) — Секретный ключ (
Client_secret). Скопируйте значение, созданное на шаге 2.
-
Укажите остальные настройки. С подробным описанием настроек можно ознакомиться на портале документации docs.rocket.chat.
- Сохраните настройки подключения.
После завершения всех шагов в виджете авторизации Rocket.Chat отобразится кнопка входа для Trusted.ID.
Шаг 4. Проверка подключения#
- Откройте страницу входа в Rocket.Chat.
- Убедитесь, что появилась кнопка Вход через Trusted.ID.
-
Нажмите на кнопку и выполните вход, используя корпоративные учетные данные:
- Вы будете перенаправлены на страницу аутентификации Trusted.ID;
- После успешного входа вы попадёте обратно в Rocket.Chat, авторизованным пользователем.
