Product Configuration
License Policies
16min
what is a license policy? a license policy is a templating feature within licensespring to easily issue a new license according to a preset of entitlements there are a few benefits to using license policies less error prone if you defined dozens of features and custom fields, and primarily sell your product in a few combinations of these, then license policies help you avoid configuration mistakes easier to integrate with other systems let's say you would like to sell licenses of your app through stripe, the license is time limited, and has 3 of a product's 7 features, with a max activations of 5 instead of setting up your order webhook with each of these entitlements defined on your stripe integration, you can just define a license policy and select it in stripe every product has at least 1 license policy, and there must be at least 1 default license policy a license policy is only a template once a license is issued, you can modify certain parts of the entitlements (eg extend the validity period, change the max activations etc ) how to create a license policy? navigate to the license detail page and click on "license policies" and then "add license policy" adding license policy on the license policy editor, the required fields are that you give the license policy a name and a code all other parameters are optional setting values for license policy what fields can be set for a license policy? policy values name required code required, immutable license type required, can be perpetual, time limited, subscription, or consumption is trial optional, boolean determining whether the license issued is a trial license max activations must be a positive int allow unlimited activations boolean has device transfer limit whether you wish to control the number of times a license can be moved from one device to another prevent virtual machine boolean value sent to eht sdks to detect and block apps running in virtual environments offline floating license boolean, setting entitlements for a floating server that is deployed is floating cloud boolean setting concurrency over http enable maintenance period set a maintenance window which starts counting after the initial activation of the license product features you can add or remove product features to the license policy for consumption features, you can set different values for max consumptions , max overages and for periodic resets custom fields you can select the values of the product custom fields you wish to override in the dropdown the policy name and the policy code are required fields you cannot change the policy code once the license policy is defined how to use license policies? using license policies to issue licenses manually through the vendor platform through the vendor platform navigate to licenses > issue licenses add order and customer information and hit next click "add product" and you will see the product selector screen from here, you can choose which license policy to use when issuing a license for that given product selecting license policy if you wish to use the license policy as a starting point when configuring the license you are issuing, then enable use custom license values the editor will start with all of the options configured in the license policy using custom license values using license policies to issue licenses through stripe integration license policy code can be added as a custom attribute to the stripe product price so that any subscription created using this price will create licenses using that specific license policy more details can be found stripe integration docid\ jhfnp0vpixrfxbr3oqtjx link license policy to the license licensespring supports tracking and exposing the license policy code associated with a license this enhancement provides better traceability and improves visibility into which policy was used when a license was created when a license is created using a specific license policy, the policy identifier is stored and made available via both api responses and the user interface license creation if a license is created by specifying a license policy the system will persist the license template id ( policyid ) at the license level ensure this value remains associated with the license throughout its lifecycle this can be achiveded when creating a license using management api and sending a specific license template id parameter as a license entitlement field alternatively, if is also assigned to a license by default when created using platform if custom values toggle is not used, the selected default policy will be assigned to a licenses link license policy to a license using platform in the vendor platform, the license details view will include a display of the linked license policy this ensures transparency regarding how license terms were determined, supports auditability by maintaining a clear link between licenses and their policy definitions and enhances usability for vendor teams managing complex policy configurations license policy as a sku to improve product structuring, searchability, and traceability, licensespring introduces a mechanism to treat license policies as skus a new boolean configuration enables policies to behave like immutable identifiers tied to specific licensing terms this enhancement supports workflows where license policies represent pre defined commercial skus and must remain consistent once assigned to licenses sku behavior toggle a boolean field exists in the license policy configuration field is sku purpose when enabled, this marks the policy as a sku like policy effect licenses issued with such policies behave as if associated with a commercial sku when a license is created directly using a policy marked as is sku = true as defined section above the policy’s identifier and sku flag are stored at the license level this association ensures consistent behavior and enables future queries or logic based on sku grouping to ensure sku consistency policies marked as sku become immutable after they are created attempts to change policy settings post issuance will be rejected or restricted to prevent sku drift license search functionality includes option search by license policy code and results include all licenses issued using specific policies, and in this case also enabling behavior similar to product sku filtering in e commerce or inventory systems using sku license policies enables product based license tracking and reporting it also prevents accidental modifications to sku critical policies, streamlines license discovery through sku style search filters and ensures operational consistency in sku driven sales and deployment processes