Для корректного подключения сервиса ClientConnectionService к приложению Centrifugo, в конфигураторе в секции Приложение Centrifugo (SungeroCentrifugo) должны быть указаны значения параметров:

•'api_key' – ключ для доступа к API Centrifugo. Формируется автоматически во время установки Directum RX. Значение настройки должно совпадать со значением параметра CENTRIFUGO_API_KEY сервиса клиентских подключений;

•'port' – порт для взаимодействия с Centrifugo. Указывается тот же порт, что и в параметре CENTRIFUGO_API_URI сервиса клиентских подключений.

Пример настройки в config.yml:

SungeroCentrifugo:

    'api_key': '564219a3-0b34-48d2-bd40-2144a6177c09'
    'port': 80

Для настройки авторизации пользователей в конфигурационном файле в секции Приложение Centrifugo (SungeroCentrifugo) должны быть заданы значения параметров:

•'proxy_connect_endpoint' – IP-адрес компьютера, где установлен сервис клиентских подключений. На этот адрес отправляются запросы на авторизацию пользователей. По умолчанию localhost. Обновите IP-адрес, если сервис клиентских подключений перенесли на другой компьютер. Порт, указанный в адресе, должен совпадать со значением параметра SERVICE_PORT сервиса клиентских подключений;

•'proxy_connect_timeout' – время, по истечении которого запрос на авторизацию пользователя отклоняется, если не получен ответ от сервиса клиентских подключений. По умолчанию 5 секунд. Измените значение параметра, если при подключении сотрудников к системе Directum RX возникают ошибки;

•'user_subscribe_to_personal' – автоматическая подписка пользователей на приватные каналы. Если флажок установлен (true), то при авторизации пользователь подписывается на приватный канал, флажок снят (false) – подписка не выполняется.

Пример настройки в config.yml:

SungeroCentrifugo:

    'proxy_connect_endpoint': #auto
    'proxy_connect_timeout': 5
    'user_subscribe_to_personal': true

Для отслеживания ошибок Centrifugo используется логирование. Чтобы настроить уровень детализации ошибок, во встроенном редакторе YAML в секции SungeroCentrifugo измените значение параметра 'log_level':

•debug – запись отладочных сообщений;

•info – запись информационных сообщений. Значение по умолчанию;

•error – запись сообщений обо всех ошибках;

•critical – запись критических ошибок;

•fatal – запись ошибок, которые приводят к завершению работы Centrifugo;

•trace – запись всех операций Centrifugo;

•none – логирование не ведется.

Чтобы изменить путь к лог-файлу, укажите его в параметре 'log_file'.

Пример настройки в config.yml:

SungeroCentrifugo:

    'log_level': trace
    'log_file': '{{ home_path }}/Logs/Centrifugo.log'

У Centrifugo есть веб-страница администрирования, с помощью которой можно вручную управлять клиентскими подключениями. По умолчанию доступ к странице отключен. Чтобы настроить доступ к странице, в Directum Launcher во встроенном редакторе YAML в секции SungeroCentrifugo используйте параметры:

•'admin' – открыть доступ к странице администрирования. Укажите значение true, чтобы открыть доступ, false – закрыть доступ.

•'admin_password' – пароль администратора;

•'admin_secret' – секретный ключ, который используется для генерации токена доступа к веб-странице администрирования Centrifugo. В параметре можно указать произвольное строковое значение.

Пример настройки:

SungeroCentrifugo:

    'admin': false
    'admin_password': '1Qwertyui'
    'admin_secret': '7dpqoRSK'

Чтобы открыть веб-страницу администрирования, в адресной строке браузера введите адрес Centrifugo, по умолчанию http://localhost:48480/. Фактическое значение порта можно посмотреть в конфигурационном файле <Папка с Directum Launcher>\etc\_services_config\SungeroCentrifugo\service_config.yml.

Со страницы администрирования можно вручную:

•отправлять сообщения в приватные каналы;

•отписывать или подписывать новых пользователей на каналы;

•просматривать статистику по количеству подключенных каналов и добавленных в них пользователей.

Подробное описание веб-страницы для администрирования см. в документации Centrifugo.

Сервис клиентских подключений