Сервис лицензирования и особенности его использования

Сервис лицензирования предназначен для обработки запросов от веб-приложения (BI-сервера) или настольного приложения к серверу лицензий. При работе с продуктом «Форсайт. Аналитическая платформа» запрашиваются требуемые единицы лицензирования, сервис лицензирования обрабатывает полученные запросы и перенаправляет их к серверу лицензий.

Сервис лицензирования - это утилита licman со встроенной поддержкой параллельной обработки запросов для программного обеспечения, на базе которого работает сервер лицензий: Guardant или RMS.

Примечание. Для получения сервиса лицензирования обратитесь в техническую поддержку по адресу support@fsight.ru или через сервисы технической поддержки, которые доступны после регистрации на сайте.

Шаг 1. Установка сервиса лицензирования

Процесс установки сервиса лицензирования зависит от операционной системы. В ОС Linux установка выполняется с помощью дистрибутива, в ОС Windows установка не требуется, достаточно разместить файлы сервиса лицензирования в произвольной папке.

Шаг 2. Предварительная настройка работы сервиса лицензирования по протоколу HTTPS

По умолчанию сервис лицензирования взаимодействует с продуктом «Форсайт. Аналитическая платформа» по протоколу HTTPS.

Для предварительной настройки работы сервиса лицензирования по протоколу HTTPS:

1. Подготовьте сертификаты безопасности:

• корневой сертификат безопасности в формате CRT;

• сертификат сервера, на котором расположен сервис лицензирования, в формате PEM;

• закрытый ключ сертификата сервера в формате PEM.

Сертификаты безопасности включают в себя набор информации о владельце сертификата, открытом ключе владельца сертификата, субъекте, который выпустил и подписал сертификат, а также информацию для проверки сертификата. Каждый сертификат ограничен сроком действия. Сервис лицензирования доступен, если сертификаты действительны на момент его использования. При необходимости обновите сертификаты или продлите их срок действия.

2. Разместите сертификаты безопасности в папке:

• /opt/foresight/ssl в ОС Linux;

• C:\Licman в ОС Windows.

3. Импортируйте корневой сертификат в хранилище доверенных корневых центров сертификации в зависимости от операционной системы.

Другие варианты установки и импорта сертификата на различных операционных системах и браузерах приведены на портале государственных услуг.

После выполнения действий будет настроена работа сервиса лицензирования по протоколу HTTPS.

В шаге 3 при настройке конфигурации сервиса лицензирования в файле settings.json укажите параметры работы сервиса лицензирования по протоколу HTTPS в настройках поля secure.

В шаге 4 при подключении сервиса лицензирования в файле settings.xml укажите номер порта, по которому доступен сервис лицензирования по протоколу HTTPS, в параметре Port. По умолчанию: 8511.

Шаг 3. Настройка конфигурации сервиса лицензирования

Для настройки конфигурации сервиса лицензирования используйте файл settings.json, расположенный по умолчанию в папке:

• /opt/foresight/licman в ОС Linux;

• C:\Licman в ОС Windows.

По умолчанию в файле settings.json заданы основные поля server и port для работы сервиса лицензирования по протоколу HTTP:

{
    "server": "localhost",
    "port": 8510
}

Для работы сервиса лицензирования по протоколу HTTPS задайте основные поля secure, server и дополнительные поля при необходимости.

Пример файла settings.json:

{
    "server": "localhost",
    "secure":{
        "port": 8511,
        "key": "/opt/foresight/ssl/fp_licman_server_key.pem",
        "cert": "/opt/foresight/ssl/fp_licman_server_cert.pem"
   }
}

Для получения подробной информации о содержимом файла settings.json обратитесь к разделу «Настройка конфигурации сервиса лицензирования».

Для применения изменения конфигурации сервиса лицензирования в файле settings.json в ОС Linux перезапустите службу licman.service:

sudo systemctl restart licman.service

Шаг 4. Подключение сервиса лицензирования

Для подключения сервиса лицензирования и взаимодействия продукта «Форсайт. Аналитическая платформа» с сервером лицензий через него сформируйте раздел License, содержащий подраздел Service, в файле settings.xml со следующими параметрами:

• Active. Признак взаимодействия продукта «Форсайт. Аналитическая платформа» с сервером лицензий через сервис лицензирования. Допустимые значения:

• True. Продукт «Форсайт. Аналитическая платформа» взаимодействует с сервером лицензий через сервис лицензирования;

• False. По умолчанию. Продукт «Форсайт. Аналитическая платформа» взаимодействует с сервером лицензий напрямую.

Примечание. Прямое взаимодействие допустимо только при использовании сервера лицензий на базе RMS.

При использовании сервера лицензий на базе Guardant задайте параметру значение True.

• Secure. Признак работы сервиса лицензирования по протоколу HTTPS. Допустимые значения:

• True. По умолчанию. Сервис лицензирования работает по протоколу HTTPS;

• False. Сервис лицензирования работает по протоколу HTTP;

• Host. IP-адрес или DNS-имя сервиса лицензирования. По умолчанию: localhost;

• Port. Номер порта, по которому доступен сервис лицензирования:

• по протоколу HTTPS - 8511. Используется, если параметр Secure принимает значение True. При указании данного порта номер должен совпадать со значением поля port, указанного в поле secure, в файле settings.json;

• по протоколу HTTP - 8510. Используется, если параметр Secure принимает значение False. При указании данного порта номер должен совпадать со значением поля port, указанного в файле settings.json;

• TlsVersion. Версия протокола Transport Layer Security (TLS), используемого для создания безопасного канала связи между компьютерами в сети. По умолчанию используется версия 1.2. Рекомендуется использовать версию протокола TLS 1.2 и выше.

Пример раздела License в settings.xml:

• при работе сервиса лицензирования по протоколу HTTPS:

<Key Name="License">
  <Key Name="Service" Active="True" Host="localhost" Port="8511"/>
</Key>

• при работе сервиса лицензирования по протоколу HTTP:

<Key Name="License">
  <Key Name="Service" Active="True" Secure="False" Host="localhost" Port="8510"/>
</Key>

Для применения параметров подключения сервиса лицензирования в веб-приложении перезапустите BI-сервер. Если открыто настольное приложение, то перезапустите его.

Шаг 5. Запуск сервиса лицензирования

Для запуска сервиса лицензирования:

• в ОС Linux запустите или перезапустите службу licman.service:

sudo systemctl start/restart licman.service

• в ОС Windows запустите утилиту licman_guardant.exe/licman_rms.exe.

При запуске сервиса лицензирования проверяется наличие валидного файла settings.json:

• если файл settings.json содержится в одной папке с утилитой licman и является валидным, то используются заданные значения полей;

• если файл settings.json не содержится в одной папке с утилитой licman или является невалидным, то используются значения полей по умолчанию.

В процессе работы сервиса лицензирования выводится отладочная информация, если в settings.json задано поле logLevel со значением «info» или «log». Для получения подробной информации о возможных ошибках, возникающих при работе с Guardant, обратитесь к официальной документации.

Настройка отказоустойчивости сервера лицензий

Для обеспечения отказоустойчивости основного сервера лицензий доступно подключение серверов, которые будут использоваться в качестве резервных.

Примечание. Актуально при активации продукта на базе RMS.

Сервис лицензирования обращается к основному серверу лицензий в течение времени, заданного в поле serverTimeout. Если заданное время ожидания истекло и сервис лицензирования не получил ответ от сервера лицензий, то выполняется подключение к резервному серверу, следующему после основного в массиве поля server. После чего сервис лицензирования обращается к основному серверу с периодичностью, заданной в поле checkServerTime. Если основной сервер лицензий отвечает на запросы, то выполняется обратное подключение.

На резервных серверах должна содержаться лицензия с пробным периодом для обеспечения непрерывной работы пользователей в случае временной недоступности основного сервера лицензий. Лицензия активируется при первом обращении к ней.

Для подключения резервных серверов лицензий задайте массив в поле server. При необходимости измените значения дополнительных полей.

Пример заполнения полей в settings.json:

{
    "server": ["localhost", "reserveServer"],
    "port": 8510,
    "checkServerTime": 15,
    "logLevel": "log",
    "serverTimeout": 10,
    "workersCount": 4,
    "secure":{
        "port": 8511,
        "key": "/opt/foresight/ssl/fp_licman_server_key.pem",
        "cert": "/opt/foresight/ssl/fp_licman_server_cert.pem"
    }
}

Настройка отказоустойчивости сервиса лицензирования

Для обеспечения отказоустойчивости сервиса лицензирования при использовании одного BI-сервера или кластера BI-серверов настройте балансировщик HAProxy. Для получения подробной информации обратитесь к разделу «Настройка балансировщика HAProxy при использовании сервиса лицензирования».

Удаление сервиса лицензирования в ОС Linux

Для удаления файлов сервиса лицензирования в ОС Linux выполните команду:

• Astra Linux:

sudo apt-get purge foresight-licman

• РЕД ОС, Rocky Linux:

sudo yum purge foresight-licman

• ALT Linux:

sudo apt-get remove --purge foresight-licman

После выполнения действия будет удалены папки /opt/foresight/licman, /var/log/licman и служба /etc/systemd/system/licman.service.