Получение списка ключей, с которыми работает менеджер лицензий
Поля:
driverType– режим работы (тип драйвера) аппаратных ключей:- 1 – HID;
- 2 – WinUSB;
- 3 – Guardant Driver.
Для ключей Guardant DL возвращается 0 (нет драйвера);
dongleModel– модель ключа:- 1 – Guardant DL;
- 2 – Guardant Sign;
- 3 – Guardant Time;
- 4 – Guardant Code;
- 5 – Guardant Code Time).
productsCount– количество продуктов в ключе;sessionsCount– количество активных сессий для ключа.
Флаги:
flags.bindHardware– есть привязка к аппаратным компонентам ПК;flags.bindOs– есть привязка к операционной системе;flags.driverless– драйвер не требуется или используется стандартный драйвер системы (HID или WinUSB);flags.expired– в ключе присутствуют компоненты, лицензионные условия которых истекли (низкий приоритет);flags.externalMicroSd– в ключе есть разъём для внешней MicroSd-карты;flags.lowBattery– низкий уровень заряда батареи (средний приоритет);flags.timerError– таймер ключа неисправен (высокий приоритет);flags.hardwareMismatchedOrFileCorrupted– аппаратные компоненты ПК изменились или файл лицензии повреждён (наивысший приоритет);flags.inaccessible– ключ был извлечён и не доступен менеджеру лицензий, но на этом ключе остались рабочие сессии (наивысший приоритет);flags.isDemoLicense– ключ с кодами доступа DEMONVK или программная лицензия активированная в демо-режиме;flags.cancelDetachRequired– требуется возврат лицензии перед новым откреплением;flags.isDetachable– в лицензии присутствуют открепляемые компоненты;flags.isDetached– лицензия является откреплённой от пула сетевых лицензий и работает на локальном ПК (все продукты и компоненты внутри такой лицензии откреплены от оригинальной лицензии);flags.isDetachAllowed– разрешено открепление целой лицензии (у всех открепляемых компонентов внутри лицензии достаточно сетевого ресурса);flags.isRehostAllowed– разрешён перенос лицензии между ПК;flags.isTrial– пробная лицензия;flags.isTrialLicenseExpired– пробная лицензия истекла;flags.isVtcEnabled– разрешён переход на виртуальный таймер в аппаратном ключе для всех компонентов в лицензии;flags.isVtcSupported– микропрограмма ключа поддерживает функционал виртуального таймера;flags.isVtcRunning– работает виртуальный таймер в ключе . Для ключей Time выставляется только после отключения аппаратного таймера;flags.remote– ключ расположен на другом ПК.
Для программных ключей (dongleModel == Guardant DL)
Поля:
containerActivationTime– время активации лицензии;containerVersionText– версия контейнера;containerDeathTime– время окончания работы пробного программного ключа;detachDeathTime– время окончания работы откреплённой лицензии.
Поля firmwareVersionText и manufacturedDate присутствуют, но не заполнены.
Для аппаратных ключей (dongleModel == Guardant Sign || dongleModel == Guardant Time)
Поля:
firmwareVersionText– версия микропрограммы аппаратного ключа;manufacturedDate– дата производства аппаратного ключа.
Поля containerActivationTime и containerVersionText присутствуют, но не заполнены.
GET /v1.0/lm/dongles
Возвращает массив dongles:
{
"dongles": [
{
"containerVersionText": "",
"dongleInfo": {
"containerActivationTime": 0,
"containerDeathTime": 0,
"containerVersion": 0,
"detachDeathTime": 0,
"detachedFromDongleId": 0,
"detachedFromHostName": "",
"dongleId": 1014133386,
"dongleMemorySize": 59392,
"dongleModel": 3,
"driverType": 2,
"firmwareFeatures": 1,
"firmwareState": 0,
"firmwareVersion": 16778248,
"hwMcuVersion": 8,
"netResource": 10,
"publicCode": 1368487351,
"typeFlags": 509
},
"firmwareVersionText": "1.0.4.8",
"flags": {
"bindHardware": false,
"bindOs": false,
"cancelDetachRequired": false,
"driverless": true,
"expired": false,
"externalMicroSd": false,
"inaccessible": false,
"isDemoLicense": true,
"isDetachable": false,
"isDetached": false,
"isRehostAllowed": false,
"isTrial": false,
"isTrialLicenseExpired": false,
"lowBattery": false,
"timerError": false,
"hardwareMismatchedOrFileCorrupted" : false,
"isVtcEnabled" : false,
"isVtcSupported" : true, "isVtcRunning" : false,
"remote": false
},
"lm": {
"currentTime": 1587659492,
"currentTimeText": "2020-04-23 19:31:32",
"hostIp": "127.0.0.1",
"hostName": "B2291-PC",
"hostPort": 3189,
"isVM": false,
"lmsId": "6430031962975896019",
"osArchitecture": "AMD64",
"osName": "Windows 10 Enterprise Edition (Build 19045)",
"previewBuild": false,
"processorCount": 16,
"protocols": "IPv4,IPv6 (TCP and UDP at port 3189) 172.16.255.1, 192.168.1.49, 10.128.0.14, 172.16.72.1",
"remote": false,
"startTime": 1587659490,
"uptimeEng": "00:00:02",
"uptimeRus": "00:00:02",
"version": "3.0.26.0",
"versionValue": 50338304
},
"manufacturedDate": "18 Mar 2020 14-20-20",
"productsCount": 1,
"sessionsCount": 1,
"vendor": {
"publicCode": 1368487351,
"publicCodeText": "DEMONVK"
}
},
{
"containerVersionText": "0.2.6.2",
"dongleInfo": {
"containerActivationTime": 1586536055,
"containerDeathTime": 0,
"containerVersion": 132610,
"detachDeathTime": 0,
"detachedFromDongleId": 0,
"detachedFromHostName": "",
"dongleId": 3043211265,
"dongleMemorySize": 0,
"dongleModel": 1,
"driverType": 0,
"firmwareFeatures": 1,
"firmwareState": 0,
"firmwareVersion": 0,
"hwMcuVersion": 0,
"netResource": 0,
"publicCode": 1368487351,
"typeFlags": 2514
},
"firmwareVersionText": "",
"flags": {
"bindHardware": true,
"bindOs": false,
"cancelDetachRequired": false,
"driverless": true,
"expired": false,
"externalMicroSd": false,
"inaccessible": false,
"isDemoLicense": true,
"isDetachable": false,
"isDetached": false,
"isRehostAllowed": false,
"isTrial": false,
"isTrialLicenseExpired": false,
"lowBattery": false,
"timerError": false,
"hardwareMismatchedOrFileCorrupted" : false,
"isVtcEnabled" : false,
"isVtcSupported" : true,
"remote": false
},
"lm": {
"currentTime": 1587659492,
"currentTimeText": "2020-04-23 19:31:32",
"hostIp": "127.0.0.1",
"hostName": "B2291-PC",
"hostPort": 3189,
"isVM": false,
"lmsId": "6430031962975896019",
"osArchitecture": "AMD64",
"osName": "Windows 10 Enterprise Edition (Build 19045)",
"previewBuild": false,
"processorCount": 16,
"protocols": "IPv4,IPv6 (TCP and UDP at port 3189) 172.16.255.1, 192.168.1.49, 10.128.0.14, 172.16.72.1",
"remote": false,
"startTime": 1587659490,
"uptimeEng": "00:00:02",
"uptimeRus": "00:00:02",
"version": "3.0.26.0",
"versionValue": 50338304
},
"manufacturedDate": "",
"productsCount": 1,
"sessionsCount": 0,
"vendor": {
"publicCode": 1368487351,
"publicCodeText": "DEMONVK"
}
}
]
}
Получение ключа по идентификатору
GET /v1.0/lm/dongles/{id}
Возвращает элемент dongle:
{
"dongle": {
"containerVersionText": "",
"dongleInfo": {
"containerActivationTime": 0,
"containerDeathTime": 0,
"containerVersion": 0,
"detachDeathTime": 0,
"detachedFromDongleId": 0,
"detachedFromHostName": "",
"dongleId": 1014133386,
"dongleMemorySize": 59392,
"dongleModel": 3,
"driverType": 2,
"firmwareFeatures": 1,
"firmwareState": 0,
"firmwareVersion": 16778248,
"hwMcuVersion": 8,
"netResource": 10,
"publicCode": 1368487351,
"typeFlags": 509
},
"firmwareVersionText": "1.0.4.8",
"flags": {
"bindHardware": false,
"bindOs": false,
"cancelDetachRequired": false,
"driverless": true,
"expired": false,
"externalMicroSd": false,
"inaccessible": false,
"isDemoLicense": true,
"isDetachable": false,
"isDetached": false,
"isRehostAllowed": false,
"isTrial": false,
"isTrialLicenseExpired": false,
"lowBattery": false,
"timerError": false,
"hardwareMismatchedOrFileCorrupted" : false,
"isVtcEnabled" : false,
"isVtcSupported" : true,
"isVtcRunning" : false,
"remote": false
},
"lm": {
"currentTime": 1587659626,
"currentTimeText": "2020-04-23 19:33:46",
"hostIp": "127.0.0.1",
"hostName": "B0943-PC",
"hostPort": 3189,
"lmsId": "6430031962975896019",
"protocols": "IPv4,IPv6 (TCP and UDP at port 3189) 172.16.255.1, 192.168.1.49, 10.128.0.14, 172.16.72.1",
"remote": false,
"startTime": 1587659490,
"uptimeEng": "00:02:16",
"uptimeRus": "00:02:16",
"version": "2.0.0.0"
},
"manufacturedDate": "18 Mar 2020 14-20-20",
"productsCount": 1,
"sessionsCount": 0,
"vendor": {
"publicCode": 1368487351,
"publicCodeText": "DEMONVK"
}
}
}
Получение списка ключей с продуктами и компонентами
GET /v1.0/lm/dongles/products/features?search=text_or_value_for_search&dongle=3043211265&product=12&feature=2&public=1368487351
Доступен поиск по:
- номеру/имени компонента;
- номеру/имени продукта;
- номеру модификации продукта;
- идентификатору (ID) ключа (лицензии);
- идентификатору (ID) менеджера лицензий;
- PUBLIC-коду вендора (в числовом и текстовом виде);
- имени/IP-адресу компьютера, на котором установлен ключ.
Алгоритм поиска:
Для номера компонента, номера продукта, номера модификации, числового значения PUBLIC-кода, ID менеджера лицензий и ID лицензии должно быть однозначное соответствие в HEX или DEC формате.
Для имени компонента, имени продукта, текстового представления PUBLIC-кода, имени и IP-адреса компьютера идёт поиск строки в подстроке. Это может привести к многозначному результату. Использование фильтров позволяет уточнить результаты поиска до получения единственного значения.
Параметры запроса:
- search – строка поиска;
- dongle – фильтр по идентификатору ключа (лицензии);
- product – фильтр по номер продукта;
- feature – фильтр по номеру компонента;
- public – фильтр по PUBLIC-коду;
- lms – фильтр по идентификатору менеджера лицензий;
- expired – возвращать только истёкшие компоненты;
- broken – возвращать только неисправные ключи;
- allowDetachOnly – возвращать только компоненты доступные для открепления;
- hideDetached – скрыть лицензии откреплённые с других ПК.
Возвращает массив dongles:
{
"dongles": [
{
"containerVersionText": "",
"dongleInfo": {
"containerActivationTime": 0,
"containerDeathTime": 0,
"containerVersion": 0,
"detachDeathTime": 0,
"detachedFromDongleId": 0,
"detachedFromHostName": "",
"dongleId": 1014133386,
"dongleMemorySize": 59392,
"dongleModel": 3,
"driverType": 2,
"firmwareFeatures": 1,
"firmwareState": 0,
"firmwareVersion": 16778248,
"hwMcuVersion": 8,
"netResource": 10,
"publicCode": 1368487351,
"typeFlags": 509
},
"firmwareVersionText": "1.0.4.8",
"flags": {
"bindHardware": false,
"bindOs": false,
"cancelDetachRequired": false,
"driverless": true,
"expired": false,
"externalMicroSd": false,
"inaccessible": false,
"isDemoLicense": true,
"isDetachable": false,
"isDetached": false,
"isRehostAllowed": false,
"isTrial": false,
"isTrialLicenseExpired": false,
"lowBattery": false,
"timerError": false,
"hardwareMismatchedOrFileCorrupted" : false,
"isVtcEnabled" : false,
"isVtcSupported" : true,
"isVtcRunning" : false,
"remote": false
},
"lm": {
"currentTime": 1587659650,
"currentTimeText": "2020-04-23 19:34:10",
"hostIp": "127.0.0.1",
"hostName": "B0943-PC",
"hostPort": 3189,
"lmsId": "6430031962975896019",
"protocols": "IPv4,IPv6 (TCP and UDP at port 3189) 172.16.255.1, 192.168.1.49, 10.128.0.14, 172.16.72.1",
"remote": false,
"startTime": 1587659490,
"uptimeEng": "00:02:40",
"uptimeRus": "00:02:40",
"version": "2.0.0.0"
},
"manufacturedDate": "18 Mar 2020 14-20-20",
"products": [
{
"features": [
{
"consumptionMode": 0,
"currentRunCounterValue": 0,
"detachedResource": 0,
"featureNumber": 2,
"flags": {
"cancelDetachRequired": false,
"expired": false,
"isDetachable": false,
"isDetachAllowed": false,
"rdpForbidden": true,
"vmForbidden": false,
"vtcForbidden": false,
"remote": false
},
"floatingResource": 10,
"maxConcurrentResource": 10,
"maxRunCounter": 0,
"name": "Тест документации",
"productModification": 0,
"productName": "Тест GCC",
"productNumber": 16,
"remoteMode": 3,
"reservedResource": 0,
"restOfLifeTimeDays": 0,
"sessionsCount": 0,
"validFromDate": 0,
"validUpToDate": 0,
"vendor": {
"publicCode": 1368487351,
"publicCodeText": "DEMONVK"
}
},
{
"consumptionMode": 1,
"currentRunCounterValue": 0,
"detachedResource": 0,
"featureNumber": 4,
"flags": {
"cancelDetachRequired": false,
"expired": false,
"isDetachable": false,
"isDetachAllowed": false,
"rdpForbidden": true,
"vmForbidden": false,
"vtcForbidden": false,
"remote": false
},
"floatingResource": 9,
"maxConcurrentResource": 10,
"maxRunCounter": 0,
"name": "Компонент вне лицензии",
"productModification": 0,
"productName": "Тест GCC",
"productNumber": 16,
"remoteMode": 3,
"reservedResource": 1,
"restOfLifeTimeDays": 0,
"sessionsCount": 0,
"validFromDate": 0,
"validUpToDate": 0,
"vendor": {
"publicCode": 1368487351,
"publicCodeText": "DEMONVK"
}
}
],
"flags": {
"remote": false
},
"modification": 0,
"name": "Тест GCC",
"productNumber": 16,
"vendor": {
"publicCode": 1368487351,
"publicCodeText": "DEMONVK"
}
}
],
"productsCount": 1,
"sessionsCount": 1,
"vendor": {
"publicCode": 1368487351,
"publicCodeText": "DEMONVK"
}
},
{
"containerVersionText": "0.2.6.2",
"dongleInfo": {
"containerActivationTime": 1586536055,
"containerDeathTime": 0,
"containerVersion": 132610,
"detachDeathTime": 0,
"detachedFromDongleId": 0,
"detachedFromHostName": "",
"dongleId": 3043211265,
"dongleMemorySize": 0,
"dongleModel": 1,
"driverType": 0,
"firmwareFeatures": 1,
"firmwareState": 0,
"firmwareVersion": 0,
"hwMcuVersion": 0,
"netResource": 0,
"publicCode": 1368487351,
"typeFlags": 2514
},
"firmwareVersionText": "",
"flags": {
"bindHardware": true,
"bindOs": false,
"cancelDetachRequired": false,
"driverless": true,
"expired": false,
"externalMicroSd": false,
"inaccessible": false,
"isDemoLicense": true,
"isDetachable": false,
"isDetached": false,
"isRehostAllowed": false,
"isTrial": false,
"isTrialLicenseExpired": false,
"lowBattery": false,
"timerError": false,
"hardwareMismatchedOrFileCorrupted" : false,
"isVtcEnabled" : false,
"isVtcSupported" : true,
"remote": false
},
"lm": {
"currentTime": 1587659650,
"currentTimeText": "2020-04-23 19:34:10",
"hostIp": "127.0.0.1",
"hostName": "B0943-PC",
"hostPort": 3189,
"lmsId": "6430031962975896019",
"protocols": "IPv4,IPv6 (TCP and UDP at port 3189) 172.16.255.1, 192.168.1.49, 10.128.0.14, 172.16.72.1",
"remote": false,
"startTime": 1587659490,
"uptimeEng": "00:02:40",
"uptimeRus": "00:02:40",
"version": "2.0.0.0"
},
"manufacturedDate": "",
"products": [
{
"features": [
{
"consumptionMode": 0,
"currentRunCounterValue": 0,
"detachedResource": 0,
"featureNumber": 2,
"flags": {
"cancelDetachRequired": false,
"expired": false,
"isDetachable": false,
"isDetachAllowed": false,
"rdpForbidden": true,
"vmForbidden": false,
"vtcForbidden": false,
"remote": false
},
"floatingResource": 0,
"maxConcurrentResource": 0,
"maxRunCounter": 0,
"name": "Тест документации",
"productModification": 0,
"productName": "Test DL VMware Standard",
"productNumber": 13,
"remoteMode": 1,
"reservedResource": 0,
"restOfLifeTimeDays": 0,
"sessionsCount": 0,
"validFromDate": 0,
"validUpToDate": 0,
"vendor": {
"publicCode": 1368487351,
"publicCodeText": "DEMONVK"
}
}
],
"flags": {
"remote": false
},
"modification": 0,
"name": "Test DL VMware Standard",
"productNumber": 13,
"vendor": {
"publicCode": 1368487351,
"publicCodeText": "DEMONVK"
}
}
],
"productsCount": 1,
"sessionsCount": 0,
"vendor": {
"publicCode": 1368487351,
"publicCodeText": "DEMONVK"
}
}
]
}
Получение всех продуктов c компонентами в ключе
GET /v1.0/lm/dongles{id}/products/features
Возвращает элемент dongle:
{
"dongle": {
"containerVersionText": "",
"dongleInfo": {
"containerActivationTime": 0,
"containerDeathTime": 0,
"containerVersion": 0,
"detachDeathTime": 0,
"detachedFromDongleId": 0,
"detachedFromHostName": "",
"dongleId": 1014133386,
"dongleMemorySize": 59392,
"dongleModel": 3,
"driverType": 2,
"firmwareFeatures": 1,
"firmwareState": 0,
"firmwareVersion": 16778248,
"hwMcuVersion": 8,
"netResource": 10,
"publicCode": 1368487351,
"typeFlags": 509
},
"firmwareVersionText": "1.0.4.8",
"flags": {
"bindHardware": false,
"bindOs": false,
"cancelDetachRequired": false,
"driverless": true,
"expired": false,
"externalMicroSd": false,
"isDemoLicense": true,
"isDetachable": false,
"isDetached": false,
"isRehostAllowed": false,
"isTrial": false,
"isTrialLicenseExpired": false,
"inaccessible": false,
"lowBattery": false,
"timerError": false,
"hardwareMismatchedOrFileCorrupted" : false,
"isVtcEnabled" : false,
"isVtcSupported" : true,
"isVtcRunning" : false,
"remote": false
},
"lm": {
"currentTime": 1587659697,
"currentTimeText": "2020-04-23 19:34:57",
"hostIp": "127.0.0.1",
"hostName": "B0943-PC",
"hostPort": 3189,
"lmsId": "6430031962975896019",
"protocols": "IPv4,IPv6 (TCP and UDP at port 3189) 172.16.255.1, 192.168.1.49, 10.128.0.14, 172.16.72.1",
"remote": false,
"startTime": 1587659490,
"uptimeEng": "00:03:27",
"uptimeRus": "00:03:27",
"version": "2.0.0.0"
},
"manufacturedDate": "18 Mar 2020 14-20-20",
"products": [
{
"features": [
{
"consumptionMode": 0,
"currentRunCounterValue": 0,
"detachedResource": 0,
"featureNumber": 2,
"flags": {
"cancelDetachRequired": false,
"expired": false,
"isDetachable": false,
"isDetachAllowed": false,
"rdpForbidden": true,
"vmForbidden": false,
"vtcForbidden": false,
"remote": false
},
"floatingResource": 10,
"maxConcurrentResource": 10,
"maxRunCounter": 0,
"name": "Тест документации",
"productModification": 0,
"productName": "Тест GCC",
"productNumber": 16,
"remoteMode": 3,
"reservedResource": 0,
"restOfLifeTimeDays": 0,
"sessionsCount": 0,
"validFromDate": 0,
"validUpToDate": 0,
"vendor": {
"publicCode": 1368487351,
"publicCodeText": "DEMONVK"
}
},
{
"consumptionMode": 1,
"currentRunCounterValue": 0,
"detachedResource": 0,
"featureNumber": 4,
"flags": {
"cancelDetachRequired": false,
"expired": false,
"isDetachable": false,
"isDetachAllowed": false,
"rdpForbidden": true,
"vmForbidden": false,
"vtcForbidden": false,
"remote": false
},
"floatingResource": 9,
"maxConcurrentResource": 10,
"maxRunCounter": 0,
"name": "Компонент вне лицензии",
"productModification": 0,
"productName": "Тест GCC",
"productNumber": 16,
"remoteMode": 3,
"reservedResource": 1,
"restOfLifeTimeDays": 0,
"sessionsCount": 0,
"validFromDate": 0,
"validUpToDate": 0,
"vendor": {
"publicCode": 1368487351,
"publicCodeText": "DEMONVK"
}
}
],
"flags": {
"remote": false
},
"modification": 0,
"name": "Тест GCC",
"productNumber": 16,
"vendor": {
"publicCode": 1368487351,
"publicCodeText": "DEMONVK"
}
}
],
"productsCount": 1,
"sessionsCount": 1,
"vendor": {
"publicCode": 1368487351,
"publicCodeText": "DEMONVK"
}
}
}
