ACTIVATE A LICENSE - CONSIDERATIONS

You can activate a license with the following API method:

POST /isv/{isv_id}/provisioning/activations

{
  "product_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "license_key": "string",
  "client_id": "string",
  "client_name": "string",
  "client_description": "string",
  "software_version": "string",
  "timestamp_utc": "2023-07-04T08:24:11.079Z",
  "tags": [
    "string"
  ]
}

Explanation of the parameters:

product_id:* ID of the product

license_key*: license key or token key (see TOKEN KEYS)

client_id*: unique client ID (siehe https://support.slascone.com/hc/en-us/articles/360016157958-GENERATING-A-UNIQUE-CLIENT-ID)

client_name: name of the client

client_description: description

software_version: Supported Formats: 12.0 or 12.0.1 or 12.0.1.3 i.e., numerical fields separated by (at least one) '.'. (siehe: https://support.slascone.com/hc/en-us/articles/360016055257-CREATING-A-PRODUCT)

timestamp_utc: Timestamp in UTC format

"tags": Token tags, the tags must exist (these are created in the administration, tab "Custom Types".

* Mandatory fields

Difference between license key and token key:

• The license key can be used multiple times (n times) for activation.
• A token key is a one-time use key that can only be used for a single activation. It is employed in scenarios where strict control over the number of activations is is required.

It is also possible to activate a license directly in the Vendor Portal. This might be helpful when testing and/or when activations need to be manually done by the vendor.

Named Device Licenses

SLASCONE provides 2 types of license keys:

• License key: when you create 1 license with n tokens, SLASCONE generates 1 license key and n token keys. The license key can be used n times for activation.
• Token key: a token key can be used only once for activation.

The activation might fail for several reasons:

• The license is not active (inactive or expired).
• The license key is already activated on a different client (to prevent license piracy).
• The license has not any available tokens left (all tokens are already assigned).

CLIENT REACTIVATION WITH A NEW LICENSE

In case you activate an already activated client with a new license, the old license becomes automatically available again.

Named User Licenses

It is recommended to use a combination of unique hardware id and operating system user as your client_id, e.g., DEV6394_yourdomain\matthew. This adds an extra layer of protection, allowing you to distinguish between different users in a (terminal) server environment.

Floating Devices Licenses

Similar to the named provisioning mode, the first step for a floating client is to get activated. Activation takes place once. After initial activation, SLASCONE’s session management takes place.

The activation typically takes place when the user enters the license key, as described here.

Contrary to the named provisioning mode, a floating license code can be used to activate as many devices as possible. In other words, the number of floating tokens has no activation implications.