Product Bundles

A product bundle is a specific type of product which groups several products together so that they can be activated and used with a single license.

General Process: Working With Product Bundles:

Generally, creating product bundles uses the following workflow:

1

Initialize a product bundle

Initialize a product bundle.

2

Issue licenses for the product bundle

Issue licenses for the product bundle.

3

Activate each product individually using the same license

Activate each product in the bundle separately using the same license.

Initialize a Product Bundle

Product bundles can be created on the Products page in the platform by clicking the button Add new bundle.

Enter the bundle name, code, authorization method, and select all the products which are going to be included in the bundle.

Setting Bundle Values

The bundle code must be unique from other bundle and other product codes.

You can only bundle products using the same authorization method.

The Bundle code, authorization method and selected products cannot be edited after the bundle is created. You can edit their name, and delete or disable / re-enable them at a later date.

Issuing Bundle Licenses in the Vendor Platform:

An order for bundles can only contain product licenses or bundle licenses, but not both.

Start as you normally would with any other license:

1

Open the Order Creator

Open the Order Creator, and optionally add Customer and order information. Press "Next".

2

Toggle bundle order and configure

Toggle "Create order for product bundle".

In the product bundle selector:

• Select the bundle you wish to issue licenses for.

• Specify the license policy to be associated for each product individually.

• Click "Confirm", "Next" and "Create order".

The License Key can be found in the order:

Activating Licenses for Bundled Products

The License created for the bundle can be used to activate the products within the bundle. The products need to be activated separately. For example, you cannot use the bundle code to activate the license for all of the products in that bundle.

Assigning Users to User-Based Product Bundles

Users are assigned to the user-based bundle license and can then log in to the individual products using the same credentials separately.

There is no way to assign users to individual products of a bundle. In other words, a user will be assigned to all products within the bundle. The Max users will therefore be the smallest value of the Max users of all the individual license policies used.

Activating Licenses of Bundles through the LicenseAPI

The API interfaces remain consistent, as we continue to operate with standard licenses for processes such as activation and verification.

For instance, consider a license bundle named "Bundle PRO" with the code "bunpro," which is associated with a key-based license having the serial number 1111-2222-3333-4444. This bundle encompasses two products: "Product One" (code: prodone) and "Product Two" (code: prodtwo).

To initiate the license activation for "Product One" within the bundle, the procedure involves employing the bundle license key, the code for "Product One," and the hardware ID of the relevant device. It's important to note that the bundle license functions as a mere placeholder, serving to manage the license key and LicenseUsers information.

activate_bundle.js

const axios = require('axios');
const data = JSON.stringify({
  "product": "prodone",
  "license_key": "1111-2222-3333-4444",
  "hardware_id": "test-hardware-id-1",
});

const config = {
  method: 'post',
  url: 'https://api.licensespring.com/api/v4/activate_license/',
  headers: { 
    '\'Content-Type\'': '\'application/json\'', 
    'Date': 'Thu, 28 Jan 2021 09:07:27 GMT', 
    'Authorization': 'algorithm="hmac-sha256",headers="date",signature="9Km8AoACsFfRf9+JW4gcnHMmvWoPaZIwlaZ3HeZxdgQ=",apikey="5225d654-f6e5-41f0-af90-4237a597134b"', 
    'Content-Type': 'application/json'
  },
  data : data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

Working with Product Bundles with the Management API

There are two primary, product bundle-specific API calls:

• List Products in a Bundle shows all products in a bundle the requesting manager has access permissions to.

• List Bundles for a Product shows all bundles for a product the requesting manager has access permissions to.

bundle_code

When using user based bundle licensing, it can happen that the same license user has multiple licenses for the same product - one license being standalone, and another as a part of the bundle. To make sure that License API recognizes which license needs to be used, you need to send the bundle_code param with every call to License API.

Bundle code