IActivation interface

The license state can be accessed and manipulated through the IActivation interface. Let's look more closely at the most common licensing use cases and how they can be handled using our SDK.

Info

Information such as activation ID, entitlement ID, lease expiry, seat name, etc., can be retrieved via the activation.Info property.

Features

You can access the activation features using the activation.Features property.

The Features property provides access to all available features as a collection:

// get all access control features
var accessControlFeatures = activation.Features
    .Where(f => f.Type == FeatureType.Bool)
    .ToArray();

Or request a specific feature using TryGet API:

// Get a feature by key
if (activation.Features.TryGet("feature-key", out var feature))
{
    // Feature exists and is accessible through the 'feature' variable
    Console.WriteLine($"Feature {feature.DisplayName} is {(feature.Enabled ? "enabled" : "disabled")}");
    Console.WriteLine($"Available amount: {feature.Available}");
}
else
{
    // Feature doesn't exist
    Console.WriteLine("Feature not found");
}

State

The seat's activation state can be accessed through the activation.State property.

Possible activation states:

• Uninitialized: The local activation state has not been initialized from the local persistence yet.

• Active: The seat and its entitlement (license) are active.

• LeaseExpired: Seat activation's lease period expired.

• NotActivated: The seat has not been activated yet, or it has been deactivated, or the activation seat has been deleted on the server.

• EntitlementNotActive: The seat has been activated, but the entitlement (license) is not active (disabled, expired, etc.)

Usage

ActivationState is used in the IActivation interface to represent the current state of the activation. It helps in understanding the context and making decisions based on the activation's state during various activation-related operations.

For example, when calling the Initialize method in the IActivation interface, the activation state should be Uninitialized. After successful initialization, the state may transition to Active, LeaseExpired, NotActivated, or EntitlementNotActive based on specific conditions.

Understanding the activation state is crucial for implementing robust licensing logic within your application. Refer to the methods' documentation below for more details on using activation states in the licensing client.

Methods

Initialize

Task Initialize()

• Description: Initializes the activation from the locally persisted state.

• Allowed in States: Uninitialized

• Transitions To:

  • Active - When the seat has been successfully activated, and its lease has not expired.

  • LeaseExpired - When the seat has been activated, but its lease has expired.

  • NotActivated - When there is no activated seat.

  • EntitlementNotActive - When there is an activated seat, but the entitlement has expired or has been disabled.

Activate

Task Activate(ActivationCredentialsModel activationCredentials, string seatName = null)

• Description: Activates the seat in online mode.

• Allowed in States: NotActivated, EntitlementNotActive

• Transitions To:

  • Active - When the seat has been successfully activated on the server.

GenerateOfflineActivationRequestToken

Task<string> GenerateOfflineActivationRequestToken(string activationCode, string seatName = null, string stateMetadata = null)

• Description: Generates a request token for offline activation.

• Allowed in States: NotActivated, LeaseExpired, EntitlementNotActive

• Transitions To: None.

ActivateOffline

Task<string> ActivateOffline(string offlineActivationResponseToken)

• Description: Activates the seat offline with the token received from the EUP.

• Allowed in States: NotActivated, LeaseExpired, EntitlementNotActive

• Transitions To:

  • Active - When the offline activation response token was successfully applied.

DeactivateOffline

Task<string> DeactivateOffline()

• Description: Deactivate the offline-activated seat.

• Allowed in States: Active, LeaseExpired, EntitlementNotActive (when Info.Mode: ActivationMode.Offline)

• Transitions To:

  • NotActivated - When the deactivation token has been successfully generated, and the activation state has been deleted from local storage.

Deactivate

Task<bool> Deactivate()

• Description: Deletes the online-activated seat from the Licensing Server.

• Allowed in States: Active, LeaseExpired , EntitlementNotActive (when Info.Mode: ActivationMode.Online)

• Transitions To:

  • NotActivated - When the seat deactivation has been successful and the activation has been removed from the licensing server.

  • EntitlementNotActive - When the entitlement has expired or has been disabled.

RefreshLease

Task<bool> RefreshLease()

• Description: Refreshes the online activation's lease time. Should be called periodically before the activation's lease period expires, otherwise the activation transitions into the LeaseExpired state.

• Allowed in States: Active, LeaseExpired (When Info.Mode: ActivationMode.Online)

• Transitions To:

  • None - When called in Active state and the lease period is successfully refreshed.

  • Active - When called in LeaseExpired state and the lease period is successfully refreshed.

  • NotActivated - When the seat activation has been deleted on the server.

  • EntitlementNotActive - When the seat activation exists on the server, but the entitlement has expired or has been disabled.

RefreshLeaseOffline

Task RefreshLeaseOffline(string offlineRefreshToken)

• Description: Refreshes the offline activation's lease period.

• Allowed in States: Active, LeaseExpired (When Info.Mode: ActivationMode.Offline)

• Transitions To:

  • None - When called in Active state and the lease period is successfully refreshed.

  • Active - When called in LeaseExpired state and the lease period is successfully refreshed.

PullRemoteState

Task PullRemoteState()

• Description: Pulls the current activation's state from the remote Licensing server and updates the local activation's state accordingly.

• Allowed in States: Active, LeaseExpired, EntitlementNotActive (when Info.Mode: ActivationMode.Online)

• Transitions To:

  • None - When the activation state on the server matches the local activation state.

  • Active - When both the seat and the entitlement are active on the Licensing server.

  • LeaseExpired - When the seat has been activated, but its lease already expired.

  • NotActivated - When the seat activation has been deleted on the server.

  • EntitlementNotActive - When the seat activation exists on the server, but the entitlement has expired or has been disabled.

PullPersistedState

Task PullPersistedState()

• Description: Pulls the current activation's state from persistent storage and updates the activation's in-memory state if necessary.

• Allowed in States: NotActivated, Active, LeaseExpired, EntitlementNotActive

• Transitions To:

  • None - When the activation state in persistent storage matches the in-memory activation state.

  • Active

  • LeaseExpired

  • NotActivated

  • EntitlementNotActive

GetActivationEntitlement

Task<ActivationEntitlementModel> GetActivationEntitlement()

• Description: Returns details about the entitlement associated with the current activation.

• Allowed in States: Active, LeaseExpired, EntitlementNotActive

• Transitions To: None.

Features operations

Checkout a Feature

Checkout feature to track consumption of a consumable or element pool resource:

// First, get the feature reference
if (activation.Features.TryGet("feature-key", out var feature))
{
    // Check if we have enough available
    if (feature.Available >= 5)
    {
        // Checkout 5 units of the feature
        await activation.CheckoutFeature(feature, 5);
        
        // After checkout, the feature object is updated with the new available amount
        Console.WriteLine($"Remaining amount: {feature.Available}");
    }
}

Note: The CheckoutFeature method is only available when the activation is in the Active state.

Return a Feature

Return previously checked-out units of a element pool feature:

// First, get the feature reference
if (activation.Features.TryGet("feature-key", out var feature))
{
    // Return 3 units of the feature
    await activation.ReturnFeature(feature, 3);
    
    // After return, the feature object is updated with the new available amount
    Console.WriteLine($"Available amount after return: {feature.Available}");
}

Note: The ReturnFeature method is only available when the activation is in the Active state.

Track Feature Usage

For boolean features (enabled/disabled), you can track usage:

// First, get the feature reference
if (activation.Features.TryGet("feature", out var feature) && feature.Enabled)
{
    // Track that this feature was used
    await activation.TrackFeatureUsage(feature);
    
    // Application code that uses the feature
    Console.WriteLine("Feature used successfully");
}

Note: The TrackFeatureUsage method is only available when the activation is in the Active state, and only works with boolean features that are enabled on entitlement level.