Product Configuration
Product Bundles

13min
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:
Step 1: Initialize a product bundle
Step 2: Issue licenses for the product bundle.
Step 3: Activate each product individually using the same license.
Initialize a Product Bundle
Product bundles can be created on the Products page in the platform clicking on the button Add new bundle.
Adding New Product Bundle
﻿
Enter the bundle name, code, authorization method select all the products which are going to be included in a 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:
Open the Order Creator, and optionally add Customer and order information. Press "Next"
Toggle "Create order for product bundle"
Create Order for 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"
Confirming Bundle Settings
﻿
Creating Order
﻿
The License Key can be found in the order, under the license tab:
New License Key
﻿
Activating Licenses for Bundled Products
The License created for the bundle can be used to activate the products within the bundle. The products needs 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.
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);
});
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 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 bundle_code param with every call to License API.
Bundle code
﻿
﻿
Updated 02 Apr 2024
Did this page help you?
Air-Gapped License Policy
License Entitlements