Федерация в Платформе IVA MCU
В Платформе IVA MCU используются следующие определения федерации:
-
Федерация — это несколько серверов IVA MCU, между которыми установлены доверительные (федеративные) отношения
-
Внешний (федеративный) пользователь — это пользователь, зарегистрированный на другом экземпляре Платформы IVA MCU, с которым установлены доверительные отношения. Доступен для добавления в чаты, звонки, мероприятия и комнаты на локальном экземпляре Платформы IVA MCU
-
Федеративная комната — это комната, в которой есть хотя бы один внешний пользователь
-
Внешняя комната — это комната, созданная, хранимая и управляемая на другом экземпляре Платформы IVA MCU, с которым установлены доверительные отношения
-
Федеративное мероприятие — это мероприятие, в котором есть хотя бы один внешний пользователь
-
Внешнее мероприятие — это мероприятие, созданное, хранимое и управляемое на другом экземпляре Платформы IVA MCU, с которым установлены доверительные отношения
-
Федеративный чат — это персональный или групповой чат, в котором есть хотя бы один внешний пользователь
-
Внешний чат — это чат, созданный, хранимый и управляемый на другом экземпляре Платформы IVA MCU, с которым установлены доверительные отношения
|
В текущем релизе Платформы IVA MCU применяются следующие ограничения при работе с Федеративными связями:
|
Федеративные пользователи
При синхронизации нескольких серверов IVA MCU, объединенных в федерацию, на удаленном сервере создаются федеративные пользователи — облегченные копии зарегистрированных пользователей на мастер-сервере
Синхронизация пользователей при федерации
Под синхронизацией подразумевается обоюдный обмен пользователями между серверами федерации.
Процессу синхронизации подвержены все зарегистрированные в системе пользователи, в том числе пользователи из LDAP и внешних провайдеров аутентификации.
Синхронизация изменений осуществляется посредством NATS-сервера на основе событий, отправляемых с мастер-сервера на удаленные сервера.
Также возможна синхронизация потерянных изменений на основе даты последнего изменения пользователя — удаленный сервер при получении обновлений постоянно сдвигает дату изменения и при необходимости синхронизации запрашивает изменения начиная с последней даты, которую имеет.
Запуск синхронизации выполняется:
-
автоматически после подключения к серверу NATS, если синхронизация федеративной связи еще не выполнялась или политика восстановления данных предусматривает запрос изменений
-
вручную из веб-панели администрирования (ручная синхронизация применяется, например, в случае ошибок автоматической синхронизации)
При первичной синхронизации федеративной связи запрашивается полный список зарегистрированных пользователей удаленного сервера
Синхронизация выполняется для следующих данных:
-
логин
-
имя
-
email (если видимость данных — Всем)
-
телефон / VVoIP-адрес (если видимость данных — Всем)
-
дополнительный контакт (если видимость данных — Всем)
-
аватар
-
статус блокировки
-
статус удаления
| В текущей версии Платформы IVA MCU поиск федеративных пользователей в контактах не поддерживается |
Федеративные мероприятия
Федеративное мероприятие может быть локальным или внешним относительно конкретного экземпляра Платформы IVA MCU.
Мастер-сервер мероприятия — это сервер, на котором мероприятие было создано и полностью хранятся его данные. Другие серверы федерации являются удаленными относительно мастер-сервера данного мероприятия.
На удаленных серверах федерации, чьи пользователи участвуют в данном мероприятии, хранится только базовая информация о мероприятии.
Наличие базовой информации о мероприятиях:
-
позволяет пользователям на удаленном сервере видеть в одном списке и локальные, и внешние мероприятия
-
не позволяет пользователям на удаленном сервере вносить изменения во внешние мероприятия
Синхронизация мероприятий при федерации
Синхронизация изменений осуществляется посредством NATS-сервера на основе событий, отправляемых с мастер-сервера на удаленные сервера.
Также возможна синхронизация потерянных изменений на основе даты последнего изменения мероприятия — удаленный сервер при получении обновлений постоянно сдвигает дату изменения и при необходимости синхронизации запрашивает изменения начиная с последней даты, которую имеет.
Запуск такой синхронизации выполняется:
-
автоматически после подключения к серверу NATS, если синхронизация федеративной связи еще не выполнялась или политика восстановления данных предусматривает запрос изменений
-
вручную из веб-панели администрирования (ручная синхронизация применяется, например, в случае ошибок автоматической синхронизации)
Первичная загрузка полного списка ранее созданных мероприятий не выполняется. При первом запуске синхронизации новой федеративной связи запрашиваются изменения мероприятий, произошедшие после создания этой связи.
Синхронизация выполняется для следующих данных:
-
название
-
описание
-
расписание
-
владелец
-
состояние
-
тип мероприятия
-
формат мероприятия
-
возможность подключения VVoIP
-
тип запуска
-
уровень доступа к ссылкам
-
ограничение на подключение
-
расширенные настройки
-
уровень доступа к завершенному мероприятию
Подключение к федеративному мероприятию
Подключение к федеративному мероприятию выполняется по следующим правилам:
-
локальные пользователи мастер-сервера подключаются как к обычному мероприятию
-
локальные пользователи удаленного сервера осуществляют подключение к мероприятию через мастер-сервер, где они временно авторизуются на период участия в мероприятии
|
Во время участия в федеративном мероприятии пользователи с удаленного сервера подключаются к мастер-серверу и используют:
|
Федеративные звонки
Федеративные звонки позволяют пользователям разных серверов Платформы IVA MCU выполнять персональные и групповые звонки.
Мастер-сервер звонка — сервер, на котором изначально создан федеративный чат и выполняется управление звонком. Смена владельца чата не изменяет мастер-сервер звонка
Другие серверы федерации являются удаленными относительно мастер-сервера данного звонка и хранят копию информации о чате.
Состояния участников синхронизируются только для пользователей, зарегистрированных на соответствующем удаленном сервере.
Синхронизация звонков при федерации
Во время звонка серверы федерации обмениваются через NATS-сервер следующими событиями:
-
начало звонка и изменение его состояния
-
приглашение, подключение и выход участников
-
завершение звонка
Сверка активных звонков выполняется в составе синхронизации федеративной связи.
При подключении к серверу NATS синхронизация запускается автоматически для связей, синхронизация которых еще не выполнялась. Для остальных связей автоматический запуск выполняется, если политика восстановления данных предусматривает запрос изменений.
Синхронизацию также можно запустить вручную из веб-панели администрирования.
При синхронизации удаленный сервер получает от мастер-сервера список активных федеративных звонков и сравнивает его с локальными данными. Если звонок числится активным только на удаленном сервере, его локальное состояние переводится в завершенное.
Настройка федеративных звонков
Доступность создания федеративных чатов и звонков в клиентских приложениях определяется функцией Федеративные чаты и звонки.
Чтобы включить возможность создания федеративных чатов и звонков в клиентских приложениях, необходимо:
Перейти в раздел Доменных / Системных настроек →
Выбрать секцию Экспериментальные настройки →
Поле Федеративные чаты и звонки →
Включить флаговую кнопку →
Нажать кнопку Сохранить
| Настройка управляет возможностью находить федеративных пользователей при создании и редактировании чатов в клиентских приложениях |
Особенности и ограничения
Для федеративных звонков используются персональные и групповые федеративные чаты.
Между серверами синхронизируются сведения о чатах и составе их участников.
При синхронизации федеративной связи обновления чатов запрашиваются с учетом даты последнего изменения.
При работе с такими чатами действуют ограничения:
-
сообщения чатов между серверами федерации не синхронизируются
-
пользователя с другого сервера федерации нельзя назначить владельцем чата
Настройка федеративных связей
Для настройки федеративных связей в Платформе IVA MCU необходимо выполнить следующие настройки на каждом сервере федерации:
Системные настройки NATS
В секции NATS раздела системных настроек веб-панели администрирования можно выполнить следующие настройки:
| Настройка | Описание |
|---|---|
URL брокера сообщений |
Указывается адрес для подключения к брокеру сообщений. Например |
Keystore брокера сообщений |
Указывается клиентский сертификат и приватный ключ для интеграции с брокером сообщений в формате .pem |
Truststore брокера сообщений |
Указывается доверенный сертификат в формате .pem |
Максимальное число потоков |
Указывается максимальное число потоков, используемых каждым NATS-коннектором для своей работы |
|
Сертификаты для Платформы IVA MCU (клиент NATS) и внешнего сервера NATS должны быть подписаны одним корневым сертификатом в формате .pem. В поле Keystore брокера сообщений необходимо указать объединенные сертификаты (корневой сертификат и сертификат клиента NATS) и ключ от сертификата клиента NATS. |
Чтобы выполнить системные настройки NATS, необходимо:
Войти в веб-панель администрирования →
Перейти в раздел Системные настройки →
Выбрать секцию NATS →
Выполнить настройки →
Нажать кнопку Сохранить
Настройки Федеративных связей
Для управления и настройки федеративных связей с другими серверами IVA MCU необходимо:
-
перейти к настройкам Федеративных связей:
Войти в веб-панель администрирования → Перейти в раздел Федеративные связи → Выбрать домен и нажать кнопку Федеративные связиВ разделе Федеративные связи указано значение ID экземпляра сервера IVA MCU 
-
добавить федеративные связи для выбранного домена:
Нажать кнопку Добавить федеративную связь → Заполнить поля:-
Название — указывается название удаленного домена. Используется в клиентском интерфейсе для идентификации федеративных сущностей (пользователи, мероприятия и др.)
-
ID удаленного экземпляра — указывается ID удаленного экземпляра сервера IVA MCU. Значение необходимо брать с экземпляра удаленного сервера IVA MCU
-
Сетевое имя удаленного домена — указывается сетевое имя удаленного домена. Значение необходимо брать с экземпляра удаленного сервера IVA MCU
-
Веб-адрес удаленного домена — указывается веб-адрес удаленного сервера Платформы IVA MCU. Адрес используется для синхронизации данных между серверами
-
Нажать кнопку Создать
-
-
настроить добавленную федеративную связь:
Выбрать федеративную связь и нажать кнопку Детально → Детальная информация о федеративной связи → Поле Публичный ключ удаленной федеративной связи → Ввести Публичный ключ удаленной федеративной связи → Нажать кнопку СохранитьПубличный ключ удаленной федеративной связи — это публичный ключ федеративной связи другого (удаленного) экземпляра Платформы IVA MCU 
Управление федеративными связями
В разделе Федеративные связи можно:
-
обновить список федеративных связей: Нажать кнопку Обновить
-
Синхронизировать выбранную связь / все связи: Нажать кнопку Синхронизировать / Синхронизировать все связи
-
посмотреть список пользователей: Нажать кнопку Пользователи
-
посмотреть детальную информацию о федеративной связи: Нажать кнопку Детально
-
удалить федеративную связь: Нажать кнопку Удалить → Подтвердить удаление федеративной связи
