Открепление лицензии от пула сетевых лицензий 

POST /v1.0/lm/detach

В режиме online открепляет лицензию с удалённого сервера и устанавливает локально. Для этого флаг offline должен быть равен false, а lmsId равен идентификатору локального менеджера лицензий.

На удалённый ПК нельзя открепить лицензию в режиме online.

В режиме offline открепляет лицензию с удалённого или локального сервера и возвращает буфер с лицензий. Для этого флаг offline должен быть равен true.

Входные параметры RAW JSON:

{
   "offline" : true,
   "lmsId": "14314416473658448602",
   "dongleId" : 1368487351,
   "durationInSec" : 3600,
   "concurrentResourceToConsume" : 1,
   "productFeatures": [
      {
        "productNumber": 16,
        "featureNumber": 2
      },
      {
        "productNumber": 4,
        "featureNumber": 1
      }
    ]
}

Возвращает пустой объект, если флаг offline НЕ установлен:

{
}

Возвращает лицензию в поле license, если флаг offline установлен:

{
    "license": "av5NMggAAAAIBwAAS   ***   AAAAPAAAAAAA"
}

Возврат открепленной лицензии 

POST /v1.0/lm/canceldetach

Возвращает лицензию в пул сетевых лицензий.

В режиме online возвращает лицензию с локального компьютера на удалённый сервер. Для этого флаг offline должен быть равен false.

В режиме offline удаляет лицензию с локального компьютера и возвращает буфер с лицензий. Для этого флаг offline должен быть равен true.

Входные параметры RAW JSON:

{
   "offline" : true,
   "dongleId" : 1368487351
}

Возвращает пустой объект, если флаг offline НЕ установлен:

{
}

Возвращает лицензию в поле license , если флаг offline установлен:

{
    "license": "av5NMggAAAAIBwAAS   ***   AAAAPAAAAAAA"
}

Установка лицензии 

POST /v1.0/lm/install

В режиме offline устанавливает буфер с лицензий на локальный компьютер.

Входные параметры RAW JSON:

{
    "license": "av5NMggAAAAIBwAAS   ***   AAAAPAAAAAAA"
}

Получение списка открепленных лицензий с продуктами и компонентами

GET/v1.0/lm/detached/products/features?search=text_or_value_for_search&dongle=3043211265&product=12&feature=2

Возвращает лицензии, которые были откреплены от локального ПК. 

Доступен поиск по номеру/имени компонента, номеру/имени продукта, идентификатору лицензии, открытому коду вендора (в числовом и текстовом виде), имени компьютера, для которого откреплялась лицензия.

Параметры запроса:

  • search – строка поиска;
  • dongle – фильтр по идентификатору лицензии;
  • product – фильтр по номер продукта;
  • feature – фильтр по номеру компонента.

Поля:

  • deathTime – время возврата открепленной лицензии в пул;
  • detachedFromLicenseId – идентификатор оригинальной лицензии;
  • licenseId – идентификатор откреплённой лицензии;
  • durationInSec – время работы откреплённой лицензии;
  • hostName – имя компьютера, на который будет установлена откреплённая лицензии.

Возвращает массив detachedLicenses:

{
    "detachedLicenses": [
        {
            "deathTime": 1653667658,
 		    "detachedFromLicenseId": "4006242369",
            "detachedFromLicenseIdShort": 4006242369,
            "detachedResource": 1,
            "durationInSec": 60,
            "hostName": "B2291-PC",
            "licenseId": 956653681540574192,
            "licenseIdShort": 1833675760,
            "products": [
                {
                    "dongleId": 0,
                    "features": [
                        {
                            "consumptionMode": 0,
                            "currentRunCounterValue": 0,
                            "detachedResource": 0,
                            "dongleId": 0,
                            "featureNumber": 4,
                            "flags": {
                                "cancelDetachRequired": false,
                                "expired": false,
                                "isDetachAllowed": false,
                                "isDetachable": false,
                                "rdpForbidden": true,
                                "vmForbidden": true,
                                "vtcForbidden": false
                            },
                            "floatingResource": 1,
                            "maxConcurrentResource": 1,
                            "maxRunCounter": 0,
                            "name": "test net",
                            "productModification": 0,
                            "productName": "test_detach_29",
                            "productNumber": 29,
                            "remoteMode": 3,
                            "reservedResource": 0,
                            "restOfLifeTimeDays": 0,
                            "sessionsCount": 0,
                            "validFromDate": 0,
                            "validUpToDate": 0,
                            "vendor": {
                                "publicCode": 1368487351,
                                "publicCodeText": "DEMONVK"
                            }
                        }
                    ],
                    "modification": 0,
                    "name": "test_detach_29",
                    "productNumber": 29,
                    "vendor": {
                        "publicCode": 1368487351,
                        "publicCodeText": "DEMONVK"
                    }
                }
            ],
            "productsCount": 1,
            "vendor": {
                "publicCode": 1368487351,
                "publicCodeText": "DEMONVK"
            }
        }
    ]
}

Повторное скачивание открепленной лицензии 

POST /v1.0/lm/detached/download

Позволяет повторно скачать открепленную лицензию. 

Входные параметры RAW JSON:

{
   "licenseId" : "956653681540574192"
}

Возвращает лицензию в поле license:

{
    "license": "av5NMggAAAAIBwAAS   ***   AAAAPAAAAAAA"
}

Получение списка отмены открепленных лицензий

GET/v1.0/lm/cancelled/licenses?search=text_or_value_for_search&dongle=3043211265

Возвращает лицензии, для которых была выполнена отмена открепления для локального ПК. 

Доступен поиск по идентификатору лицензии и имени компьютера.

Параметры запроса:

  • search – строка поиска;
  • dongle – фильтр по идентификатору лицензии.

Поля:

  • detachedFromLicenseId – идентификатор оригинальной лицензии;
  • licenseId – идентификатор откреплённой лицензии.

Возвращает массив cancelledLicenses:

{
	"cancelledLicenses": [
		{
			"detachedFromLicenseId": "3058492062",
			"detachedFromLicenseIdShort": 3058492062,
			"licenseId": "13176143868035619256",
			"licenseIdShort": 2880723384
    	}
	]
}

Повторное скачивание файла отмены

POST /v1.0/lm/cancelled/download

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

Входные параметры RAW JSON:

{
   "licenseId" : "13176143868035619256"
}

Возвращает файлы отмены в поле license:

{
    "license": "av5NMggAAAAIBwAAS   ***   AAAAPAAAAAAA"
}

Удаление записи для отменённой лицензии 

DELETE /v1.0/lm/cancelled/licenses

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

Входные параметры RAW JSON:

{
   "licenseId" : "13176143868035619256"
}

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

GET/v1.0/lm/fingerprints?search=b2291-pc

Возвращает массив отпечатков аппаратного обеспечения всех известных компьютеров. Отпечаток необходим для выполнения операции открепления лицензии.

Локальный компьютер можно определить по флагу remote.

Также для получения отпечатка аппаратного обеспечения локального компьютера можно воспользоваться запросом GET /v1.0/lm/environment.

Поля:

  • auto – отпечаток определился автоматически или добавлен через настройки (редактированию подлежат только отпечатки добавленные через настройки);
  • fingerprint – отпечаток аппаратного обеспечения компьютера в Base64;
  • hostName – имя компьютера в локальной сети;
  • lmsId – идентификатор менеджера лицензий, на который нужно перенести лицензию (нужен для передачи в команду Detach). Также является идентификатором отпечатка аппаратного обеспечения компьютера;
  • issueTime – время получения отпечатка аппаратного обеспечения;
  • remote – для всех удалённых менеджеров лицензий равно true, для локального компьютера равно false.

Доступен поиск по имени компьютера.

Выходные параметры RAW JSON:

{
    "fingerprints": [
        {
            "auto" : true,
            "fingerprint": "w9l/ZEgKAAAA  ***** AAAAAAAAAAAAAAAAAAAAAAAA==",
            "hostName": "B2291-PC",
            "issueTime": 1650641434,
            "lmsId": "102826192",
            "remote": false
        },
        {
            "auto" : false,
            "fingerprint": "rPIVmRwKAAAAAAAAAAAAAA *** AAAAAAAAAA=",
            "hostName": "GRDBENCH-01",
            "issueTime": 1650641433,
            "lmsId": "2957062961",
            "remote": true
        }
    ]
}

Добавить новый отпечаток оборудования для компьютера 

POST /v1.0/lm/fingerpints

Входные параметры RAW JSON:

{
   "fingerprint": "w9l/ZEgKAAAA  ***** AAAAAAAAAAAAAAAAAAAAAAAA==",
   "hostName": "B2291-PC",
   "issueTime": 1650641433,
   "lmsId": "2957062961"
}

Возвращает обновлённый массив fingerprints:

{
    "fingerprints": [
        {
            "auto" : true,
            "fingerprint": "w9l/ZEgKAAAA  ***** AAAAAAAAAAAAAAAAAAAAAAAA==",
            "hostName": "B1439-PC2",
            "issueTime": 1722869616,
            "lmsId": "4830281371515990935",
            "remote": true
        },
        {
            "auto" : false,
            "fingerprint": "ZEgKAAAAAAAA  ***** AAAAAAAAAAAAAAAAAAAAAAAA==",
            "hostName": "B2291-PC",
            "issueTime": 1722869615,
            "lmsId": "4465878234837117831",
            "remote": true
        },
        {
            "auto" : true,
            "fingerprint": "rPIVmRwKAAAAAAAAAAAAAA *** AAAAAAAAAA=",
            "hostName": "GRDBENCH-01",
            "issueTime": 1722869617,
            "lmsId": "5950663576205273185",
            "remote": true
        }
    ]
}

Редактировать ранее добавленный отпечаток оборудования 

PUT /v1.0/lm/fingerpints

Позволяет изменить имя компьютера для заданного отпечатка, но только в том случае, если отпечаток был добавлен через REST API. Имя компьютера не может быть пустым.

Входные параметры RAW JSON:

{
   "lmsId": "4465878234837117831",
   "hostName": "HOST-PC"
}

Возвращает обновлённый массив fingerprints:

{
    "fingerprints": [
        {
            "auto" : true,
            "fingerprint": "w9l/ZEgKAAAA  ***** AAAAAAAAAAAAAAAAAAAAAAAA==",
            "hostName": "B1439-PC2",
            "issueTime": 1722869616,
            "lmsId": "4830281371515990935",
            "remote": true
        },
        {
            "auto" : false,
            "fingerprint": "ZEgKAAAAAAAA  ***** AAAAAAAAAAAAAAAAAAAAAAAA==",
            "hostName": "HOST-PC",
            "issueTime": 1722869615,
            "lmsId": "4465878234837117831",
            "remote": true
        },
        {
            "auto" : true,
            "fingerprint": "rPIVmRwKAAAAAAAAAAAAAA *** AAAAAAAAAA=",
            "hostName": "GRDBENCH-01",
            "issueTime": 1722869617,
            "lmsId": "5950663576205273185",
            "remote": true
        }
    ]
}

Удалить ранее добавленный отпечаток оборудования

DELETE /v1.0/lm/fingerprints

Весь объект или только необходимые поля.

Входные параметры RAW JSON:

{
   "lmsId": "2957062961"
}

Возвращает обновлённый массив licenses:

{
    "fingerprints": [
        {
            "auto" : true,
            "fingerprint": "w9l/ZEgKAAAA  ***** AAAAAAAAAAAAAAAAAAAAAAAA==",
            "hostName": "B2291-PC",
            "issueTime": 1650641434,
            "lmsId": "102826192",
            "remote": false
        },
        {
            "auto" : false,
            "fingerprint": "rPIVmRwKAAAAAAAAAAAAAA *** AAAAAAAAAA=",
            "hostName": "GRDBENCH-01",
            "issueTime": 1650641433,
            "lmsId": "2957062961",
            "remote": true
        }
    ]
}
  • No labels
Если вам нужна помощь, обратитесь по адресу
hotline@guardant.ru