Получение списка ключей, с которыми работает менеджер лицензий
Поле 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
Доступен поиск по номеру компонента, номеру продукта, номеру модификации продукта, имени компонента, имени продукта, идентификатору ключа (лицензии), открытому коду вендора (в числовом и текстовом виде), имени компьютера на котором установлен ключ.
Параметры запроса:
search – строка поиска.
dongle – фильтр по идентификатору ключа (лицензии).
product – фильтр по номер продукта.
feature – фильтр по номеру компонента.
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"
}
}
}
