Release Notes
Last updated
Was this helpful?
Last updated
Was this helpful?
April 28, 2025
Enhanced Concurrency Management
Added native support for system-wide locking through the new ISharedActivation interface
Removed UseActivationOperationLock from activation options (custom lock implementations are no longer needed; use ISharedActivation for cross-process scenarios)
Simplified API Design
Moved all feature-related operations (CheckoutFeature, ReturnFeature, TrackFeatureUsage) from IActivation.Features to the IActivation interface for more intuitive usage
All feature operations now use the IActivationFeature interface as input for more reliable access
When a feature action succeeds, IActivationFeature represents the current state of the feature, including recent changes from other activations
Improved Documentation
Enhanced exception information throughout the API
Extended the list of possible error responses from the server through the ApiErrorCodes static class
Added comprehensive documentation for common error scenarios
Download:
November 21, 2024
Improvements
The IActivation.DeactivateOffline() method permitted in the EntitlementNotActiveState.
November 18, 2024
Improvements
The IActivation.Deactivate() method is now permitted in the EntitlementNotActiveState. Instead of raising an IllegalActivationOperationException, it clears the local state storage and transitions the activation instance to the NotActivated state.
November 8, 2024
Bug Fixes
November 6, 2024
Improvements
Performance - Activate and Feature Activate/Return operations now refresh the Activation state from response instead of an extra call to the Get Activation State endpoint.
Improvements
The activation.Info.Entitlement object has been extended with the following properties to eliminate the need to retrieve entitlement information through the Licensing API:
ConcurrencyMode
HasManintenance and MaintenanceExpiryDate
Improvements
Device Fingerprint
Offline Activation
Secure Storage
Removed dependency on the Microsoft.IdentityModel.Tokens NuGet package
Breaking Changes
FileActivationStorage has been renamed to PlainTextFileActivationStorage
Improvements
Added support for bool features usage tracking
Bug Fixes
Fixed bug with in-memory cached persistence state not properly cleared after the seat deactivation
Improvements
Entitlement status in the EntitlementInfo respects the entitlement dates and is automatically updated after the entitlement enters the grace period or expires
Bug Fixes
When the seat's lease period expires at the same time as the entitlement, the Activation transitions into the EntitlementNotActive state instead of the LeaseExpired state.
Improvements
[Breaking Change] Dropped support for the Consumption Token and Floating feature types
Improvements
Added support for a new Usage Count feature type
Improvements
Activation entitlement has been added to the offline activation tokens and can be retrieved using the GetActivationEntitlement() method
[Breaking Change] PersistentData contains new OfflineActivationEntitlement field. Make sure that it's being handled properly in yourIActivationStorage implementation.
Improvements
[Breaking Change] Changed offline activation token format
Added support for username/password license activation flow
Added maintenance fields to activation's entitlement
Improvements
Logging improvements
Activation state management
[Breaking Change] The OfflineActivated state has been removed because it has been merged with the Active state. The Info.Mode activation property can be used to distinguish between the Online and Offline activated seat.
[Breaking Change] The Expired state has been renamed to LeaseExpired state
[Breaking Change] The NotActive state has been renamed to NotActivated state
A new EntitlementNotActive state has been added, which represents an activated seat with no active entitlement (license) - e.g., the entitlement has expired or has been disabled on the server
Activation methods changes
[Breaking Change] The Refresh() method has been renamed to RefreshLease()
[Breaking Change] The RefhreshOffline() method has been renamed to RefreshLeaseOffline()
The Deactivate() method returns bool now, indicating if the deactivation has been successful or not
The number of API calls inside the RefreshLease() method has been reduced from 2 to 1
Documentation is now available for all public classes and methods of the SDK code
When the entitlement is no longer active on the server (because it has expired/has been disabled), the Refresh(), Deactivate() and PullRemoteState() methods are no longer transitioning the activation into the NotActive state but into the EntitlementNotActive state.
In this state, the PullRemoteState() method can be used to transition back to the previous state if the entitlement becomes active again. If that isn't the case, the Activate() method can be used in this state to activate the seat with another entitlement.
If there is an API exception raised because of the invalid nonce, the activation doesn't fall into the NotActivated state, but the API error is propagated out of the library.
Improvements
Added PullPersistedState()activation method, which allows retrieving the activation state from the storage, even if the activation has been initialized already. If there are some changes in the persistence (made by other processes accessing the same activation) when calling this method, they will be reflected in the activation's in-memory state.
The initial version of Zentitle.Licensing.Client SDK
Download:
Download:
The client (version 2.2.0) would previously throw an exception when calling IActivation.RefreshLease method in a specific scenario: ActivationStateModel.LeaseExpiry equals the Entitlement Expiry Date (because the previous RefreshLease already extended the lease to the maximum, which is Entitlement Expiry Date). This is a new behavior introduced with . After this fix, the method will NOT throw an exception but will return false to indicate that the Activation Lease Expiry can no longer be prolonged.
Download:
Using Licensing
Download:
Download:
Added support for integration, including the following features:
requires Zentitle2Core Library integration, and it accepts the TenantRsaKeyModulus string parameter instead of the JsonWebKey object
Download:
Download:
Download:
Download:
Added locking to the Activation class to prevent possible concurrency issues and make it thread-safe. Check section for more details
Download:
Download:
Download: