IActivation interface

The license state can be accessed and manipulated through the IActivationinterface. Let's take a better look into 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 and manipulate the activation features using the activation.Features property.

Available methods:

• ActivationFeature Get(string featureKey)

  Returns activation feature by the given key. If there is no such a feature, null is returned.

• Task Checkout(string key, long amount);

  Check out the feature from the licensing server.

  ! Only available in Active state.

• Task Return(string key, long amount);

  Return the previously checked-out feature to the licensing server.

  ! Only available in Active state.

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

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.

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.

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.

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.

Task<string> DeactivateOffline()

• Description: Deactivate the offline-activated seat.

• Allowed in States: Active, LeaseExpired

• Transitions To:

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

Task<bool> Deactivate()

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

• Allowed in States: Active, LeaseExpired (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.

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.

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.

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.

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

Task<ActivationEntitlementModel> GetActivationEntitlement()

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

• Allowed in States: Active, LeaseExpired, EntitlementNotActive

• Transitions To: None.