llkOfflineActivationRequest

Описание

Офлайн активация особенно полезна в случаях, когда ЭВМ с защищенным ПО временно или постоянно не имеет доступа к сети Интернет

Подходящие случаи для офлайн активации

Офлайн активация хорошо подходит для случаев, когда ПК пользователя

• Временно оффлайн, например, путешествие, проблемы с сетью Интернет и т.д.
• Постоянно оффлайн, например по требованиям безопасности, такие как госструктуры, банки и т.п.

Несколько простых шагов, описанных ниже, помогут осуществить офлайн активацию на ПК пользователя

• Требуется генерировать Request Code с помощью функции llkOfflineActivationRequest
• Далее, потребуется девайс соединенный к сети Интернет, чтобы завершить процедуру активации лицензии

После успешной генерации Request Codeа, есть две пути активировать лицензию

• Первый - это Панель управления, на странице Лицензий, с помощью кнопки Активировать Оффлайн
• Второй - с помощью утилит командной строки как в примере ниже:

Заметка

Request Code - машино-зависимый уникальный код (строка). Действителен в течение 72 часа. Если процесс офлайн активации занимает более 72 часов, просто сгенерируйте новый код

CURL

curl -X POST -k https://licentrix.tech/v3/activations/offline/bulkActivate -d "${REQUEST_CODE}"

Пример успешного CURL запроса

{
  "Response": {
    "description": "Activation succeed.",
    "developerMessage": "Activation succeed. To get more information, visit: https://doc.licentrix.tech/docs/enumerations/LLKStatus",
    "errorCode": 0
  },
  "activation": {
    "licenseKey": "AM0...mnQ="
  }
}

Требуется сохранить значение ключа licenseKey, например в файл license.l2c. Скопировать license.l2c файл на ПК пользователя, сконфигурировать PathToSaveTheLicenseData в конфигурации, и последующие вызовы llkActivateLicense приведут к успешной инициализации окружения

Пример неуспешного (неудачного) CURL запроса

{
  "Response": {
    "description": "The system time has been changed, expired the allowed period for offline activation.",
    "developerMessage": "The system time has been changed, expired the allowed period for offline activation. To get more information, visit: https://doc.licentrix.tech/docs/enumerations/LLKStatus",
    "errorCode": 13
  }
}

В этом примере мы видим, что срок действия Request Codeа истек.

Синтаксис

llkOfflineActivationRequest

LLK_API LLKStatus llkOfflineActivationRequest(const char* scopeJSON);

Параметры

Параметр	Описание
scopeJSON	Параметры генерации Request Codeа в формате JSON, подробнее ниже

Пример scopeJSON

scopeJSON

{
  "VendorID": "15cva7cyd4q0-a1f8t5d056b5",
  "SerialNumber": "989e79-140a9f1aw880-323b973g960d",
  "PathToSaveTheRequest": "RequestCode.txt",
}

Field	Description
VendorID (Vendor Code)	Находится в верхней части страницы Лицензий (буквенно-числовой код)
SerialNumber	Серийный номер, который отображается на странице Лицензии
PathToSaveTheRequest	Локальный путь для сохранения Request Codeа

Возвращаемые значения

Значение	Код	Описание
LLK_OK	0	Запрос выполнен успешно
LLK_INVALID_PARAMETER	1	Параметр scopeJSON нулевой указатель
LLK_NETWORK_ERROR	14	Отсутствует соединение с сетью Интернет
LLK_INVALID_SERIAL_NUMBER	15	Невалидный серийный номер. Поле SerialNumber не может быть пустой строкой
LLK_INVALID_VENDOR_CODE	18	Невалидный Код Вендора. Поле VendorID не может быть пустой строкой
LLK_INVALID_FORMAT	19	Невалидный JSON формат. Параметр scopeJSON не может быть пустой строкой и/или содержать невалидные поля
LLK_OFFLINE_ACTIVATION_FILE_PATH_IS_EMPTY	20	Невалидный путь. Поле PathToSaveTheRequest *не может быть пустой строкой
LLK_INTERNAL_TRY_AGAIN	701	Внутренняя ошибка, требуется повторить запрос. Если, ошибка стабильно воспроизводится, пожалуйста, обратитесь в техподдержку

Примеры

C++ пример

 const json& inputJSON =
  {
    { "VendorID", vendorID },
    { "SerialNumber" , serialNumber },
    { "PathToSaveTheRequest" , pathToSaveTheRequest }
  };

  const LLKStatus status = llkOfflineActivationRequest(inputJSON.dump().c_str());
  std::cout << "ErrorCode: " << llkStatusDescription(status) << std::endl;

Пример успешного вывода

ErrorCode: The operation status is successful.

В случае успеха Request Code будет сохранен в файле по указанному пути

ВАЖНО

Требуется сохранить значение ключа licenseKey, например в файл license.l2c. И скопировать license.l2c файл на ПК пользователя, сконфигурировать PathToSaveTheLicenseData в конфигурации, и последующие вызовы llkActivateLicense приведут к успешной инициализации окружения

---

История версий

• Добавлено в 1.1.0