Общая информация

...

Сервис лицензирования (далее - СЛ):

• предназначен для хранения файла лицензии, считывания данных из файла и передачи этих данных приложениям Robin
• является отдельным компонентом, который не привязан к какому-то одному конкретному продукту
• реализован на NET
• включен только в Enterprise поставку с web-интерфейсом

На сервере приложений имеется папка, в которую СЛ помещает файл лицензии для его считывания.

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

Место хранения файла лицензии зависит от варианта поставки и некоторых дополнительных условий.

...

Вариант поставки

...

Версия

...

Доп. условия

...

Место хранения лицензии

...

Standalone

...

Любая

...

установка - "Для себя"

...

• C:/Users/<userName>/AppData/Local/Programs/Robin Platform/2.0.0/RobotPlayer
• C:/Users/<userName>/AppData/Local/Programs/Robin Platform/2.0.0/Studio

...

установка - "Для всех"

...

• C:/Program Files/Robin Platform/2.0.0/RobotPlayer
• C:/Program Files/Robin Platform/2.0.0/Studio

...

Enterprise

...

Параметр "StorageType" указан в config-файлах у Студии, Плеера и Агента. Если значение параметра = "LDAP", то приложения подключаются к старому (не web) Оркестратору

До 2.21.2

...

• StorageType = "LDAP" или "REST"
• установка - "Для себя"

...

• C:/Users/<userName>/AppData/Local/Programs/Robin Platform/2.0.0/RobotPlayer
• C:/Users/<userName>/AppData/Local/Programs/Robin Platform/2.0.0/Studio

о лицензиях

Лицензия на любой продукт Robin может быть:

• ограничена по сроку действия. По прошествии даты, указанной для продукта в файле лицензии, становится недоступна работа с этим продуктом.
• бессрочной, если продукт не имеет ограничения по сроку действия. 

Лицензии на Robin Robot также имеют дополнительное ограничение - по месту запуска роботов. В зависимости от этого ограничения есть следующие виды лицензий на Robin Robot:

• Демо-лицензия. Такая лицензия позволяет запускать готовых роботов на любом количестве машин, но как правило, имеет небольшой срок действия. Обычно такую лицензию предоставляют для ознакомления с возможностями платформы.
• Лицензия с привязкой к учётной записи машины. Такая лицензия разрешает запуск роботов только на той учётной записи машины, которая указана в лицензии. Можно приобрести несколько таких лицензий, в каждой из которых будут указаны разные учётные записи.
• Конкурентная лицензия. Такая лицензия ограничивает количество учётных записей машин, которые могут быть заняты роботами. Но в лицензии не уточняется, на каких именно машинах разрешен запуск, т.е. могут быть любые машины.
  

  Информация
  title Пример
  Конкурентная лицензия разрешает запуск на 2 учётных записях машин. 1) Запустили несколько роботов на учётной записи_1 и несколько роботов на учётной записи_2. Занято две из 2х учётных записей, разрешенных лицензией. 2) Пытаются запустить робота на учётной записи_3 - запуск будет запрещен, т.к. исчерпан лимит конкурентной лицензии. 3) На учётной записи_1 все роботы завершили работу. Значит теперь занята только 1 из 2х учётных записей, разрешенных лицензией. 4) Пытаются запустить робота на учётной записи_3 - запуск будет разрешен.

    

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

В одном файле лицензии может быть несколько разных видов лицензий на Robin Robot с одинаковым или разным сроком действия.

Назначение модуля

Модуль "Управление лицензиями" предназначен для:

• просмотра информации о лицензиях на продукты Robin
• загрузки файла лицензии

Image Added

Работа с модулем доступна только пользователям с ролью "Администратор лицензирования". Поэтому если у вас нет такой роли, то модуль "Управление лицензиями" не отобразится на панели меню.

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

Таблица лицензий

Таблица в модуле "Управление лицензиями" содержит список лицензий на продукты Robin. Информация о лицензиях взята из файла лицензии, загруженном на сервер системы.

С помощью выпадающего списка «Столбцы» можно выбрать, какие столбцы будут скрыты или отображены, при этом столбец «Продукт» отображается всегда.

...

• StorageType = "LDAP" или "REST"
• установка - "Для всех"

...

• C:/Program Files/Robin Platform/2.0.0/RobotPlayer
• C:/Program Files/Robin Platform/2.0.0/Studio

...

От 2.21.2 и выше

...

• StorageType = "LDAP"  
• установка - любой вариант

...

Новые версии Студии и Robin Robot не совместимы со старыми версиями серверной части (новую версию не web Оркестратор не выпускали)

...

• StorageType = "REST"
• установка - любой вариант

...

Сервис лицензирования (Модуль "Управление лицензиями")

СЛ имеет возможность считывать файл лицензии только с расширением .licx. Если в папке есть файлы с другими расширением, СЛ их игнорирует.

Если в папке несколько файлов с расширением .licx, то СЛ проверяет только самый новый файл (по дате его изменения).

СЛ начинает искать файл лицензии и считывать из него данные при каждом перезапуске.

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

Для просмотра данных о лицензируемых продуктах и управления файлом лицензии в платформе реализован модуль "Управление лицензиями", через пользовательский интерфейс которого и осуществляется доступ к данным.

Дополнение файла лицензии

Если заказчик уже приобрел файл с лицензиями на некоторые продукты, но позже ему требуется дополнить файл или поменять какие-то параметры лицензий (приобрели еще один продукт, хотят изменить привязанную УЗ и т.п.), то замена ранее выданной лицензии будет происходить так:

1. Заказчик передает поставщику ранее выданный файл лицензии.
2. Поставщик обновляет файл через Генератор лицензий.
3. Поставщик передает заказчику обновленный файл.
4. Заказчик заменяет старый файл лицензии на новый (место хранения файла зависит от версии и варианта поставки приложений).
5. Заказчик перезапускает Студию, Плеер и Агента, чтобы они получили данные о новом файле. Если у заказчика серверная часть Enterprise (новая версия), перезагружать СЛ не требуется - он автоматически перепроверит новый файл.

Модуль "Управление лицензиями"

Модуль "Управление лицензиями» предназначен для отображения записей о лицензиях на продукты платформы Robin.

Image Removed

Модуль отображается на интерфейсе, если пользователю доступна роль "Администратор лицензирования". Если эта роль недоступна, то модуль "Управление лицензиями" не будет отображаться на экране.

При этом:

• Отображение и работа модуля "Управление лицензиями" не зависит от наличия какой-то конкретной лицензии. Даже при отсутствии файла лицензии, модуль все равно будет доступен для работы с ним
• На каждый продукт из файла лицензии в таблице имеется отдельная строка
• При скролле прокручиваются только строки таблицы, элементы над таблицей и шапка таблицы не перемещаются
• Таблица не отображается, если:
  • файл лицензии не найден, при этом вместо таблицы отображается текст: "Файл лицензии не найден"
  • файл лицензии испорчен, при этом вместо таблицы отображается текст: "Файл лицензии испорчен"
  • при попытке прочтения лицензии или передачи данных произошла ошибка, при этом вместо таблицы отображается текст: "Не удалось получить данные из файла лицензии. Неизвестная ошибка"
• При возникновении любой ошибки (со стороны бэка или фронта), которая не указана в спецификации отдельно (при переходе в раздел, открытии окон, нажатии кнопок), система выводит уведомление:

                "Неизвестная ошибка

                Обратитесь к администратору" 

Описание столбцов таблицы модуля "Управление лицензиями"

С помощью выпадающего списка «Столбцы» можно выбрать, какие столбцы будут скрыты или отображены, при этом столбец «Продукт» отображается всегда.

Сопоставление параметров файла лицензии и таблицы лицензий

...

Продукт

...

Название параметра в файле

...

Название столбца\параметра в таблице

...

Значение в файле

...

Значение в таблице

...

Любой продукт

...

Expiration

...

Столбец "Дата окончания"

...

Дата в формате "yyyy-MM-dd"

Пример:

2023-08-30

...

Шаблон:

dd <краткое название месяца>. yyyy

Пример:

30 авг. 2023

...

Unlimited

...

Бессрочная

...

Robin Studio

...

LowCode

...

Столбец "Дополнительные параметры",

Параметр "Low-code"

...

yes

...

В лицензии нет блока Robin Robot с этим параметром

...

Robin Robot

...

Столбец "Дополнительные параметры",

Параметр "Demo"

...

yes

...

В лицензии нет блока Robin Robot с этим параметром

...

В таблице не будет строки с Robin Robot и параметром "Demo".

Сочетание параметров:

• SerialNumber
• EnvironmentId
• Username 

...

Столбец "Дополнительные параметры",

Параметры:

• "Серийный номер машины"
• "Идентификатор среды"
• "Учётная запись"

...

3 параметра содержат данные об учетной записи, на которой будет разрешен запуск роботов:

• SerialNumber - серийный номер машины
• EnvironmentId - идентификатор среды
• Username - учетная запись

Пример записи в файле:

SerialNumber=Fgfdd321C228-009312
EnvironmentId=09q33442399edrftgderfKL
Username=LAPTOP-5К400dd\hp

...

Шаблон:

Серийный номер машины

<значение из лицензии>

Идентификатор среды

<значение из лицензии>

Учётная запись

<значение из лицензии>

Пример (см. соотв. пример для файла):

...

В лицензии нет блока Robin Robot с этими параметрами

...

В таблице не будет строки с Robin Robot и параметрами "Серийный номер машины", "Идентификатор среды" и "Учётная запись"

...

Concurrent

Столбец "Дополнительные параметры" \ Параметр "Конкурентные лицензии"

...

целое число >=1

Пример записи в файле:

Concurrent=3

Загрузка файла лицензии

Для загрузки файла лицензии, в модуле "Управление лицензиями":

1. Нажмите на кнопку "Загрузить лицензию".
2. В открывшемся окне Проводника выберите нужный файл лицензии. Можно загрузить только файл с расширением *.licx.
3. Подтвердите выбор в окне Проводника.
4. Новый файл лицензии охраняется на сервере системы. Предыдущий файл лицензии (если такой был загружен ранее) удаляется.
   При успешной проверка файла, в таблице отобразится информация из нового файла лицензии.

Дополнение файла лицензии

Бывают ситуации, когда вы уже получили файл с лицензиями на некоторые продукты Robin, но спустя какое-то время требуется дополнить файл (например, приобрели еще одну лицензию) или поменять какие-либо параметры лицензий (например, нужно изменить указанную в лицензии учётную запись машины). Для замены ранее выданного файла лицензии необходимо:

1. Передать ваш текущий файл лицензии тому, кто ранее вам его выдал.
2. Поставщик лицензии обновит файл и передаст его вам.
3. Загрузить новый файл на сервер системы. 
4. Перезапустите Студию, Плеер и Агента, чтобы они получили новые данные из файла лицензии

...

Шаблон:

Конкурентные лицензии

<число из лицензии>

Пример:

...

В лицензии нет блока Robin Robot с этим параметром

...

В таблице не будет строки с Robin Robot и параметром "Конкурентные лицензии".

При активации со стороны Администратора лицензирования выполняются следующие операции со стороны СЛ:

Проверка лицензии при перезагрузке СЛ

1. Администратор запускает или перезагружает СЛ.

       2. После успешного запуска, СЛ начинает процесс проверки файла лицензии. Ищет в папке файл с расширением .licx:

1. 1. если найден 1 файл с .licx, выполняется следующий шаг;
   2. если найдено несколько файлов с .licx, СЛ выбирает из них самый новый по дате изменения файла и выполняет следующий шаг;
   3. если не найден файл с .licx, выполняется шаг №5;
   4. если при поиске лицензии возникла неизвестная ошибка, выполняется шаг №5.

       3. СЛ проверяет, было ли изменено содержимое файла лицензии (проверяет подпись):

1. 1. Если нет, выполняется след. шаг;
   2. Если изменено, СЛ сохраняет информацию об этом. UC на этом завершается;
   3. Если при проверке лицензии возникла неизвестная ошибка, выполняется шаг №5.

      4. СЛ считывает данные о лицензиях.

      5. СЛ сохраняет результат проверки файла лицензии. Если у СЛ уже были сохранены какие-то данные, то заменяет их новыми.

Проверка лицензии при изменении содержимого папки

1. Администратор лицензирования изменяет содержимое папки с лицензиями:
   1. удаляет один из файлов;
   2. переносит файл из папки в другую директорию;
   3. добавляет новый файл в папку;
   4. изменяет один из файлов;
   5. заменяет один файл из папки другим файлом.

      2. СЛ начинает процесс проверки файла лицензии. Ищет в папке файл с расширением .licx:

1. 1. если найден 1 файл с .licx, выполняется следующий шаг;
   2. если найдено несколько файлов с .licx, СЛ выбирает из них самый новый по дате изменения файла и переходит к выполнению следующего шага;
   3. если не найден файл с .licx, выполняется шаг №5;
   4. если при поиске лицензии возникла неизвестная ошибка, выполняется шаг №5.

      3. СЛ проверяет, было ли изменено содержимое файла лицензии (проверяет подпись):

1. 1. Если нет, выполняется следующий шаг;
   2. Если изменено, выполняется шаг №5;
   3. Если при проверке лицензии возникла неизвестная ошибка, выполняется шаг №5.

     4. СЛ считывает данные о лицензиях.

     5. СЛ сохраняет результат проверки файла лицензии. Если у СЛ уже были сохранены какие-то данные, то заменяет их новыми.

Передача приложению данных о лицензии

Приложение отправило СЛ запрос на получение данных о лицензии одного из приложений. 

     1. СЛ определяет из запроса, о каком продукте требуется передать данные.

     2. СЛ ищет нужные данные среди той информации, которую он сохранил при последней проверке файла лицензии.

     3. СЛ отправляет ответ приложению. Возможные варианты ответа:

1. 1. файл лицензии не найден
   2. файл лицензии испорчен
   3. продукт не лицензирован (в файле не было блока с нужным продуктом)
   4. если есть данные о запрашиваемом продукте, СЛ отправляет параметры лицензии этого продукта

     4. У ROBIN Robot в файле может быть несколько лицензий с разными параметрами - СЛ сразу отправит данные обо всех лицензия ROBIN Robot.

Просмотр интерфейса СЛ

   1.Пользователь авторизуется в системе Вход в систему

   2. Если пользователю не доступна роль "Администратор лицензирования", то модуль "Управление лицензиями" не отображается. 

   3. Если Пользователю доступна роль "Администратор лицензирования" , то ему доступна работа с модулем " Управление лицензиями". 

   4. При этом Система отображает интерфейс модуля:

• если файл лицензии не был найден, на странице отображается только текст:
  "Файл лицензии не найден"
  
• если содержимое лицензии изменили (лицензия не прошла проверку подписи), на странице отображается только текст:
  "Файл лицензии испорчен"
  
• если возникла неизвестная ошибка, из-за которой сервис лицензирования не может вернуть данные о лицензии, на странице отображается только текст:
  "Не удалось получить данные из файла лицензии. Неизвестная ошибка"
• если нет каких-либо ошибок с файлом лицензии, на странице отображается таблица со списком лицензий

...

1. .